ClawMobile - Android Automation Toolkit

Data & APIs

ClawMobile - 完整的 Android 自动化工具包，深度集成 AutoX.js。提供工作流管理、任务录制、AI 智能干预、会员系统、HTTP API 通信等完整功能。支持自动化测试、RPA 流程自动化、移动应用交互等场景。适用场景：自动化测试、批量操作、流程录制和回放、无人值守任务、移动应用 RPA。

Install

openclaw skills install clawmobile

ClawMobile - Android Automation Toolkit 🤖

完整的企业级 Android 自动化解决方案，深度集成 AutoX.js，提供强大的工作流管理、任务录制、AI 智能干预和会员系统。

概述

ClawMobile 是一个功能强大的 Android 设备自动化工具包，通过 AutoX.js HTTP 服务器实现完整的设备控制。它将移动自动化、RPA（机器人流程自动化）和 AI 智能决策完美结合，为开发者、测试人员和 RPA 工程师提供全面的自动化解决方案。

核心价值

🎯 低代码开发：通过录制和 AI 生成快速创建自动化脚本
🤖 AI 赋能：智能异常处理和自动恢复机制
📊 可观测性：完整的日志记录和执行追踪
🔐 权限管理：三级会员体系，灵活的功能访问控制
🚀 HTTP API：标准的 RESTful API，易于集成
📦 开箱即用：完整的示例和配置，快速上手

触发条件

当用户提到以下需求时，自动触发此 Skill：

工作流相关：

"执行工作流"、"运行工作流"
"创建工作流"、"新建工作流"
"列出工作流"、"查看工作流"
"删除工作流"
"验证工作流"

录制相关：

"录制操作"、"开始录制"
"停止录制"
"录制回放"
"生成 AutoX.js 代码"

会员相关：

"激活会员"、"兑换码"
"会员状态"、"查询会员"
"VIP 激活"、"SVIP 激活"

测试和自动化：

"自动化测试"、"Android 测试"
"批量操作"、"批量执行"
"RPA"、"流程自动化"
"无人值守任务"

AI 相关：

"AI 干预"、"智能决策"
"自动处理异常"
"自动恢复"

核心功能

1. 工作流管理 📋

功能特性：

✅ 工作流 CRUD（创建、读取、更新、删除）
✅ 参数化工作流支持
✅ 定时任务调度
✅ 工作流执行和监控
✅ 工作流验证和分析
✅ 工作流导入/导出（VIP 专属）

使用场景：

自动化测试脚本执行
批量任务处理
定时任务调度
工作流模板管理
跨设备工作流共享

API 端点：

GET /workflows - 列出所有工作流
GET /workflows/{id} - 获取工作流详情
POST /workflows - 创建工作流
PUT /workflows/{id} - 更新工作流
DELETE /workflows/{id} - 删除工作流
POST /api/v1/workflows/{id}/validate - 验证工作流

2. 录制功能 ⏺️

功能特性：

✅ UI 操作录制
✅ 自动代码生成
✅ 工作流创建
✅ 录制回放
✅ 录制暂停/恢复
✅ 截图捕获
✅ UI 树捕获

使用场景：

快速创建自动化脚本
学习 AutoX.js 编程
捕获和复现用户操作
生成测试用例

API 端点：

POST /recording/start - 开始录制
POST /recording/pause - 暂停录制
POST /recording/resume - 恢复录制
POST /recording/stop - 停止录制

3. AI 干预 🤖

功能特性：

✅ 未知页面智能识别
✅ 自动决策和恢复
✅ 上下文感知执行
✅ 学习型决策优化
✅ 参数自动决策（SVIP 专属）

使用场景：

处理预期外的 UI 变化
自动错误恢复
减少人工干预
提高脚本健壮性

API 端点：

POST /intervention - 请求 AI 干预
POST /api/v1/parameters/decide - 参数自动决策
GET /api/v1/parameters/decisions/stats - 决策统计

4. 会员系统 💎

功能特性：

✅ 三级会员体系（Free/VIP/SVIP）
✅ 兑换码激活系统
✅ 功能权限控制
✅ 使用次数管理
✅ 会员历史记录

会员等级对比：

功能	Free	VIP	SVIP
每日运行次数	3	无限	无限
定时任务	❌	✅	✅
AI 干预	❌	✅	✅
导入/导出	❌	✅	✅
自然语言生成	✅	✅	✅
参数自动决策	❌	❌	✅
高级分析	❌	❌	✅

兑换码格式：C-VENDORCODE-YY-DDM-CHECKSUM（5 段格式）

API 端点：

GET /api/v1/membership/status - 获取会员状态
POST /api/v1/membership/validate - 验证兑换码
POST /api/v1/membership/check-permission - 检查权限
GET /api/v1/membership/history - 获取历史记录

5. HTTP API 客户端 🌐

功能特性：

✅ RESTful API 设计
✅ JSON 请求/响应
✅ Bearer Token 认证
✅ 错误处理和重试
✅ 连接池管理
✅ 超时控制

API 端点：

GET /api/v1/health - 健康检查
GET /status - 服务器状态
POST /execute - 执行任务
POST /check_status - 检查状态
POST /stop - 停止任务

快速开始

前置条件

1. 硬件要求

Android 设备（Android 7.0+ / API 24+）
USB 数据线（用于 ADB 连接）
开发机（Windows/Linux/macOS）

2. 软件要求

AutoX.js v6.5.5.10+ （必需）
Python 3.7+ （必需）
ADB（Android Debug Bridge）（必需）
OpenClaw Gateway（必需）

3. 网络要求

局域网连接（远程模式）或 USB 调试（本地模式）
设备和开发机网络互通（远程模式）

安装步骤

方式一：通过 ClawHub 安装（推荐）

# 安装 ClawMobile Skill
clawhub install clawmobile

# 验证安装
ls -la ~/.openclaw/skills/clawmobile/SKILL.md

# 刷新 OpenClaw
openclaw gateway restart

方式二：通过 Git Clone 安装

# 创建技能目录
mkdir -p ~/.openclaw/skills

# 克隆仓库
cd ~/.openclaw/skills
git clone https://gitee.com/your-repo/clawmobile.git clawmobile

# 验证安装
ls -la clawmobile/SKILL.md

方式三：手动安装

# 下载 Skill 包
wget https://github.com/clawmobile/clawmobile/archive/v1.0.0.zip

# 解压到技能目录
unzip v1.0.0.zip -d ~/.openclaw/skills/
mv ~/.openclaw/skills/clawmobile-1.0.0 ~/.openclaw/skills/clawmobile

基础配置

1. 启动 AutoX.js HTTP 服务器

在 Android 设备上：

打开 AutoX.js App
进入"设置" → "HTTP 服务"
启用 HTTP 服务器
配置端口（默认 8765）
设置认证 Token

2. 配置 ADB 连接

# 连接设备
adb devices

# 验证连接
adb shell getprop ro.build.version.sdk

# 转发端口（如需远程访问）
adb forward tcp:8765 tcp:8765

3. 配置 ClawMobile

方法 A：使用配置文件

cat > config/settings.yaml << 'EOF'
# API 配置
api:
  base_url: "http://localhost:8765"
  timeout: 30000
  max_retries: 3
  retry_delay: 1000

# 服务器配置
server:
  host: "0.0.0.0"
  port: 8765
  workers: 4

# 认证配置
auth:
  token_env: "CLAWMOBILE_API_TOKEN"
  default_token: "your-autox-token-here"

# 连接配置
connection:
  mode: "local"
  max_retries: 60
  test_interval: 30000
  auto_reconnect: true

# 会员配置
membership:
  default_tier: "free"
  daily_runs:
    free: 3
    vip: -1
    svip: -1

# 录制配置
recording:
  default_duration: 300
  max_duration: 3600
  capture_screenshots: true
  capture_ui_tree: true

# 日志配置
logging:
  level: "INFO"
  file: "clawmobile.log"
  max_size: "10MB"
  backup_count: 5
EOF

方法 B：使用环境变量

# 设置环境变量
export CLAWMOBILE_API_URL="http://localhost:8765"
export CLAWMOBILE_API_TOKEN="your-autox-token-here"
export CLAWMOBILE_TIMEOUT="30000"

# 或添加到 ~/.bashrc
echo 'export CLAWMOBILE_API_URL="http://localhost:8765"' >> ~/.bashrc
echo 'export CLAWMOBILE_API_TOKEN="your-autox-token-here"' >> ~/.bashrc
source ~/.bashrc

4. 验证连接

# 测试基本连接
curl http://localhost:8765/api/v1/health

# 预期响应：
# {"success": true, "health": {"status": "healthy", ...}}

# 使用 Python 客户端测试
python3 -c "
from skill.client import ClawMobileClient
client = ClawMobileClient()
health = client.get_health()
print(f'Health: {health}')
"

基本用法

使用 Python 客户端

from skill.client import ClawMobileClient

# 创建客户端
client = ClawMobileClient()

# 1. 列出工作流
workflows = client.list_workflows()
for workflow in workflows:
    print(f"{workflow['workflow_name']} - {workflow['workflow_id']}")

# 2. 执行工作流
result = client.execute_workflow(
    workflow_id="workflow_001",
    params={"keyword": "春天的风景"}
)
print(f"Task ID: {result['task_id']}")
print(f"Status: {result['status']}")

# 3. 开始录制
recording = client.start_recording(
    workflow_id="workflow_001",
    app_package="com.doubao.app",
    options={
        "capture_screenshots": True,
        "capture_ui_tree": True
    }
)
print(f"Recording ID: {recording['recording_id']}")

# 4. 检查会员状态
membership = client.get_membership_status(user_id="user_001")
print(f"Tier: {membership['tier']}")
print(f"Active: {membership['is_active']}")
print(f"Remaining Runs: {membership['today_usage']['runs_remaining']}")

使用 cURL

# 设置认证 Token
export TOKEN="your-autox-token-here"

# 健康检查
curl http://localhost:8765/api/v1/health

# 列出工作流
curl -H "Authorization: Bearer $TOKEN" \
  http://localhost:8765/workflows

# 执行工作流
curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"task_001","workflow_id":"workflow_001"}' \
  http://localhost:8765/execute

# 开始录制
curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"workflow_id":"workflow_001","app_package":"com.doubao.app"}' \
  http://localhost:8765/recording/start

API 参考

核心端点

工作流管理

GET /workflows

列出所有工作流

响应：

{
  "workflows": [
    {
      "workflow_id": "workflow_001",
      "workflow_name": "豆包视频生成+发布",
      "kernel_type": "accessibility",
      "created_at": "2026-03-29T11:00:00Z",
      "run_count": 15,
      "success_rate": 93.3
    }
  ]
}

POST /workflows

创建工作流

请求：

{
  "workflow_name": "新工作流",
  "kernel_type": "accessibility",
  "description": "工作流描述"
}

响应：

{
  "success": true,
  "workflow_id": "workflow_002",
  "created_at": "2026-03-31T12:00:00Z"
}

任务执行

POST /execute

执行工作流任务

请求：

{
  "id": "task_001",
  "type": "sequence",
  "kernel_type": "accessibility",
  "priority": "normal",
  "timeout": 30000,
  "workflow_id": "workflow_001",
  "params": {
    "keyword": "春天的风景"
  }
}

响应：

{
  "success": true,
  "result": {
    "task_id": "task_001",
    "status": "completed",
    "steps_result": [...],
    "total_duration_ms": 3200
  }
}

录制功能

POST /recording/start

开始录制

请求：

{
  "workflow_id": "workflow_001",
  "app_package": "com.doubao.app",
  "kernel_type": "accessibility",
  "options": {
    "capture_screenshots": true,
    "capture_ui_tree": true
  }
}

响应：

{
  "success": true,
  "recording_id": "rec_001",
  "started_at": "2026-03-31T12:00:00Z",
  "floating_window_enabled": true
}

会员系统

GET /api/v1/membership/status

获取会员状态

参数：

user_id（查询参数）：用户 ID

响应：

{
  "success": true,
  "membership": {
    "user_id": "user_001",
    "tier": "vip",
    "is_active": true,
    "activated_at": "2026-03-30T14:30:00Z",
    "expires_at": "2026-04-30T14:30:00Z"
  },
  "permissions": {
    "max_daily_runs": -1,
    "can_schedule": true,
    "can_use_ai_intervention": true
  },
  "today_usage": {
    "runs_completed": 2,
    "runs_remaining": -1
  }
}

POST /api/v1/membership/validate

验证兑换码

请求：

{
  "code": "C-VENDORCODE-24-01M-A1B2C3D4",
  "user_id": "user_001"
}

响应：

{
  "success": true,
  "membership": {
    "tier": "vip",
    "activated_at": "2026-03-31T12:00:00Z",
    "expires_at": "2026-04-30T12:00:00Z"
  }
}

完整 API 文档

详细的 API 文档请参考：docs/API-DOCUMENTATION.md

配置说明

环境变量

变量名	说明	默认值	必需
`CLAWMOBILE_API_URL`	API 服务器地址	http://localhost:8765	✅
`CLAWMOBILE_API_TOKEN`	API 认证 Token	-	✅
`CLAWMOBILE_TIMEOUT`	请求超时(ms)	30000	❌
`CLAWMOBILE_MAX_RETRIES`	最大重试次数	3	❌
`CLAWMOBILE_DEVICE_ID`	目标设备 ID	-	❌

配置文件

config/settings.yaml：

# API 配置
api:
  base_url: "http://localhost:8765"
  timeout: 30000
  max_retries: 3
  retry_delay: 1000

# 服务器配置
server:
  host: "0.0.0.0"
  port: 8765
  workers: 4

# 认证配置
auth:
  token_env: "CLAWMOBILE_API_TOKEN"
  default_token: "clawmobile-secret-token-change-in-production"

# 连接配置
connection:
  mode: "local"
  remote_host: null
  max_retries: 60
  test_interval: 30000
  auto_reconnect: true

# 会员配置
membership:
  default_tier: "free"
  api_url: "http://localhost:8765"
  daily_runs:
    free: 3
    vip: -1
    svip: -1

# 录制配置
recording:
  default_duration: 300
  max_duration: 3600
  capture_screenshots: true
  capture_ui_tree: true

# 日志配置
logging:
  level: "INFO"
  file: "clawmobile.log"
  max_size: "10MB"
  backup_count: 5
  format: "%(asctime)s - %(name)s - %(levelname)s - %(message)s"

使用示例

示例 1：执行工作流

场景：自动化执行豆包视频生成工作流

from skill.client import ClawMobileClient

client = ClawMobileClient()

# 执行工作流
result = client.execute_workflow(
    workflow_id="workflow_001",
    params={
        "keyword": "春天的风景",
        "duration": 45
    }
)

if result['success']:
    print("✅ 工作流执行成功")
    print(f"Task ID: {result['task_id']}")
    print(f"Status: {result['status']}")
    print(f"Duration: {result['total_duration_ms']}ms")
else:
    print(f"❌ 工作流执行失败: {result.get('error')}")

示例 2：录制操作并创建工作流

场景：录制屏幕操作并自动生成工作流

# 开始录制
recording = client.start_recording(
    workflow_id="workflow_002",
    app_package="com.doubao.app",
    options={
        "capture_screenshots": True,
        "auto_stop": False
    }
)

print(f"录制已开始，ID: {recording['recording_id']}")
print("请在设备上执行操作...")

# 等待用户操作
import time
time.sleep(60)  # 录制 60 秒

# 停止录制
result = client.stop_recording(
    recording_id=recording['recording_id']
)

print(f"录制已完成，捕获 {len(result['recording']['events'])} 个事件")

# 生成工作流
workflow = client.create_workflow_from_recording(
    recording_id=recording['recording_id'],
    workflow_name="录制的操作"
)

print(f"工作流已创建: {workflow['workflow_id']}")

示例 3：会员激活

场景：激活 VIP 会员

# 激活兑换码
result = client.activate_membership(
    code="C-VENDORCODE-24-01M-A1B2C3D4",
    user_id="user_001"
)

if result['success']:
    print("✅ 会员激活成功")
    print(f"等级: {result['membership']['tier']}")
    print(f"有效期至: {result['membership']['expires_at']}")

    # 查看权限
    membership = client.get_membership_status("user_001")
    print(f"每日运行次数: {membership['permissions']['max_daily_runs']}")
    print(f"可使用定时任务: {membership['permissions']['can_schedule']}")
    print(f"可使用 AI 干预: {membership['permissions']['can_use_ai_intervention']}")
else:
    print(f"❌ 激活失败: {result.get('error')}")

示例 4：批量执行

场景：批量执行多个工作流

workflows = [
    {"workflow_id": "workflow_001", "params": {"keyword": "春天"}},
    {"workflow_id": "workflow_002", "params": {"content": "今日分享"}},
    {"workflow_id": "workflow_003", "params": {"style": "技术"}}
]

results = []
for wf in workflows:
    try:
        result = client.execute_workflow(**wf)
        results.append({
            "workflow_id": wf['workflow_id'],
            "status": "success",
            "task_id": result['task_id']
        })
        print(f"✅ {wf['workflow_id']}: {result['status']}")
    except Exception as e:
        results.append({
            "workflow_id": wf['workflow_id'],
            "status": "failed",
            "error": str(e)
        })
        print(f"❌ {wf['workflow_id']}: {e}")

# 统计结果
success_count = sum(1 for r in results if r['status'] == 'success')
print(f"\n完成: {success_count}/{len(workflows)}")

示例 5：AI 干预

场景：启用 AI 干预模式处理未知页面

# 执行工作流时启用 AI 干预
result = client.execute_workflow(
    workflow_id="workflow_001",
    params={"keyword": "测试"},
    options={
        "enable_ai_intervention": True,
        "ai_intervention_threshold": 0.7
    }
)

# 查看 AI 决策统计
stats = client.get_ai_decision_stats()
print(f"总决策次数: {stats['total_decisions']}")
print(f"成功率: {stats['success_rate']}%")
print(f"平均响应时间: {stats['avg_response_time']}ms")

故障排除

常见问题

问题 1：连接失败

症状：

ConnectionError: Failed to connect to API server

解决方案：

检查 AutoX.js 是否运行：
```
adb shell ps | grep autojs
```
检查服务器端口：
```
adb shell netstat -an | grep 8765
```

验证连接：

curl http://localhost:8765/api/v1/health

检查 ADB 连接：
```
adb devices
```
重启 AutoX.js HTTP 服务器

问题 2：权限不足

症状：

PermissionError: Feature requires VIP membership

解决方案：

检查当前会员等级：

membership = client.get_membership_status("user_001")
print(f"Current tier: {membership['tier']}")

激活会员或升级：

result = client.activate_membership("VIP-2024-ABCD1234")

检查权限：

permission = client.check_permission("user_001", "can_use_ai_intervention")
print(f"Permission granted: {permission['granted']}")

问题 3：工作流执行失败

症状：

WorkflowExecutionError: Task execution failed

诊断步骤：

查看详细错误信息：

result = client.execute_workflow(
    workflow_id="workflow_001",
    debug=True
)
print(result.get('error'))

检查工作流状态：

workflow = client.get_workflow("workflow_001")
print(f"Status: {workflow['status']}")
print(f"Success Rate: {workflow['success_rate']}%")

验证参数配置：

validation = client.validate_workflow("workflow_001")
print(f"Valid: {validation['is_valid']}")
print(f"Errors: {validation.get('errors', [])}")

查看日志：
```
tail -f clawmobile.log
```

问题 4：兑换码验证失败

症状：

InvalidCodeError: Redeem code format invalid or expired

解决方案：

验证兑换码格式：

# 正确格式：C-VENDORCODE-24-01M-A1B2C3D4
# 5 段：类型-供应商-年份-时长-校验和
from skill.membership import validate_redeem_code_format
is_valid = validate_redeem_code_format("C-VENDORCODE-24-01M-A1B2C3D4")
print(f"Format valid: {is_valid}")

检查兑换码是否已使用：

result = client.validate_redeem_code("C-VENDORCODE-24-01M-A1B2C3D4", "user_001")
print(f"Already used: {result.get('already_used', False)}")

联系管理员获取新的兑换码

支持和帮助

获取帮助：

# 查看文档
cat clawmobile/docs/API-DOCUMENTATION.md
cat clawmobile/README.md

# 查看日志
cat clawmobile/clawmobile.log

# 运行测试
cd clawmobile
python3 -m pytest tests/

联系支持：

Email: support@clawmobile.com
GitHub Issues: https://github.com/clawmobile/clawmobile/issues
文档: https://docs.clawmobile.com

附录

A. 相关文档

API-DOCUMENTATION.md - 完整 API 参考
DATA-MODELS.md - 数据模型定义
PRD.md - 产品需求文档
TRD.md - 技术需求文档
MEMBERSHIP-SYSTEM-GUIDE.md - 会员系统指南
REDEEM-CODE-FORMAT.md - 兑换码格式说明

B. 工具和资源

ClawHub CLI

安装：npm install -g clawhub
文档：clawhub --help
网站：https://clawhub.ai

OpenClaw 文档

Skills 指南：/usr/lib/node_modules/openclaw/docs/creating-skills.md
ClawHub 指南：/usr/lib/node_modules/openclaw/docs/tools/clawhub.md

AutoX.js 资源

官方文档：https://autoxjs.com/
GitHub：https://github.com/TonyJiangWJ/AutoX.js

C. 版本历史

版本	日期	变更内容
1.0.0	2026-03-31	初始版本：完整的 ClawMobile Skill

D. 贡献指南

欢迎贡献！请遵循以下步骤：

Fork 本仓库
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
开启 Pull Request

E. 许可证

MIT License - 详见 LICENSE 文件

总结

ClawMobile 是一个功能完整、生产就绪的 Android 自动化 Skill。通过本 SKILL.md，您应该能够：

✅ 理解 ClawMobile 的核心功能和使用场景
✅ 快速安装和配置 ClawMobile Skill
✅ 使用 Python 客户端或 HTTP API 与 AutoX.js 交互
✅ 管理工作流、录制操作、激活会员
✅ 排查常见问题

下一步：

阅读详细的 API 文档：docs/API-DOCUMENTATION.md
查看更多示例：docs/examples/
加入社区讨论：https://github.com/clawmobile/clawmobile/discussions

ClawMobile SKILL.md v1.0.0 | Last Updated: 2026-03-31 | Status: Production Ready

ClawMobile - Android Automation Toolkit

Install

ClawMobile - Android Automation Toolkit 🤖

概述

核心价值

触发条件

核心功能

1. 工作流管理 📋

2. 录制功能 ⏺️

3. AI 干预 🤖

4. 会员系统 💎

5. HTTP API 客户端 🌐

快速开始

前置条件

1. 硬件要求

2. 软件要求

3. 网络要求

安装步骤

方式一：通过 ClawHub 安装（推荐）

方式二：通过 Git Clone 安装

方式三：手动安装

基础配置

1. 启动 AutoX.js HTTP 服务器

2. 配置 ADB 连接

3. 配置 ClawMobile

4. 验证连接

基本用法

使用 Python 客户端

使用 cURL

API 参考

核心端点

工作流管理

GET /workflows

POST /workflows

任务执行

POST /execute

录制功能

POST /recording/start

会员系统

GET /api/v1/membership/status

POST /api/v1/membership/validate

完整 API 文档

配置说明

环境变量

配置文件

使用示例

示例 1：执行工作流

示例 2：录制操作并创建工作流

示例 3：会员激活

示例 4：批量执行

示例 5：AI 干预

故障排除

常见问题

问题 1：连接失败

问题 2：权限不足

问题 3：工作流执行失败

问题 4：兑换码验证失败

支持和帮助

附录

A. 相关文档

B. 工具和资源

ClawHub CLI

OpenClaw 文档

AutoX.js 资源

C. 版本历史

D. 贡献指南

E. 许可证

总结

Related skills