ClawMobile - Android Automation Toolkit

ClawMobile - 完整的 Android 自动化工具包，深度集成 AutoX.js。提供工作流管理、任务录制、AI 智能干预、会员系统、HTTP API 通信等完整功能。支持自动化测试、RPA 流程自动化、移动应用交互等场景。适用场景：自动化测试、批量操作、流程录制和回放、无人值守任务、移动应用 RPA。
view source
installs
stars
karma
SkillRank score ↗
3.2/ 10
evaluated by implexa, claude-haiku-4-5 · 2026-05-30
clawmobile wraps android automation via autox.js with workflow management, task recording, and a three-tier membership system. the document is expansive but lacks concrete procedural steps, actionable decision trees, and failure mode analysis.
structure
4.0
trigger phrases
6.0
procedure
2.0
edge cases
2.0
documentation
4.0
strengths
SKILL.md

---
name: clawmobile
description: >
  ClawMobile - 完整的 Android 自动化工具包，深度集成 AutoX.js。
  提供工作流管理、任务录制、AI 智能干预、会员系统、HTTP API 通信等完整功能。
  支持自动化测试、RPA 流程自动化、移动应用交互等场景。
  适用场景：自动化测试、批量操作、流程录制和回放、无人值守任务、移动应用 RPA。
version: 1.0.0
author: ClawMobile Team
email: support@clawmobile.com
license: MIT
repository: https://github.com/clawmobile/clawmobile
tags: android,automation,autox,rpa,workflow,testing,recording,ai,membership,http-api
metadata:
  category: automation
  complexity: advanced
  maintenance_stability: active
  openclaw:
    requires:
      bins:
        - adb
        - python3
        - curl
      env:
        - CLAWMOBILE_API_URL
        - CLAWMOBILE_API_TOKEN
      config:
        api_url: "http://localhost:8765"
        api_timeout: 30000
        max_retries: 3
        retry_delay: 1000
        default_kernel: "accessibility"
        device_connection:
          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
    examples:
      - "执行工作流: 运行豆包视频生成工作流，参数：关键词春天风景"
      - "录制操作: 开始录制我的屏幕操作，生成 AutoX.js 代码"
      - "会员激活: 激活 VIP 会员兑换码 C-TEST1234-24-01M-A1B2C3D4"
      - "连接测试: 测试与 AutoX.js 服务器的连接状态"
      - "批量执行: 批量执行多个工作流，参数：workflows=[workflow_001,workflow_002]"
      - "AI干预: 启用 AI 干预模式，自动处理未知页面和异常"
      - "列出工作流: 查询所有可用工作流列表"
      - "会员状态: 查询当前用户的会员等级和权限"
    permissions:
      required:
        - android.permission.INTERNET
        - android.permission.ACCESS_NETWORK_STATE
        - android.permission.WRITE_EXTERNAL_STORAGE
        - android.permission.READ_PHONE_STATE
        - android.permission.ACCESS_WIFI_STATE
    api_version: "1.0"
    dependencies:
      openclaw: ">=1.0.0"
      autox: ">=6.5.5.10"
      python: ">=3.7"
    limitations:
      - 仅支持 Android 7.0+ (API 24+)
      - 需要 AutoX.js 已安装并运行 HTTP 服务器
      - 某些功能需要特定会员等级（VIP/SVIP）
      - 需要正确配置 ADB 连接
    keywords:
      - android automation
      - autox
      - rpa
      - workflow automation
      - mobile testing
      - task recording
      - ai intervention
      - membership system
      - http api
      - batch execution
---

# 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 安装（推荐）

```bash
# 安装 ClawMobile Skill
clawhub install clawmobile

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

# 刷新 OpenClaw
openclaw gateway restart
```

#### 方式二：通过 Git Clone 安装

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

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

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

#### 方式三：手动安装

```bash
# 下载 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 连接

```bash
# 连接设备
adb devices

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

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

#### 3. 配置 ClawMobile

**方法 A：使用配置文件**

```bash
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：使用环境变量**

```bash
# 设置环境变量
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. 验证连接

```bash
# 测试基本连接
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 客户端

```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

```bash
# 设置认证 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
列出所有工作流

**响应**：
```json
{
  "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
创建工作流

**请求**：
```json
{
  "workflow_name": "新工作流",
  "kernel_type": "accessibility",
  "description": "工作流描述"
}
```

**响应**：
```json
{
  "success": true,
  "workflow_id": "workflow_002",
  "created_at": "2026-03-31T12:00:00Z"
}
```

#### 任务执行

##### POST /execute
执行工作流任务

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

**响应**：
```json
{
  "success": true,
  "result": {
    "task_id": "task_001",
    "status": "completed",
    "steps_result": [...],
    "total_duration_ms": 3200
  }
}
```

#### 录制功能

##### POST /recording/start
开始录制

**请求**：
```json
{
  "workflow_id": "workflow_001",
  "app_package": "com.doubao.app",
  "kernel_type": "accessibility",
  "options": {
    "capture_screenshots": true,
    "capture_ui_tree": true
  }
}
```

**响应**：
```json
{
  "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

**响应**：
```json
{
  "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
验证兑换码

**请求**：
```json
{
  "code": "C-VENDORCODE-24-01M-A1B2C3D4",
  "user_id": "user_001"
}
```

**响应**：
```json
{
  "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**：
```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：执行工作流

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

```python
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：录制操作并创建工作流

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

```python
# 开始录制
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 会员

```python
# 激活兑换码
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：批量执行

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

```python
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 干预模式处理未知页面

```python
# 执行工作流时启用 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 是否运行：
   ```bash
   adb shell ps | grep autojs
   ```

2. 检查服务器端口：
   ```bash
   adb shell netstat -an | grep 8765
   ```

3. 验证连接：
   ```bash
   curl http://localhost:8765/api/v1/health
   ```

4. 检查 ADB 连接：
   ```bash
   adb devices
   ```

5. 重启 AutoX.js HTTP 服务器

#### 问题 2：权限不足

**症状**：
```
PermissionError: Feature requires VIP membership
```

**解决方案**：

1. 检查当前会员等级：
   ```python
   membership = client.get_membership_status("user_001")
   print(f"Current tier: {membership['tier']}")
   ```

2. 激活会员或升级：
   ```python
   result = client.activate_membership("VIP-2024-ABCD1234")
   ```

3. 检查权限：
   ```python
   permission = client.check_permission("user_001", "can_use_ai_intervention")
   print(f"Permission granted: {permission['granted']}")
   ```

#### 问题 3：工作流执行失败

**症状**：
```
WorkflowExecutionError: Task execution failed
```

**诊断步骤**：

1. 查看详细错误信息：
   ```python
   result = client.execute_workflow(
       workflow_id="workflow_001",
       debug=True
   )
   print(result.get('error'))
   ```

2. 检查工作流状态：
   ```python
   workflow = client.get_workflow("workflow_001")
   print(f"Status: {workflow['status']}")
   print(f"Success Rate: {workflow['success_rate']}%")
   ```

3. 验证参数配置：
   ```python
   validation = client.validate_workflow("workflow_001")
   print(f"Valid: {validation['is_valid']}")
   print(f"Errors: {validation.get('errors', [])}")
   ```

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

#### 问题 4：兑换码验证失败

**症状**：
```
InvalidCodeError: Redeem code format invalid or expired
```

**解决方案**：

1. 验证兑换码格式：
   ```python
   # 正确格式：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}")
   ```

2. 检查兑换码是否已使用：
   ```python
   result = client.validate_redeem_code("C-VENDORCODE-24-01M-A1B2C3D4", "user_001")
   print(f"Already used: {result.get('already_used', False)}")
   ```

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

### 支持和帮助

**获取帮助**：
```bash
# 查看文档
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. 贡献指南

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

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](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.0 | Last Updated: 2026-03-31 | Status: Production Ready*
related skills

semantically similar in the cross-vendor index
clawhub
100% match
Clawmobile Skill
don't have the plugin yet? install it then click "run inline in claude" again.