clawmobile-skill（爪子移动技能）

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）
• ✅ 兑换码激活系统
• ✅ 功能权限控制
• ✅ 使用次数管理
• ✅ 会员历史记录

会员等级对比：

兑换码格式：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 设备上：

1. 打开 AutoX.js App
2. 进入"设置" → "HTTP 服务"
3. 启用 HTTP 服务器
4. 配置端口（默认 8765）
5. 设置认证 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

配置说明

环境变量

配置文件

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"\
完成: {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

解决方案：

1. 检查 AutoX.js 是否运行：

   adb shell ps | grep autojs

1. 检查服务器端口：

   adb shell netstat -an | grep 8765

1. 验证连接：

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

1. 检查 ADB 连接：

   adb devices

1. 重启 AutoX.js HTTP 服务器

问题 2：权限不足

症状：

PermissionError: Feature requires VIP membership

解决方案：

1. 检查当前会员等级：

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

1. 激活会员或升级：

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

1. 检查权限：

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

问题 3：工作流执行失败

症状：

WorkflowExecutionError: Task execution failed

诊断步骤：

1. 查看详细错误信息：

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

1. 检查工作流状态：

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

1. 验证参数配置：

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

1. 查看日志：

   tail -f clawmobile.log

问题 4：兑换码验证失败

症状：

InvalidCodeError: Redeem code format invalid or expired

解决方案：

1. 验证兑换码格式：

   # 正确格式：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}")

1. 检查兑换码是否已使用：

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

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

支持和帮助

获取帮助：

# 查看文档
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. 版本历史

D. 贡献指南

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

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

E. 许可证

MIT License - 详见 LICENSE 文件

总结

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

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

下一步：

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

*ClawMobile SKILL.md v1.0.1 | Last Updated: 2026-04-02 | Status: Production Ready*