> 当前仓库处于文档规划阶段，目标是先把 Android Root Node 的架构、协议对接、UI、国际化和命令契约定清楚，再进入 Kotlin + Compose 的正式开发。
## 项目简介
这个项目的目标是把一台 `已 Root 的 Android 备用机` 做成一个真正可控的 OpenClaw 节点。
它不走：
- Ubuntu RootFS
- Termux 容器方案
- PRoot 假 root
- 在手机里运行完整 Gateway
它要做的是：
- 保留 OpenClaw 网关，继续复用聊天入口、Agent、会话和工具路由能力
- Android 端只承担 `node` 角色
- 真正的 root 权限只放在 Android Node 侧
- Shell 执行兼容 OpenClaw 的 `exec host=node` 路径
- 手机自动化优先提供结构化命令，而不是让 AI 全靠 shell 文本硬拼
## 架构概览
```text
[飞书 / 其他聊天平台]
|
v
[OpenClaw 网关]
|
v
[Android Root Node APK]
|
v
[Magisk / su / libsu]
|
v
[已 Root 的 Android]
```
## 适用场景
- 希望通过 OpenClaw 的聊天入口或 Agent 能力来控制一台 Root 备用机
- 希望让手机具备 `system.run`、截图、UI dump、输入、启动应用等远程能力
- 不希望再套一层 Ubuntu / Termux，而是直接控制 Android 宿主系统
## 核心原则
- 原生优先：避免 Flutter + Termux + PRoot 这类叠层方案
- 协议兼容：尽量兼容 OpenClaw 当前 node / gateway / exec 协议
- Root 集中：所有 root 行为统一收口到 `RootBroker`
- 能力分层：通用 shell 走 `system.run`，手机操作走 `androidRoot.*`
- 中文优先：V1 只支持 `zh-CN` 和 `en`，默认与回退语言均为简体中文
- 文档先行：先把接口、模块和边界讲清楚，再写代码
## 技术方向
- `Kotlin`
- `Jetpack Compose`
- `OkHttp WebSocket`
- `kotlinx.serialization`
- `Coroutines + Flow`
- `libsu`
- `DataStore / AndroidX Security / Room`
## 计划支持的能力
- `system.run.prepare`
- `system.run`
- `system.which`
- `system.execApprovals.get`
- `system.execApprovals.set`
- `androidRoot.screen.capture`
- `androidRoot.ui.dump`
- `androidRoot.input.tap`
- `androidRoot.input.swipe`
- `androidRoot.input.text`
- `androidRoot.app.launch`
- `androidRoot.app.stop`
- `androidRoot.logcat.tail`
## 文档导航
| 文档 | 说明 |
|---|---|
| [docs/architecture.md](docs/architecture.md) | Android Root Node 的系统架构、模块边界和运行模型 |
| [docs/gateway-integration.md](docs/gateway-integration.md) | 和 OpenClaw 网关的通信、配对、命令暴露和 exec 路径对接 |
| [docs/ui-spec.md](docs/ui-spec.md) | UI 风格、页面结构、视觉方向和线框说明 |
| [docs/command-contracts.md](docs/command-contracts.md) | V1 命令面、JSON 入参与返回结构 |
| [docs/i18n.md](docs/i18n.md) | 中文优先的双语国际化策略，当前仅支持简体中文和英文 |
| [docs/roadmap.md](docs/roadmap.md) | 分阶段实现路线、MVP 范围和验收标准 |
## 当前状态
当前仓库处于 `文档规划阶段`，已经完成：
- 整体架构说明
- OpenClaw 网关对接设计
- 命令契约设计
- UI 设计说明
- 中英双语国际化策略
- 分阶段路线图
接下来会进入：
1. Android 项目骨架初始化
2. `connect.challenge -> connect -> hello-ok` 握手链路打通
3. `system.which` / `system.run` 落地
4. `androidRoot.screen.capture` / `ui.dump` / `input.tap` / `app.launch` 落地
## 本地开发环境
当前建议的开发环境基线：
- `JDK 17`
- `Android Studio`
- `Android SDK Platform 36.1`
- `Android SDK Command-line Tools`
- `Android SDK Platform-Tools`
- `Build-Tools 36.1.0` 或更高版本
推荐 SDK 目录：
```text
D:\AndroidSDK
```
## 参考资料
以下资料已在 `2026-04-07` 对照核实：
- OpenClaw 文档首页: 
