mobile

移动端

用途

此技能可帮助 OpenClaw 开发移动应用，评估原生（例如 iOS 的 Swift、Android 的 Kotlin）与跨平台（例如 React Native、Flutter）方案，确保符合应用商店指南（例如 Apple App Store 审核指南、Google Play 政策），并应用移动端 UX 原则，例如触控友好的设计和响应式布局。

何时使用

在启动新的移动项目、重构现有应用或针对平台进行优化时使用此技能；例如，在性能至关重要的应用中选择原生方案，或为加快开发速度选择跨平台方案。在设计阶段进行 UX 审核或准备应用提交时使用此技能，以避免被拒。

主要功能

• 分析原生与跨平台方案的权衡：使用应用体积和启动速度等指标比较构建时间、维护成本和性能。
• 根据应用商店指南进行验证：通过自动扫描检查数据隐私合规性（例如是否符合 GDPR）或应用内购买规则等问题。
• 落实移动端 UX 原则：针对布局生成建议，例如确保 iOS 按钮尺寸大于 44x44 像素，或为 Android 使用 Material Design 组件。
• 生成代码：输出特定平台功能的代码片段，例如在 Android Manifest 中处理权限或编写 SwiftUI 视图。
• 与工具集成：查询外部 API 获取实时指南更新，例如通过非官方抓取工具获取 Apple 指南（不建议用于生产环境）。

使用模式

通过 OpenClaw 的 CLI 或 API 调用此技能，在命令前加上技能 ID，例如 openclaw mobile [subcommand]。务必传入平台和项目类型等必需参数。进行决策时，使用交互模式，根据用户反馈细化输入。例如，可将输出传递给其他技能以串联使用，例如与“testing”技能结合执行自动化 UX 测试。对于异步操作，请检查响应状态码。

常用命令/API

使用 OpenClaw CLI 执行快速任务，或使用 REST API 进行编程访问。身份验证需要将 $OPENCLAW_API_KEY 设置为环境变量。

• CLI 命令：openclaw mobile decide --platform ios --type native-vs-cross --factors performance,cost

  • 输出：包含优缺点的 JSON，例如：{"native": "性能更快但成本更高", "cross": "代码库共享但 UI 可能不一致"}。
  • 代码片段：

    response = subprocess.run(['openclaw', 'mobile', 'decide', '--platform', 'android', '--type', 'cross'], capture_output=True)
    print(response.stdout.decode())
    

• CLI 命令：openclaw mobile validate --app-path /path/to/app --store apple

  • 标志：--store（apple/google）用于检查指南；--app-path 用于分析本地文件。
  • 代码片段：

    import os
    os.system('openclaw mobile validate --app-path ./myapp --store google')
    # 检查广告合规等政策，并在通过时返回退出码 0
    

• API 端点：POST /api/v1/skills/mobile/decide

  • 请求体：JSON，例如 {"platform": "ios", "type": "ux-principles", "query": "button sizing"}
  • 响应：200 OK，包含数据，例如：{"recommendation": "按钮使用 .frame(width: 50, height: 50)"}。
  • 代码片段：

    import requests
    headers = {'Authorization': f'Bearer {os.environ.get("OPENCLAW_API_KEY")}'}
    response = requests.post('https://api.openclaw.ai/api/v1/skills/mobile/decide', json={"platform": "android"}, headers=headers)
    print(response.json()['advice'])
    

• 配置格式：使用 YAML 创建自定义配置，例如：

  mobile:
    defaultPlatform: android
    uxRules:
      minButtonSize: 48
  

  通过以下命令加载：openclaw mobile config --file path/to/config.yaml。

集成说明

通过在构建脚本或 IDE 扩展中封装 OpenClaw 调用来进行集成。例如，在 CI/CD 流水线中，于部署前添加类似 openclaw mobile validate 的步骤。如果使用 VS Code，请安装 OpenClaw 扩展并绑定键盘快捷键。对于 API 集成，请通过密钥管理安全地设置 $OPENCLAW_API_KEY。通过缓存响应来处理速率限制；OpenClaw 限制为每分钟 100 个请求，因此请实现带指数退避的重试逻辑。

错误处理

常见错误包括：如果 $OPENCLAW_API_KEY 缺失或无效，会出现身份验证失败（HTTP 401）——请通过验证环境变量并重新生成密钥来修复。对于无效输入（例如不受支持的平台），会返回包含详细信息的 HTTP 400；请解析错误 JSON 并提示用户更正。平台特定问题（例如不符合 iOS 指南）会返回结构化错误，例如 {"code": "APP_STORE_101", "message": "Privacy policy missing"}——请在脚本中使用 try-except 代码块：

try:
    result = requests.post(url, headers=headers)
    result.raise_for_status()
except requests.exceptions.HTTPError as e:
    print(f"Error: {e.response.json()['message']}. Retrying...")

请始终记录带时间戳的错误以便调试，并在 API 停机时回退到默认行为。

图关系

• 相关： "ios" 技能（iOS 特定实现的子节点）
• 相关： "android" 技能（Android 优化的兄弟节点）
• 通过以下内容关联： "ux-design" 集群（共享 UX 原则的父节点）
• 链接至：用于指南参考的外部资源 "app-store"