How do I install the Clawpaw Android Control skill?

Run npx skillmds@latest add dvcrn/clawpaw-android-control in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Clawpaw Android Control skill do?

Android 手机自动化控制技能。支持 Node（Gateway）和 HTTP 两种连接方式，提供点击、滑动、输入、截图、布局获取、应用打开等操作。（需 Java 11+、Android 10+ 手机，安装 ClawPaw App 并开启无障碍服务） It is listed under Coding & Dev Tools on SkillMD.

Is Clawpaw Android Control safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Clawpaw Android Control?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Clawpaw Android Control free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Clawpaw Android Control?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Clawpaw Android Control by dvcrn — Agent Skill

Name: Clawpaw Android Control
Rating: 4.666666666666667 (3 reviews)
Author: dvcrn

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

该索引包含：

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

通用流程：

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

方式一：Node（Gateway）

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

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

🎯 原生 Action（优先使用）

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

Action	说明	参数	示例
`device_status`	设备状态（电量、屏幕、WiFi、位置）	无	`nodes device_status --node <id>`
`device_info`	设备信息（型号、厂商、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 命令（非原生）

格式：

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

参数规则：

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

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

命令	参数	说明	示例
`click`	`x`, `y`	点击坐标	`{"x":500,"y":1000}`
`swipe`	`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"}`

设备状态（无需无障碍）

命令	参数	返回
`get_battery`	无	电量百分比 0-100
`get_wifi_name`	无	WiFi SSID
`get_screen_state`	无	`on` / `off`
`get_state`	无	完整状态（定位+WiFi+屏幕+电量+分辨率）

硬件控制

命令	参数	说明
`vibrate`	`duration_ms`（可选，默认 200）	震动
`camera_rear`	无	后置拍照（异步）
`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.read_text`	`path`	读取 UTF-8 文本
`file.read_base64`	`path`	读取二进制文件

传感器与运动

命令	参数	说明
`sensors.steps`	无	步数
`sensors.light`	无	光照 lux
`sensors.info`	无	传感器列表
`motion.pedometer` ⚠️	`startISO`, `endISO`	计步（ISO8601 时间）仅 Node
`motion.activity` ⚠️	无	活动识别（步行/静止等）仅 Node

蓝牙/WiFi

命令	参数	说明
`bluetooth.list`	无	已配对设备
`wifi.info`	无	WiFi 状态
`wifi.enable`	`enabled`	开关 WiFi（true/false）

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

命令	参数	说明
`sms.list`	`limit`	收件箱短信
`sms.send`	`address`/`to`, `body`/`text`	发送短信
`phone.dial`	`number`/`phone`	打开拨号界面
`phone.call`	`number`/`phone`	直接拨打电话

铃声与勿扰

命令	参数	说明
`ringer.get`	无	铃声模式（normal/silent/vibrate）
`ringer.set`	`mode`	设置铃声模式
`dnd.get`	无	勿扰状态
`dnd.set`	`enabled`	设置勿扰（true=仅闹钟）

⚠️ 注意事项

无障碍服务：界面操作类命令需要开启 ClawPaw 无障碍服务
权限授权：
- 部分功能需要用户手动授权（通知、联系人、照片等）
- 具体授权路径见 README_PERMISSIONS.md
网络连通：
- Gateway 模式：手机需连接到同一 Gateway
- HTTP 模式：手机与主机需网络互通（同 WiFi 或 Tailscale）
命令命名：
- 原生 action 用下划线：device_status
- invoke 命令用点号：device.status、volume.set
返回布局：无障碍命令默认返回布局，可加 return_layout_after: false 关闭

🎯 快速开始

1. 手机端安装 ClawPaw App

下载 ClawPaw App
安装到 Android 手机（Android 10+）

开启无障碍服务：

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

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

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 项权限，分为三类：

类别	权限数	说明
基础权限	9 项	安装即授予，必需
用户授权	14 项	手动授权，可选
特殊权限	2 项	特殊授权，可选

详细说明：见 README_PERMISSIONS.md

功能	必需权限	示例命令
点击/滑动/输入	`BIND_ACCESSIBILITY_SERVICE`	`click`, `swipe`, `input_text`
定位	`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）

配置

# 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

快速参考

需求	推荐方式	命令
查设备状态	原生 action	`device_status`
查设备信息	原生 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-13

Clawpaw Android Control

File contents

ClawPaw Android 手机控制

📖 执行前必读

📱 环境要求

方式一：Node（Gateway）

🎯 原生 Action（优先使用）

🔧 Invoke 命令（非原生）

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

设备状态（无需无障碍）

硬件控制

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

数据访问（需相应权限）

音量控制

文件操作（需存储权限）

传感器与运动

蓝牙/WiFi

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

铃声与勿扰

⚠️ 注意事项

🎯 快速开始

1. 手机端安装 ClawPaw App

2. 主机端配置

方式一：Gateway（WebSocket）

方式二：本地 HTTP

3. 测试命令

⚠️ 权限说明

配置

脚本调用

快速参考

Frequently asked questions

Clawpaw Android Control

File contents

ClawPaw Android 手机控制

📖 执行前必读

📱 环境要求

方式一：Node（Gateway）

🎯 原生 Action（优先使用）

🔧 Invoke 命令（非原生）

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

设备状态（无需无障碍）

硬件控制

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

数据访问（需相应权限）

音量控制

文件操作（需存储权限）

传感器与运动

蓝牙/WiFi

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

铃声与勿扰

⚠️ 注意事项

🎯 快速开始

1. 手机端安装 ClawPaw App

2. 主机端配置

方式一：Gateway（WebSocket）

方式二：本地 HTTP

3. 测试命令

⚠️ 权限说明

配置

脚本调用

快速参考

Related skills

Frequently asked questions

How do I install the Clawpaw Android Control skill?

What does the Clawpaw Android Control skill do?

Is Clawpaw Android Control safe to use?

Which AI agents work with Clawpaw Android Control?

Is Clawpaw Android Control free to use?

Who published Clawpaw Android Control?