andforce / Andclaw

Andclaw 🤖 > **让 AI 像人类一样使用你的手机** —— 完全在设备上运行，无需 Root，无需电脑。 🌐 官方网站  |  📲 在线安装 APK --- 🌟 核心亮点 | 特性 | 说明 | |------|------| | **🚫 无需 Root** | 纯无障碍服务实现，不依赖系统权限 | | **💻 无需电脑** | 完全在手机上独立运行，无需 ADB 或 PC 端配合 | | **🧠 AI 驱动** | 支持 Kimi Code（Anthropic 格式）、Moonshot 和任意 OpenAI 兼容 API | | **👁️ 屏幕感知** | 实时读取 UI 层次结构 + WebView/浏览器场景自动截图辅助视觉分析 | | **🤏 拟人操作** | 模拟点击、滑动、长按、文本输入等手势操作 | | **📸 多媒体能力** | 拍照、录像、录屏、截图、音量控制 | | **📱 设备管控** | Device Owner 模式下支持企业级设备管理（静默装卸、Kiosk 等） | | **🤖 Telegram 远程控制** | 通过 Telegram Bot 远程下发指令、接收截图/录像 | 📋 与其他方案对比 | 特性 | Andclaw | Open-AutoGLM | 肉包 Roubao | 豆包手机 | |-----|:-------:|:--------:|:-------:|:-------:| | 无需电脑 | ✅ | ❌ 需 PC 运行 Python | ✅ | ✅ | | 无需专用硬件 | ✅ | ✅ | ✅ | ❌ 需购买 3499 元工程机 | | 无需 Shizuku / ADB | ✅ 无障碍服务 | ❌ ADB 控制 | ❌ 依赖 Shizuku | ✅ | | 远程控制 | ✅ Telegram Bot | ❌ | ❌ | ❌ | | 自定义模型 | ✅ 多 Provider | ✅ | ✅ | ❌ 仅豆包 | | 开源 | ✅ | ✅ | ✅ | ❌ | | 原生 Android | ✅ Kotlin | ❌ Python | ✅ Kotlin | ✅ | **Andclaw 的核心差异**： • **零外部依赖**：基于 Android 无障碍服务，无需 Shizuku 初始化、无需 ADB 连接、无需电脑 • **远程控制**：通过 Telegram Bot 远程下发指令、接收截图和录像，适合无人值守场景 • **UI 层级 + 视觉双模感知**：优先解析 Accessibility 节点树，WebView/浏览器场景自动切换截图分析 • **循环检测 + 截图重试**：同一动作重复 5 次自动截图视觉重试，避免 Agent 死循环 --- 📱 演示 --- 🚀 快速开始 环境要求 • **Android 版本**: Android 12 (API 31) 或更高 • **无障碍服务**: 需要在 中手动启用 • **悬浮窗权限**: 用于显示紧急停止按钮 • **API Key**: 从 Kimi Code、Moonshot 开放平台 或任意 OpenAI 兼容 API 提供商获取 安装方式 **方式一：在线安装使用Chrome浏览器（推荐）** 使用Chrome浏览器直接访问 andclaw.app/#/install，然后按提示操作即可。 **方式二：从源码编译** • **克隆仓库** • **编译安装** • **授予权限** • 打开应用后，按提示启用**无障碍服务** • 授予**显示在其他应用上层**权限 • **激活 Device Owner** 通过 ADB 激活（仅首次设置需要），激活后 Andclaw 获得企业级设备管理能力： > ⚠️ **重要**：由于 Android 安全限制，设备必须先**恢复出厂设置**才能启用 Device Owner 模式。不启用 Device Owner 模式，AI操作手机的权限将大幅受限。 • ✅ **应用管理**：静默安装/卸载应用、隐藏/显示/挂起应用、阻止卸载、自动授予权限、查询已安装应用列表 • ✅ **设备控制**：远程锁屏、重启、恢复出厂设置、禁用摄像头/状态栏/锁屏、USB 数据传输控制、定位开关 • ✅ **Kiosk 模式**：单应用锁定（Lock Task）、替换默认桌面、禁止安全模式/恢复出厂 > 详细能力清单见 ACTIONS.md • **创建 Telegram 机器人** • 在 Telegram 中搜索并打开 **@BotFather** • 发送 创建新机器人 • 按提示设置机器人名称和用户名（用户名必须以 结尾） • 创建成功后，复制提供的 **Bot Token**（格式如： ） • 在 Andclaw 设置页面中填入 Bot Token --- 🎯 使用方式 • 文字指令 直接告诉 Andclaw 你想做什么： | 指令示例 | AI 执行过程 | |---------|------------| | "打开bilibili，搜索AI学习相关的视频，并播放" | 识别B站图标 → 点击 → 进入搜索页 → 输入"AI学习" → 点击搜索 → 选择视频 → 播放 | • AI Agent 工作循环 • 支持的操作类型 | 类型 | 说明 | |------|------| | | 启动应用/Activity，打开网页、拨号、发短信、设置闹钟等系统 Intent | | | 在屏幕坐标 (x, y) 模拟点击 | | | 滑动手势（滚动、翻页），支持自定义时长 | | | 长按，支持自定义时长 | | | 向当前焦点输入框注入文本（SET_TEXT → 剪贴板粘贴 fallback） | | | 系统级操作：返回、Home、最近任务、通知栏、快捷设置 | | | 截图并保存到 ，通过 Telegram 自动发送 | | | 通过 DownloadManager 直接下载文件（无需打开浏览器） | | | 等待页面加载/UI 过渡完成后重新检查屏幕（最长 10 秒） | | | 拍照（ ）、开始录像（ ）、停止录像（ ） | | | 录屏（ / ），保存到 | | | 音量控制：设置、调高/调低、静音/取消静音、查询当前音量 | | | Device Policy Manager 操作（仅 Device Owner 模式） | | | 任务完成，停止 Agent | • 支持的 AI 提供商 | 提供商 | API 格式 | Base URL | 默认模型 | |--------|---------|----------|---------| | **Kimi Code** | Anthropic Messages | | | | **Moonshot** | OpenAI Chat Completions | | | | **OpenAI 兼容** | OpenAI Chat Completions | | | 支持多模态输入（文本 + 截图 base64），所有格式均可携带图片。 Kimi Code 与 Moonshot API 的区别 Moonshot AI 提供了两套独立的 API 服务，API Key **不通用**： | 维度 | Kimi Code API | Moonshot 开放平台 API | |------|--------------|---------------------| | **端点** | | | | **协议格式** | Anthropic Messages（ ） | OpenAI 兼容（ ） | | **认证方式** | header | | | **API Key 获取** | Kimi Code 会员页面 | Moonshot 开放平台 | | **定位** | 专为 Coding Agent 优化 | 通用 LLM API | • Telegram 远程控制 通过 Telegram Bot 远程控制设备，启动 Andclaw 后 Telegram 机器人会自动启动。 | 命令 | 说明 | |------|------| | 直接发送文字 | 作为指令下发给 Agent 执行 | | | 查询 Agent 状态（运行中/空闲、当前任务、Chat ID） | | | 停止当前正在执行的任务 | 截图、拍照、录像完成后会自动发送到 Telegram 对话中。 --- ⭐ Star History --- 📄 许可证 本项目采用 MIT 许可证 开源。 --- 🙏 致谢 • TestDPC - Device Owner 功能参考 • Kimi API - 大语言模型支持 --- ⚠️ 免责声明 本项目仅供学习和研究使用。开发者不对因使用本软件导致的任何数据丢失、设备损坏或其他损失承担责任。请谨慎使用 AI 自动化功能，避免在包含敏感信息的场景中使用。屏幕 UI 数据和截图会发送给 LLM 提供商，请注意隐私保护。 --- Made with ❤️ by Andclaw Team