CLI 命令
CLI 参考
openclaw 是主要的 CLI 入口点。每个核心命令都有专门的参考页面,或与其别名对应的命令一起记录;本索引列出了适用于整个 CLI 的命令、全局标志和输出样式规则。
按用途划分的设置命令:
openclaw setup和openclaw onboard会先验证推理功能,然后启动 Crestodian,以设置 Gateway 网关、工作区、渠道、Skills 和健康状态。openclaw setup --baseline会创建基线配置和工作区,而不会进入引导式新手引导流程。openclaw configure会修改现有设置中的特定部分:模型身份验证、Gateway 网关、渠道、插件或 Skills。openclaw channels add会在基线已存在后配置渠道账户;不带标志运行可进入引导式设置,带渠道专用标志运行则适用于脚本。
命令页面
| 领域 | 命令 |
|---|---|
| 设置和新手引导 | crestodian · setup · onboard · configure · config · completion · doctor · dashboard |
| 重置、备份和迁移 | backup · migrate · reset · uninstall · update |
| 消息和智能体 | message · agent · agents · attach · acp · mcp |
| 健康状态和会话 | status · health · sessions · audit |
| Gateway 网关和日志 | gateway · logs · system |
| 模型和推理 | models · promos · infer · capability(infer 的别名)· memory · commitments · wiki |
| 网络和节点 | directory · nodes · devices · node |
| 运行时和沙箱 | approvals · exec-policy(参见 approvals)· sandbox · tui · chat/terminal(tui --local 的别名)· browser |
| 自动化 | cron · tasks · hooks · webhooks · transcripts |
| 设备发现和文档 | dns · docs |
| 配对和渠道 | pairing · qr · channels |
| 安全和插件 | security · secrets · skills · plugins · proxy |
| 旧版别名 | daemon(Gateway 网关服务)· clawbot(命名空间) |
| 插件(可选) | path · policy · voicecall · workboard(如果已安装) |
全局标志
| 标志 | 用途 |
|---|---|
--dev |
将状态隔离在 ~/.openclaw-dev 下,将 Gateway 网关默认端口设为 19001,并相应调整派生端口 |
--profile <name> |
将状态隔离在 ~/.openclaw-<name> 下(OPENCLAW_STATE_DIR/OPENCLAW_CONFIG_PATH) |
--container <name> |
在名为 <name> 的运行中 Podman/Docker 容器内运行 CLI(默认值:环境变量 OPENCLAW_CONTAINER) |
--log-level <level> |
覆盖文件和控制台输出的全局日志级别 |
--no-color |
禁用 ANSI 颜色(也遵循 NO_COLOR=1) |
--update |
openclaw update 的简写;适用于源码检出和软件包安装 |
-V, --version, -v |
输出版本并退出 |
输出模式
- ANSI 颜色和进度指示器仅在 TTY 会话中呈现。
- 在支持的环境中,OSC-8 超链接会呈现为可点击链接;否则 CLI 会回退为纯 URL。
--json(以及支持时的--plain)会禁用样式,以生成整洁的输出。- 长时间运行的命令会显示进度指示器(支持时使用 OSC 9;4)。
调色板
OpenClaw 的 CLI 输出使用龙虾主题调色板:
| 令牌 | 十六进制值 | 用途 |
|---|---|---|
accent |
#FF5A2D |
标题、标签、主要突出显示 |
accentBright |
#FF7A3D |
命令名称、强调 |
accentDim |
#D14A22 |
次要突出显示文本 |
info |
#FF8A5B |
信息值 |
success |
#2FBF71 |
成功状态 |
warn |
#FFB020 |
警告、选项标志、回退 |
error |
#E23D2D |
错误、失败 |
muted |
#8B7F77 |
弱化显示、元数据 |
调色板的权威来源:packages/terminal-core/src/palette.ts。
命令树
完整命令树
此图涵盖核心命令及其主要子命令。插件添加的
子命令(例如 skills、plugins 和 wiki 下的子命令)会
独立演进;运行 <command> --help 可查看权威的当前列表。
openclaw [--dev] [--profile <name>] <command>crestodiansetuponboardconfigureconfig get set unset file schema validatecompletiondoctordashboardbackup create verifymigrate list plan <provider> apply <provider>security auditsecrets reload audit configure applyresetuninstallupdate wizard status repairchannels list status capabilities resolve logs add remove login logoutdirectory self peers list groups list|membersskills search install update verify workshop list|inspect|propose-create|propose-update|revise|apply|reject|quarantine list info checkplugins list search inspect install uninstall update enable disable doctor build validate init registry marketplace list|entries|refreshworkboard list create show dispatchmemory status index searchtranscripts list show pathpath resolve find set validate emitcommitments list dismisswiki status doctor init compile lint ingest okf import search get apply synthesis|metadata bridge import unsafe-local import chatgpt import|rollback obsidian status|search|open|command|dailymessage send broadcast poll react reactions read edit delete pin unpin pins permissions search thread create|list|reply emoji list|upload sticker send|upload role info|add|remove channel info|list member info voice status event list|create timeout kick banagentagents list add delete bindings bind unbind set-identityattachacpmcp serve list show set unsetstatushealthsessions cleanupaudittasks list audit maintenance show notify cancel flow list|show|cancelgateway call usage-cost health stability diagnostics export status probe discover install uninstall start stop restart rundaemon status install uninstall start stop restartlogssystem event heartbeat last|enable|disable presencemodels list status set set-image aliases list|add|remove fallbacks list|add|remove|clear image-fallbacks list|add|remove|clear scan auth list|add|login|setup-token|paste-token|paste-api-key|login-github-copilot auth order get|set|clearpromos list claim <slug>infer (alias: capability) list inspect model run|list|inspect|providers|auth login|logout|status image generate|edit|describe|describe-many|providers audio transcribe|providers tts convert|voices|personas|providers|status|enable|disable|set-provider|set-persona video generate|describe|providers web search|fetch|providers embedding create|providerssandbox list recreate explaincron status list get add edit rm enable disable runs runnodes status describe list pending approve reject rename invoke notify push canvas snapshot|present|hide|navigate|eval canvas a2ui push|reset camera list|snap|clip screen record location getdevices list remove clear approve reject rotate revokenode run status install uninstall stop restartapprovals get set allowlist add|removeexec-policy show preset setbrowser status start stop reset-profile tabs open focus close profiles create-profile delete-profile screenshot snapshot navigate resize click type press hover drag select upload fill dialog wait evaluate console pdfhooks list info check enable disable install updatewebhooks gmail setup|runproxy start run coverage sessions query blob purgepairing list approveqrclawbot qrdocsdns setuptuichat (alias: tui --local)terminal (alias: tui --local)插件可以添加其他顶级命令,例如
openclaw workboard 或 openclaw voicecall。
聊天斜杠命令
聊天消息支持 /... 命令。请参阅斜杠命令。
重点:
/status——快速诊断。/trace——会话范围内的插件跟踪/调试行。/config——持久化的配置更改。/debug——仅运行时的配置覆盖(存储在内存中,而非磁盘;需要commands.debug: true)。
用量跟踪
当 OAuth/API 凭据可用时,openclaw status --usage 和 Control UI 会显示提供商的用量/配额。数据直接来自提供商的用量端点,并统一为 X% left 格式。目前提供用量周期数据的提供商包括:Anthropic、Gemini CLI、GitHub Copilot、MiniMax、OpenAI Codex、Xiaomi 和 z.ai。
有关详情,请参阅用量跟踪。
相关内容
Was this useful?