CLI 命令与配置速查
openclaw 是唯一的 CLI 入口。你已按前置页装好 OpenClaw,日常高频用到的命令其实不超过十个:先把下面两张表过一遍,之后遇到具体任务再回来查这份 OpenClaw 命令大全。本页事实基于 2026.10.9 版本。
命令速查表
先看官方 CLI 索引中与本页最相关的三个命令域:
| 命令域 | 命令 |
|---|---|
| 安装与引导 | openclaw · setup · onboard · configure · config · completion · doctor · dashboard |
| 重置、备份与迁移 | backup · database · migrate · reset · uninstall · update |
| 消息与 agent | message · agent · agents · templates · attach · acp · mcp |
再按「你想做什么」选命令:
| 你的意图 | 命令与说明 |
|---|---|
| 不安装先试用 | npx openclaw@latest |
| 完整引导初始化 | openclaw setup 或 openclaw onboard:先验证推理可用,再启动 Gateway、工作区、渠道、技能与健康设置 |
| 跳过引导,只要基线 | openclaw setup --baseline:只创建基线配置和工作区,不走进引导流程 |
| 改已有配置的一部分 | openclaw configure:定向修改模型认证、Gateway、渠道、插件或技能 |
| 基线就绪后加渠道 | openclaw channels add:只选渠道走引导;带账号、凭据或渠道配置参数则走直配路径,适合写脚本 |
注意 setup/onboard 会把推理验证放在第一步,避免你配完渠道才发现模型不可用。
配置速查
update.checkOnStart: false:关闭启动时的每日版本检查。默认开启;匿名统计需自行 opt-in,不会默认上报。- 个人助手与团队部署是否共用同一个 Gateway(区别只在配置),信息源中尚未找到依据,待补充。
- Gateway 配置参考的完整键位清单(对应 docs/gateway/configuration-reference.md)尚未采集,待补充。
示例 1:全新安装并生成基线
bash
curl -fsSL https://openclaw.ai/install.sh | bash # macOS / Linux / WSL2
openclaw setup --baseline前提:Node 24.16.0+(24.x)或 26.1.0+。缺 Node 时,安装器会在 macOS 装 Node 26、Linux 装 Node 24 LTS。Windows 用 PowerShell 安装器 iwr -useb https://openclaw.ai/install.ps1 | iex,或选 WSL2 跑 Gateway。只想快速体验的话,也可以跳过安装直接 npx openclaw@latest。
示例 2:修改配置并添加渠道
bash
openclaw configure # 定向改模型认证、Gateway、渠道、插件或技能
openclaw channels add # 交互式选渠道;脚本里可带凭据参数直配限制与注意
database没有独立参考页,文档挂在openclaw主命令页下。config与configure是两个不同命令,具体分工差异待采集。- 版本陷阱:发布为
2026.9.1-beta.1的包版本号标错,实际对应2026.8.1-beta.4,排查问题时别被它误导。 - 各命令的完整参数清单不在本页展开,以官方 CLI 参考页为准。
- 本页只覆盖 CLI;聊天内的斜杠命令(如
/model)是另一套体系,见延伸阅读。