ClawPaw Android 手机控制
📖 执行前必读
📱 环境要求
手机端：
主机端：
- - Node.js 18+（运行 Gateway）
- Python 3.8+（运行 HTTP 脚本）
- 网络连通（同 WiFi 或 Tailscale）
路径说明：本文档中的
<skill_dir> 是占位符，代表本 skill 的实际存放路径（如
~/.openclaw/skills/clawpaw-android-control）。使用时请替换为实际路径。
执行任何具体任务前，请先查阅操作指南索引：
CODEBLOCK0
该索引包含：
- - ✅ 所有支持的操作场景
- ✅ 对应指南文件位置
- ✅ 快速决策流程
- ✅ 支持的应用列表
通用流程：
- 1. 确认任务场景（如"评论互动"、"搜索地点"）
- 在 INDEX.md 中找到对应指南
- 读取指南后执行任务
- 优先使用获取布局的方法执行任务
方式一：Node（Gateway）
手机通过 WebSocket 连接 Gateway，通过 OpenClaw nodes 工具调用。
前提：手机端 App 显示「已连接 Gateway」
🎯 原生 Action（优先使用）
以下原生 action 直接用 nodes action=<action> 调用，无需 invoke，有参数验证和统一返回格式：
| Action | 说明 | 参数 | 示例 |
|---|
| INLINECODE4 | 设备状态（电量、屏幕、WiFi、位置） | 无 | INLINECODE5 |
| INLINECODE6 |
设备信息（型号、厂商、Android 版本） | 无 |
nodes device_info --node <id> |
|
device_health | 设备健康（内存、电池详情）
仅 Node | 无 |
nodes device_health --node <id> |
|
device_permissions | 权限状态
仅 Node | 无 |
nodes device_permissions --node <id> |
|
location_get | 获取位置 | 无 |
nodes location_get --node <id> |
|
notifications_list | 通知列表 | 无 |
nodes notifications_list --node <id> |
|
photos_latest | 最新照片（返回图片） | 无 |
nodes photos_latest --node <id> |
|
status | 列出所有节点 | 无 |
nodes status |
|
describe | 节点详情 |
--node <id> |
nodes describe --node <id> |
|
notify | 发送通知 |
--title,
--body |
nodes notify --node <id> --title "标题" --body "内容" |
其他所有命令用 invoke 方式 ↓
🔧 Invoke 命令（非原生）
格式：
CODEBLOCK1
参数规则：
- - 无参数命令： INLINECODE28
- 有参数：JSON 格式，键名与下表一致
- 带文字：传
text/title/body 等字段
无障碍 / 界面操作（需开启无障碍服务）
| 命令 | 参数 | 说明 | 示例 |
|---|
| INLINECODE32 | INLINECODE33 , INLINECODE34 | 点击坐标 | INLINECODE35 |
| INLINECODE36 |
start_x,
start_y,
end_x,
end_y,
duration(可选) | 滑动 |
{"start_x":720,"start_y":2500,"end_x":720,"end_y":500} |
|
input_text |
x,
y,
text | 点击后输入（需 ClawPaw 输入法） |
{"x":300,"y":800,"text":"内容"} |
|
input_text_direct |
x,
y,
text | 无障碍直接输入（无需输入法） |
{"x":300,"y":800,"text":"内容"} |
|
long_press |
x,
y | 长按 700ms |
{"x":500,"y":1000} |
|
two_finger_swipe_same |
start_x,
start_y,
end_x,
end_y | 两指同向滑动（放大） |
{"start_x":400,"start_y":1200,"end_x":400,"end_y":400} |
|
two_finger_swipe_opposite |
start_x,
start_y,
end_x,
end_y | 两指反向滑动（缩放） |
{"start_x":300,"start_y":800,"end_x":600,"end_y":800} |
|
back | 无 | 返回键 |
{} |
|
get_layout | 无 | 获取界面布局 XML |
{} |
|
screenshot | 无 | 截图（Base64） |
{} |
|
open_schema |
schema 或
uri | 按包名或 schema 打开应用 |
{"schema":"com.android.chrome"} |
设备状态（无需无障碍）
| 命令 | 参数 | 返回 |
|---|
| INLINECODE79 | 无 | 电量百分比 0-100 |
| INLINECODE80 |
无 | WiFi SSID |
|
get_screen_state | 无 |
on /
off |
|
get_state | 无 | 完整状态（定位+WiFi+屏幕+电量+分辨率） |
硬件控制
| 命令 | 参数 | 说明 |
|---|
| INLINECODE85 | INLINECODE86 （可选，默认 200） | 震动 |
| INLINECODE87 |
无 | 后置拍照（异步） |
|
camera_front | 无 | 前置拍照（异步） |
|
screen_on | 无 | 点亮屏幕 |
通知管理（需通知监听权限）
| 命令 | 参数 | 说明 |
|---|
| INLINECODE90 | INLINECODE91 , text 或 INLINECODE93 | 推送本地通知 |
| INLINECODE94 |
title,
body | 同上（别名） |
|
system.notify |
title,
body | 系统通知 |
|
notifications.actions ⚠️ |
action,
key | 操作通知（dismiss/open/reply）
仅 Node |
数据访问（需相应权限）
| 命令 | 参数 | 说明 |
|---|
| INLINECODE103 | INLINECODE104 （可选，默认 500） | 联系人列表 |
| INLINECODE105 |
query,
limit | 搜索联系人 |
|
photos.latest |
limit（可选，默认 50） | 最近照片 |
|
calendar.list |
limit（可选，默认 100） | 日历事件 |
|
calendar.events |
limit | 同上（别名） |
音量控制
| 命令 | 参数 | 说明 |
|---|
| INLINECODE114 | 无 | 获取音量 |
| INLINECODE115 |
stream,
volume | 设置音量（stream:
media/
ring） |
文件操作（需存储权限）
| 命令 | 参数 | 说明 |
|---|
| INLINECODE120 | INLINECODE121 | 读取 UTF-8 文本 |
| INLINECODE122 |
path | 读取二进制文件 |
传感器与运动
| 命令 | 参数 | 说明 |
|---|
| INLINECODE124 | 无 | 步数 |
| INLINECODE125 |
无 | 光照 lux |
|
sensors.info | 无 | 传感器列表 |
|
motion.pedometer ⚠️ |
startISO,
endISO | 计步（ISO8601 时间）
仅 Node |
|
motion.activity ⚠️ | 无 | 活动识别（步行/静止等）
仅 Node |
蓝牙/WiFi
| 命令 | 参数 | 说明 |
|---|
| INLINECODE131 | 无 | 已配对设备 |
| INLINECODE132 |
无 | WiFi 状态 |
|
wifi.enable |
enabled | 开关 WiFi（true/false） |
短信/电话（需相应权限）
| 命令 | 参数 | 说明 |
|---|
| INLINECODE135 | INLINECODE136 | 收件箱短信 |
| INLINECODE137 |
address/
to,
body/
text | 发送短信 |
|
phone.dial |
number/
phone | 打开拨号界面 |
|
phone.call |
number/
phone | 直接拨打电话 |
铃声与勿扰
| 命令 | 参数 | 说明 |
|---|
| INLINECODE148 | 无 | 铃声模式（normal/silent/vibrate） |
| INLINECODE149 |
mode | 设置铃声模式 |
|
dnd.get | 无 | 勿扰状态 |
|
dnd.set |
enabled | 设置勿扰（true=仅闹钟） |
⚠️ 注意事项
- 1. 无障碍服务：界面操作类命令需要开启 ClawPaw 无障碍服务
- 2. 权限授权：
- 部分功能需要用户手动授权（通知、联系人、照片等）
- 具体授权路径见
README_PERMISSIONS.md
- 3. 网络连通：
- Gateway 模式：手机需连接到同一 Gateway
- HTTP 模式：手机与主机需网络互通（同 WiFi 或 Tailscale）
- 4. 命令命名：
- 原生 action 用
下划线：
device_status
- invoke 命令用
点号：
device.status、 INLINECODE157
- 5. 返回布局：无障碍命令默认返回布局，可加
return_layout_after: false 关闭
🎯 快速开始
1. 手机端安装 ClawPaw App
- 1. 下载 ClawPaw App
- 安装到 Android 手机（Android 10+）
- 开启无障碍服务：
设置 → 辅助功能 → 已下载的服务 → ClawPaw Accessibility Service → 开启
- 4. （可选）按需授予权限：位置、通知、联系人、照片等
2. 主机端配置
方式一：Gateway（WebSocket）
CODEBLOCK3
方式二：本地 HTTP
CODEBLOCK4
3. 测试命令
CODEBLOCK5
⚠️ 权限说明
ClawPaw 使用 24 项权限，分为三类：
| 类别 | 权限数 | 说明 |
|---|
| 基础权限 | 9 项 | 安装即授予，必需 |
| 用户授权 |
14 项 | 手动授权，可选 |
|
特殊权限 | 2 项 | 特殊授权，可选 |
详细说明：见 README_PERMISSIONS.md
| 功能 | 必需权限 | 示例命令 |
|---|
| 点击/滑动/输入 | INLINECODE160 | INLINECODE161 , swipe, INLINECODE163 |
| 定位 |
ACCESS_FINE_LOCATION |
location_get |
| 通知 |
POST_NOTIFICATIONS |
notifications_list |
| 联系人 |
READ_CONTACTS |
contacts.list |
| 照片 |
READ_MEDIA_IMAGES |
photos_latest |
| 短信 |
READ_SMS +
SEND_SMS |
sms.list,
sms.send |
| 电话 |
CALL_PHONE |
phone.dial,
phone.call |
| 文件读取 |
READ_EXTERNAL_STORAGE |
file.read_text |
[61 more lines in file. Use offset=170 to continue.]
手机端 HTTP 服务（默认端口 8765），通过 Python 脚本调用。
前提：手机和主机网络互通（同 WiFi 或 Tailscale）
配置
CODEBLOCK6
脚本调用
脚本位置： INLINECODE181
CODEBLOCK7
完整命令列表见脚本帮助：python3 clawpaw_controller.py --help
快速参考
| 需求 | 推荐方式 | 命令 |
|---|
| 查设备状态 | 原生 action | INLINECODE183 |
| 查设备信息 |
原生 action |
device_info |
| 获取位置 | 原生 action |
location_get |
| 获取通知 | 原生 action |
notifications_list |
| 获取照片 | 原生 action |
photos_latest |
| 点击/滑动/输入 | invoke |
click/
swipe/
input_text |
| 打开应用 | invoke |
open_schema |
| 截图/布局 | invoke |
screenshot/
get_layout |
更新时间：2026-03-13ClawPaw Android 手机控制
📖 执行前必读
📱 环境要求
手机端：
主机端：
- - Node.js 18+（运行 Gateway）
- Python 3.8+（运行 HTTP 脚本）
- 网络连通（同 WiFi 或 Tailscale）
路径说明：本文档中的
是占位符，代表本 skill 的实际存放路径（如 ~/.openclaw/skills/clawpaw-android-control）。使用时请替换为实际路径。
执行任何具体任务前，请先查阅操作指南索引：
/references/INDEX.md
该索引包含：
- - ✅ 所有支持的操作场景
- ✅ 对应指南文件位置
- ✅ 快速决策流程
- ✅ 支持的应用列表
通用流程：
- 1. 确认任务场景（如评论互动、搜索地点）
- 在 INDEX.md 中找到对应指南
- 读取指南后执行任务
- 优先使用获取布局的方法执行任务
方式一：Node（Gateway）
手机通过 WebSocket 连接 Gateway，通过 OpenClaw nodes 工具调用。
前提：手机端 App 显示「已连接 Gateway」
🎯 原生 Action（优先使用）
以下原生 action 直接用 nodes action= 调用，无需 invoke，有参数验证和统一返回格式：
| Action | 说明 | 参数 | 示例 |
|---|
| devicestatus | 设备状态（电量、屏幕、WiFi、位置） | 无 | nodes devicestatus --node <id> |
| deviceinfo |
设备信息（型号、厂商、Android 版本） | 无 | nodes deviceinfo --node |
| devicehealth | 设备健康（内存、电池详情）仅 Node | 无 | nodes devicehealth --node |
| devicepermissions | 权限状态 仅 Node | 无 | nodes devicepermissions --node |
| locationget | 获取位置 | 无 | nodes locationget --node |
| notificationslist | 通知列表 | 无 | nodes notificationslist --node |
| photoslatest | 最新照片（返回图片） | 无 | nodes photoslatest --node |
| status | 列出所有节点 | 无 | nodes status |
| describe | 节点详情 | --node | nodes describe --node |
| notify | 发送通知 | --title, --body | nodes notify --node --title 标题 --body 内容 |
其他所有命令用 invoke 方式 ↓
🔧 Invoke 命令（非原生）
格式：
bash
openclaw nodes invoke --node --command <命令> --params
参数规则：
- - 无参数命令：--params {}
- 有参数：JSON 格式，键名与下表一致
- 带文字：传 text/title/body 等字段
无障碍 / 界面操作（需开启无障碍服务）
| 命令 | 参数 | 说明 | 示例 |
|---|
| click | x, y | 点击坐标 | {x:500,y:1000} |
| swipe |
startx, starty, endx, endy, duration(可选) | 滑动 | {startx:720,starty:2500,endx:720,endy:500} |
| input_text | x, y, text | 点击后输入（需 ClawPaw 输入法） | {x:300,y:800,text:内容} |
| inputtextdirect | x, y, text | 无障碍直接输入（无需输入法） | {x:300,y:800,text:内容} |
| long_press | x, y | 长按 700ms | {x:500,y:1000} |
| twofingerswipesame | startx, starty, endx, endy | 两指同向滑动（放大） | {startx:400,starty:1200,endx:400,end_y:400} |
| twofingerswipeopposite | startx, starty, endx, endy | 两指反向滑动（缩放） | {startx:300,starty:800,endx:600,end_y:800} |
| back | 无 | 返回键 | {} |
| get_layout | 无 | 获取界面布局 XML | {} |
| screenshot | 无 | 截图（Base64） | {} |
| open_schema | schema 或 uri | 按包名或 schema 打开应用 | {schema:com.android.chrome} |
设备状态（无需无障碍）
| 命令 | 参数 | 返回 |
|---|
| getbattery | 无 | 电量百分比 0-100 |
| getwifi_name |
无 | WiFi SSID |
| getscreenstate | 无 | on / off |
| get_state | 无 | 完整状态（定位+WiFi+屏幕+电量+分辨率） |
硬件控制
| 命令 | 参数 | 说明 |
|---|
| vibrate | durationms（可选，默认 200） | 震动 |
| camerarear |
无 | 后置拍照（异步） |
| camera_front | 无 | 前置拍照（异步） |
| screen_on | 无 | 点亮屏幕 |
通知管理（需通知监听权限）
| 命令 | 参数 | 说明 |
|---|
| notification.show | title, text 或 body | 推送本地通知 |
| notifications.push |
title, body | 同上（别名） |
| system.notify | title, body | 系统通知 |
| notifications.actions ⚠️ | action, key | 操作通知（dismiss/open/reply）仅 Node |
数据访问（需相应权限）
| 命令 | 参数 | 说明 |
|---|
| contacts.list | limit（可选，默认 500） | 联系人列表 |
| contacts.search |
query, limit | 搜索联系人 |
| photos.latest | limit（可选，默认 50） | 最近照片 |
| calendar.list | limit（可选，默认 100） | 日历事件 |
| calendar.events | limit | 同上（别名） |
音量控制
| 命令 | 参数 | 说明 |
|---|
| volume.get | 无 | 获取音量 |
| volume.set |
stream, volume | 设置音量（stream: media/ring） |
文件操作（需存储权限）
| 命令 | 参数 | 说明 |
|---|
| file.readtext | path | 读取 UTF-8 文本 |
| file.readbase64 |
path | 读取二进制文件 |
传感器与运动
| 命令 | 参数 | 说明 |
|---|
| sensors.steps | 无 | 步数 |
| sensors.light |
无 | 光照 lux |
| sensors.info | 无 | 传感器列表 |
| motion.pedometer ⚠️ | startISO, endISO | 计步（ISO8601 时间）仅 Node |
| motion.activity ⚠️ | 无 | 活动识别（步行/静止等）仅 Node |
蓝牙/WiFi
| 命令 | 参数 | 说明 |
|---|
| bluetooth.list | 无 | 已配对设备 |
|
