OpenSkillIndex← back to search
claude-code

clawpaw-android-control

install
source · Clone the upstream repo
git clone https://github.com/klscool/clawpaw-android-control
Claude Code · Install into ~/.claude/skills/
git clone --depth=1 https://github.com/klscool/clawpaw-android-control ~/.claude/skills/klscool-clawpaw-android-control-clawpaw-android-control
manifest: SKILL.md
source content

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，有参数验证和统一返回格式：

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=仅闹钟）

⚠️ 注意事项

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

类别权限数说明
基础权限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