📱 AndroidForClaw

让 AI 真正掌控你的 Android 手机。

底层架构对齐 OpenClaw（280k+ Star），在手机上实现完整的 AI Agent 能力——看屏幕、点 App、跑代码、连平台。

📖 详细文档 · 🚀 快速开始 · 💬 加入社区

---

🔥 AI 能帮你做什么

📱 操控任何 App

微信、支付宝、抖音、淘宝、高德……凡是你能手动操作的，AI 都能操作。

你：帮我打开微信发消息给张三说"明天见"
AI：→ 打开微信 → 搜索张三 → 输入消息 → 发送 ✅

🔗 跨应用联动

你：微信收到一个地址，帮我导航过去
AI：→ 微信复制地址 → 打开高德 → 搜索 → 开始导航

🐧 执行代码

通过 Termux SSH 执行命令（Shell 直接可用，Python/Node.js 需在 Termux 中安装）：

你：用 Python 帮我分析一下 Downloads 文件夹里的 CSV
AI：→ exec("python3 analyze.py") → 返回分析结果

🌐 搜索 & 抓取网页

你：搜一下今天的科技新闻
AI：→ web_search("科技新闻") → 返回标题+链接+摘要

💬 多平台消息

通过飞书、Discord、Telegram、Slack 等远程控制你的手机 AI：

渠道	状态
飞书	✅ 可用
Discord	✅ 可用
Telegram	🔧 框架就绪（配置对齐 OpenClaw）
Slack	🔧 框架就绪（Socket/HTTP 双模式）
Signal	🔧 框架就绪（signal-cli 接入）
WhatsApp	🔧 框架就绪

每个渠道支持独立模型覆盖——从已配置的 Provider 中选择该渠道专用的模型。

🤖 MCP Server（给外部 Agent 用）

内置 MCP Server（端口 8399），将手机的无障碍和截屏能力通过标准 MCP 协议暴露给外部 Agent：

工具：get_view_tree / screenshot / tap / swipe / input_text / press_home / press_back / get_current_app

这不是 AndroidForClaw 自身使用的——是给 Claude Desktop、Cursor 等外部 Agent 调用的。

🧩 技能扩展

从 ClawHub 搜索安装新能力，或自己创建 Skill：

你：看看 ClawHub 上有什么技能
AI：→ skills_search("") → 展示可用技能列表

---

⚡ 快速开始

下载安装

从 Release 页面 下载：

APK	说明	必装？
AndroidForClaw	主应用 (含无障碍服务、Agent、Gateway)	✅ 必装
BrowserForClaw	AI 浏览器 (网页自动化)	可选

Termux 需从 F-Droid 单独安装（不要用 Play Store 版本）。

3 步上手

1. 安装 — 下载安装 AndroidForClaw
2. 配置 — 打开 App，输入 API Key（或跳过使用内置 Key），开启无障碍 + 录屏权限
3. 开聊 — 直接对话，或通过飞书/Discord 发消息

💡 首次打开自动弹出引导页，默认 OpenRouter + MiMo V2 Pro，支持一键跳过

Termux 配置（可选）

装了 Termux，AI 就能跑 Shell 命令（Python/Node.js 需额外安装）。

设置 → Termux 配置，按向导 7 步完成：

1. 安装 Termux（F-Droid 版）
2. 生成 SSH 密钥（App 内一键生成）
3. 在 Termux 中运行 termux-setup-storage
4. pkg install -y openssh
5. 复制密钥配置命令并执行
6. sshd
7. App 自动验证连接

---

🏗️ 技术架构

324 源文件 · 62,000+ 行代码 · 10 个模块

┌──────────────────────────────────────────┐
│  Channels                                 │
│  飞书 · Discord · Telegram · Slack ·      │
│  Signal · WhatsApp · 设备内对话            │
├──────────────────────────────────────────┤
│  Agent Runtime                            │
│  AgentLoop · 19 Tools · 20 Skills ·       │
│  Context 管理 (4层防护) · Memory           │
├──────────────────────────────────────────┤
│  Providers                                │
│  OpenRouter · MiMo · Gemini · Anthropic · │
│  OpenAI · 自定义                           │
├──────────────────────────────────────────┤
│  Android Platform                         │
│  Accessibility · Termux SSH · device tool │
│  MediaProjection · BrowserForClaw         │
└──────────────────────────────────────────┘

核心特性

特性	说明
Playwright 模式	屏幕操作对齐 Playwright —— snapshot 获取 UI 树 + ref → act 操作元素
统一 exec	自动路由 Termux（SSH 连接池，3 次重试）或内置 Shell，对模型透明
Context 管理	4 层防护对齐 OpenClaw：limitHistoryTurns + 工具结果裁剪 + budget guard
Skill 体系	20 个内置 Skill 可在设备上自由编辑，支持 ClawHub 在线安装
多模型	MiMo V2 Pro · DeepSeek R1 · Claude Sonnet 4 · Gemini 2.5 · GPT-4.1
MCP Server	将无障碍/截屏能力暴露给外部 Agent（端口 8399，Streamable HTTP）
渠道模型覆盖	每个消息渠道可独立选择模型，字段对齐 OpenClaw types
Steer 注入	运行中通过 Channel 向 Agent Loop 注入消息（mid-run steering）

---

📋 完整能力表

🔧 19 个 Tools

Tool	功能	对齐
device	屏幕操作：snapshot/tap/type/scroll/press/open	Playwright
read_file	读取文件内容	OpenClaw
write_file	创建或覆盖文件	OpenClaw
edit_file	精确编辑文件	OpenClaw
list_dir	列出目录内容	OpenClaw
exec	执行命令（Termux SSH / 内置 Shell）	OpenClaw
web_search	Brave 搜索引擎	OpenClaw
web_fetch	抓取网页内容	OpenClaw
javascript	执行 JavaScript（QuickJS）	OpenClaw
skills_search	搜索 ClawHub 技能	OpenClaw
skills_install	从 ClawHub 安装技能	OpenClaw
memory_search	语义搜索记忆	OpenClaw
memory_get	读取记忆片段	OpenClaw
config_get	读取配置项	OpenClaw
config_set	写入配置项	OpenClaw
list_installed_apps	列出已安装应用	Android 特有
install_app	安装 APK	Android 特有
start_activity	启动 Activity	Android 特有
stop	停止 Agent	Android 特有

🧩 20 个 Skills

类别	Skills
飞书全家桶	feishu · feishu-doc · feishu-wiki · feishu-drive · feishu-bitable · feishu-chat · feishu-task · feishu-perm · feishu-urgent
搜索 & 网页	browser · weather
技能管理	clawhub · skill-creator
开发调试	debugging · data-processing · session-logs
配置管理	model-config · channel-config · install-app · model-usage

Skills 存储在 /sdcard/.androidforclaw/skills/，可自由编辑、添加、删除。

💬 消息渠道

渠道	状态	功能
飞书	✅ 可用	WebSocket 实时连接，群聊/私聊，32 个飞书工具
Discord	✅ 可用	Gateway 连接，群聊/私聊
Telegram	🔧 框架就绪	Bot API polling/webhook，模型覆盖，流式回复
Slack	🔧 框架就绪	Socket Mode / HTTP Mode，模型覆盖，流式回复
Signal	🔧 框架就绪	signal-cli daemon 接入，模型覆盖
WhatsApp	🔧 框架就绪	WhatsApp Business API，模型覆盖
设备内对话	✅ 可用	内置聊天界面

所有渠道配置字段均对齐 OpenClaw TypeScript 类型定义（types.slack.ts、types.telegram.ts 等）。

🤖 支持的模型

Provider	模型	说明
OpenRouter	MiMo V2 Pro, Hunter Alpha, DeepSeek R1, Claude Sonnet 4, GPT-4.1	推荐，内置 Key
小米 MiMo	MiMo V2 Pro, MiMo V2 Flash, MiMo V2 Omni	直连小米 API
Google	Gemini 2.5 Pro, Gemini 2.5 Flash	直连
Anthropic	Claude Sonnet 4, Claude Opus 4	直连
OpenAI	GPT-4.1, GPT-4.1 Mini, o3	直连
自定义	任何 OpenAI 兼容 API	Ollama, vLLM 等

默认配置：OpenRouter + MiMo V2 Pro（1M 上下文 + 推理），跳过引导页自动使用内置 Key。

---

/sdcard/.androidforclaw/openclaw.json

{
  "models": {
    "providers": {
      "openrouter": {
        "baseUrl": "https://openrouter.ai/api/v1",
        "apiKey": "sk-or-v1-你的key",
        "models": [{"id": "xiaomi/mimo-v2-pro", "reasoning": true, "contextWindow": 1048576}]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "openrouter/xiaomi/mimo-v2-pro" }
    }
  },
  "channels": {
    "feishu": { "enabled": true, "appId": "cli_xxx", "appSecret": "xxx" },
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "mode": "socket",
      "streaming": "partial",
      "model": "openrouter/xiaomi/mimo-v2-pro"
    },
    "telegram": {
      "enabled": true,
      "botToken": "123456:ABC-...",
      "streaming": "partial"
    }
  }
}

详细配置参考 📖 飞书文档

---

🔨 从源码构建

git clone https://github.com/SelectXn00b/AndroidForClaw.git
cd AndroidForClaw
export JAVA_HOME=/path/to/jdk17
./gradlew assembleRelease
adb install releases/AndroidForClaw-v1.3.0-release.apk

---

🔗 Related Projects

项目	说明
OpenClaw	AI Agent 框架（桌面端）
iOSForClaw	OpenClaw iOS 客户端
AndroidForClaw	OpenClaw Android 客户端（本项目）

---

📞 社区

飞书群

点击加入飞书群

---

Discord

加入 Discord

---

微信群

扫码加入微信群 - 7天内有效

---

🔗 相关链接

• OpenClaw — 架构参照
• ClawHub — 技能市场
• 源码映射 — OpenClaw ↔ AndroidForClaw 对照
• 架构文档 — 详细设计

---

📄 License

MIT — LICENSE

🙏 致谢

• OpenClaw — 架构灵感
• Claude — AI 推理能力

---

⭐ 如果这个项目对你有帮助，请给个 Star 支持开源！ ⭐