把智能体当成
本地的实体来做
本地优先的 Android AI 智能体客户端。每个 Agent 有自己的头像、人格、Provider、 工具权限、私有工作区与记忆库。数据留在设备上。
不是「一个输入框加一段回复」
大多数 Android AI 客户端是打开网页套壳。OrionekoX 把智能体做成一等的本地实体: 能配、能记、能动手、能组队。
本地智能体
合成联系人与会话,不经过任何服务器。支持头像、简介、Provider/模型、系统提示词、工具、技能与记忆。
Provider 自由
OpenAI-compatible、Gemini/Claude 兼容端点、局域网 Ollama / LM Studio / vLLM。多预设、模型拉取与连通性测试。
本地群组
仅含本地智能体的群。成员增删、群资料页、群内互相回复,全部本地完成。
MCP
Streamable HTTP MCP 商城、工具桥接、逐工具权限。支持 mcpServers JSON 导入。
真终端
多 TTY 标签、配色与字号、前台服务与停止入口。OxLinux / PRoot 容器里能跑真实 Ubuntu 命令。
记忆
外置本地记忆、遗忘曲线、阈值压缩、快速召回。Markdown 本体加索引与版本。
工作流
间隔或每日定时运行 Agent,前台服务执行,结果通知,留运行记录。
UI 自动化
无障碍桥接的 ui_dump / ui_tap / ui_swipe / ui_screenshot / ui_key / ui_ocr。
自绘界面
OxUI 的 33 个页面全部用 Java 直接画,res/layout 里只有一个通知布局。18 套皮肤。
界面
深色为默认。皮肤系统有 18 套,可逐项微调,也能导入 Kelivo / RikkaHub 的主题 JSON。
会走网络的只有这几处
全部由你显式配置或触发。没有遥测、没有账号体系、没有后台心跳。
| 出口 | 什么时候 |
|---|---|
| 模型请求 | 发往你自己填的 base_url |
| 远端 MCP | 发往你自己添加的服务器 URL |
| Harness 桥接 | 发往你自己配置的桥接端点 |
http_get / open_url | Agent 调用这两个工具时 |
| 容器 rootfs | 首次下载,来自 cdimage.ubuntu.com |
构建
需要 JDK 17、Android SDK 36、NDK 27 与 CMake 3.22。不需要 git submodule。
export JAVA_HOME=/path/to/jdk17
export ANDROID_HOME=/path/to/android-sdk
./gradlew :TMessagesProj_AppStandalone:assembleAfatStandalone
afat 出 arm64-v8a + x86_64 双 ABI(模拟器与真机都能装);
afatArm64 只出 arm64-v8a,体积小约 0.5 MB。
签名使用 TMessagesProj/config/orioneko.keystore,不随仓库分发。
许可与来源
GPL-3.0-or-later。
本项目的早期版本以 DrKLO/Telegram
(GPL-2.0-or-later)为基座改造而来。那个方向已在 0.97.0 走完并结束:
Telegram 的界面层、业务层、网络层、媒体栈、原生库与全部子模块都已从仓库删除,
org.telegram 下现在只剩 ox 一个包。
现在的 OrionekoX 不联网到 Telegram,也没有 Telegram 客户端能力。
代码由 AI 编码代理完成。 本项目是独立开源作品,与 Telegram 官方无隶属关系。 第三方组件:PRoot(GPL-2.0-or-later)、talloc(LGPL-3.0-or-later)、 libandroid-shmem(BSD-3-Clause)、libvterm(MIT)、AndroidX(Apache-2.0)、 Google Play Services Vision(设备端 OCR)。