Capgo CLI 使用指南

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install capgo-cli
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 capgo-cli。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Capgo CLI 使用指南是了解和路由 Capgo 命令接口中各类请求的入口。它可帮助代理处理一般 CLI 问题、应用设置、诊断、OTA 操作、原生构建和组织命令；如果有适用的 Capgo 技能，还会将具体工作转交给相应技能。
作为 Openclaw Skills 的一部分，它还介绍如何通过托管或本地 MCP 服务器连接 Capgo。这样既能方便地获取常见指导，也能帮助用户选择合适的工具、解决身份验证问题，并落实最小权限访问原则。

应用场景

获取有关 Capgo CLI 命令或应用设置的一般指导。
处理涉及多个 Capgo 命令组或工作流不明确的请求。
doctor
probe
诊断 CLI 问题，包括在调查下游身份验证错误之前先修复登录问题。
将 OTA bundle 和 channel 相关工作路由到
capgo-release-management
。
将原生云构建请求路由到
capgo-native-builds
。
将账户和组织相关请求路由到
capgo-organization-management
。
通过可用的 MCP 服务器将代理连接到 Capgo 数据和操作。

工作原理

判断请求是一般的 Capgo CLI 问题，还是明确指定的工作流。
如果请求符合某个专门工作流，则转交处理：OTA bundle 和 channel 交给发布管理，原生云构建交给原生构建，组织或账户命令交给组织管理。
对于一般 CLI 任务，选择相关命令，例如 init、login、doctor、probe 或某个 app 命令。
如果身份验证失败，请先解决 login 问题，再排查依赖它的命令。
如果需要代理连接能力，可使用托管 MCP 执行受支持的 Capgo 操作；对于需要访问本地构建文件夹、请求原生构建或运行 doctor 的任务，则使用本地 CLI MCP。

配置指南

如有需要，请在 https://console.capgo.app 创建 Capgo 账户。来源说明提供 14 天免费试用，无需信用卡。
通过 npx 使用 CLI；当前推荐的形式为：
npx @capgo/cli@latest doctor
如需访问本地 CLI MCP，请使用以下命令启动 stdio 服务器：
npx @capgo/cli@latest mcp
如需在 Claude Code 中访问托管 MCP，请添加服务器，然后使用 /mcp 登录：
claude mcp add --transport http capgo https://api.capgo.app/mcp
托管 MCP 使用 OAuth 登录或 Authorization: Bearer 标头。由于其中包含具有破坏性的工具，请仅使用具备所需权限的 API key；用于报告时，请使用只读访问权限。MCP 文档请参阅 https://capgo.app/docs/ai/mcp/。

数据架构

此技能不定义本地数据架构，也不生成文件。它按命令和工作流组织指导：
区域 命令或路由的技能 用途
一般 CLI init、login、doctor、probe、mcp 设置、身份验证、诊断、连接
应用管理 app add、app list、app delete、app set、app debug 常见应用操作
OTA 发布 capgo-release-management bundle 和 channel
原生构建 capgo-native-builds 原生云构建工作流
账户和组织 capgo-organization-management 组织和账户命令
MCP 访问分为两种：位于 https://api.capgo.app/mcp 的托管服务器，以及通过 npx @capgo/cli@latest mcp 启动的本地 CLI 服务器。托管服务器支持应用、bundle、channel、渐进式推出、设备、统计数据、更新健康状况、原生构建状态和日志、webhook 以及推送通知。本地服务器适用于从构建文件夹上传 bundle、请求原生构建或运行 doctor。

高级特性

将范围明确的任务路由到专用 Capgo 技能，而不是停留在一般 CLI 层处理。
支持两种 MCP 连接方式：使用 OAuth 或 API key 的托管流式 HTTP，以及通过 Capgo CLI 使用本地 stdio。
为托管 MCP 提供最小权限安全建议，包括在报告场景中使用只读 API key。
区分托管 MCP 操作与需要访问构建产物或 CLI 诊断的本地任务。
包含身份验证故障排查规则：调查下游 CLI 命令故障前，先修复
login
。

name: capgo-cli-usage description: Guides the agent through the Capgo CLI command surface and routes requests to more specific Capgo skills. Use when the user asks generally about the Capgo CLI, app setup, diagnostics, OTA operations, native builds, or organization commands. Do not use when a more specific Capgo skill already clearly matches the request.

Capgo CLI Usage

Use this skill as the entry point for Capgo CLI command routing.

When to Use This Skill

User asks generally how to use the Capgo CLI

The request spans multiple Capgo command groups

The right Capgo sub-workflow is not obvious yet

Routing

Route specific workflows to the matching skill:

OTA bundles and channels -> capgo-release-management
native cloud builds -> capgo-native-builds
organizations and account commands -> capgo-organization-management
Connect the Agent to Capgo (MCP)

Capgo has two MCP servers. Use both when available.

Hosted MCP: https://api.capgo.app/mcp (streamable HTTP). Nothing to install; the client signs in with OAuth, or sends Authorization: Bearer . The hosted MCP includes destructive tools, so use an API key with the smallest role the task needs (read-only for reporting). Covers apps, bundles, channels, progressive rollouts, devices, stats, update health, native build status and logs, webhooks, and push notifications. Example for Claude Code: claude mcp add --transport http capgo https://api.capgo.app/mcp, then /mcp to sign in.
Local CLI MCP: npx @capgo/cli@latest mcp (stdio). Needed to upload a bundle from the build folder, request a native build, or run doctor.

No Capgo account yet: sign up at https://console.capgo.app (14-day free trial, no credit card). Docs: https://capgo.app/docs/ai/mcp/

Common Commands

init
login
doctor
probe
app add
app list
app delete
app set
app debug
mcp

Prefer the current CLI form:

npx @capgo/cli@latest doctor

Error Handling

If the request is specific enough for a narrower Capgo skill, switch to that skill instead of staying at the routing layer.

For CLI auth issues, fix login first before troubleshooting downstream commands.
执行后沙箱清理

Capgo Live Updates for Capacitor