ClawPaw Android 手机控制

📖 执行前必读

📱 环境要求

手机端：

• Android 10+（推荐 Android 11+）
• 安装 ClawPaw App
• 开启无障碍服务（必需）
• 部分功能需授权额外权限（见 权限说明）

主机端：

• Node.js 18+（运行 Gateway）
• Python 3.8+（运行 HTTP 脚本）
• 网络连通（同 WiFi 或 Tailscale）

路径说明：本文档中的 <skill_dir> 是占位符，代表本 skill 的实际存放路径（如 ~/.openclaw/skills/clawpaw-android-control）。使用时请替换为实际路径。

执行任何具体任务前，请先查阅操作指南索引：

<skill_dir>/references/INDEX.md

该索引包含：

• ✅ 所有支持的操作场景
• ✅ 对应指南文件位置
• ✅ 快速决策流程
• ✅ 支持的应用列表

通用流程：

1. 确认任务场景（如"评论互动"、"搜索地点"）
2. 在 INDEX.md 中找到对应指南
3. 读取指南后执行任务
4. 优先使用获取布局的方法执行任务

方式一：Node（Gateway）

手机通过 WebSocket 连接 Gateway，通过 OpenClaw nodes 工具调用。

前提：手机端 App 显示「已连接 Gateway」

🎯 原生 Action（优先使用）

以下原生 action 直接用 nodes action=<action> 调用，无需 invoke，有参数验证和统一返回格式：

其他所有命令用 invoke 方式 ↓

🔧 Invoke 命令（非原生）

格式：

openclaw nodes invoke --node <NODE_ID> --command <命令> --params '<JSON>'

参数规则：

• 无参数命令：--params '{}'
• 有参数：JSON 格式，键名与下表一致
• 带文字：传 text/title/body 等字段

无障碍 / 界面操作（需开启无障碍服务）

设备状态（无需无障碍）

硬件控制

通知管理（需通知监听权限）

数据访问（需相应权限）

音量控制

文件操作（需存储权限）

传感器与运动

蓝牙/WiFi

短信/电话（需相应权限）

铃声与勿扰

⚠️ 注意事项

1. 无障碍服务：界面操作类命令需要开启 ClawPaw 无障碍服务

2. 权限授权：

   • 部分功能需要用户手动授权（通知、联系人、照片等）
   • 具体授权路径见 README_PERMISSIONS.md

3. 网络连通：

   • Gateway 模式：手机需连接到同一 Gateway
   • HTTP 模式：手机与主机需网络互通（同 WiFi 或 Tailscale）

4. 命令命名：

   • 原生 action 用下划线：device_status
   • invoke 命令用点号：device.status、volume.set

5. 返回布局：无障碍命令默认返回布局，可加 return_layout_after: false 关闭

🎯 快速开始

1. 手机端安装 ClawPaw App

1. 下载 ClawPaw App
2. 安装到 Android 手机（Android 10+）
3. 开启无障碍服务：

   设置 → 辅助功能 → 已下载的服务 → ClawPaw Accessibility Service → 开启
   

4. （可选）按需授予权限：位置、通知、联系人、照片等

2. 主机端配置

方式一：Gateway（WebSocket）

# 确认 Gateway 已运行
openclaw gateway status

# 添加节点（ClawPaw App 连接到 Gateway 后自动注册）
openclaw nodes status

方式二：本地 HTTP

# 确认手机和主机网络连通（同 WiFi 或 Tailscale）
# 手机端 ClawPaw App 端口：8765（默认）

# 使用 Python 脚本
pip3 install requests pyyaml
cd ~/.openclaw/skills/clawpaw-android-control/scripts
python3 clawpaw_controller.py device_info

3. 测试命令

# 查看设备信息（Gateway）
openclaw nodes device_info --node <NODE_ID>

# 获取状态（Gateway）
openclaw nodes device_status --node <NODE_ID>

# 获取最新照片（Gateway）
openclaw nodes photos_latest --node <NODE_ID>

# HTTP 方式测试
python3 clawpaw_controller.py device_info

⚠️ 权限说明

ClawPaw 使用 24 项权限，分为三类：

详细说明：见 README_PERMISSIONS.md

[61 more lines in file. Use offset=170 to continue.]

手机端 HTTP 服务（默认端口 8765），通过 Python 脚本调用。

前提：手机和主机网络互通（同 WiFi 或 Tailscale）

配置

# config.yaml
network_type: local  # local / tailscale / wifi
host: 127.0.0.1      # local 模式不需要
port: 8765
timeout: 10

# 百炼 API 配置（视觉分析需要）
dashscope_api_key: sk-xxx
dashscope_model: qwen3.5-plus

脚本调用

脚本位置：<skill_dir>/scripts/clawpaw_controller.py

# 基础操作
python3 clawpaw_controller.py click 500 1000
python3 clawpaw_controller.py swipe 500 1500 500 500
python3 clawpaw_controller.py input_text_direct 300 800 "内容"
python3 clawpaw_controller.py back

# 状态查询
python3 clawpaw_controller.py get_battery
python3 clawpaw_controller.py get_wifi_name
python3 clawpaw_controller.py device_info

# 视觉分析（HTTP 独有）
python3 clawpaw_controller.py analyze "找到搜索框并返回坐标"
python3 clawpaw_controller.py analyze "找到评论入口" --no-save

完整命令列表见脚本帮助：python3 clawpaw_controller.py --help

快速参考

更新时间：2026-03-13