CLI 命令

CLI 参考

openclaw 是主要的 CLI 入口点。每个核心命令都有专门的参考页面,或与其别名对应的命令一起记录;本索引列出了适用于整个 CLI 的命令、全局标志和输出样式规则。

按用途划分的设置命令:

  • openclaw setupopenclaw 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 · capabilityinfer 的别名)· memory · commitments · wiki
网络和节点 directory · nodes · devices · node
运行时和沙箱 approvals · exec-policy(参见 approvals)· sandbox · tui · chat/terminaltui --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

命令树

完整命令树

此图涵盖核心命令及其主要子命令。插件添加的 子命令(例如 skillspluginswiki 下的子命令)会 独立演进;运行 <command> --help 可查看权威的当前列表。

Code
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 workboardopenclaw 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?
On this page

On this page