Skip to content
📖 速查手册第 1 / 1 节

CLI 命令与配置速查 ​

openclaw 是唯一的 CLI 入口。你已按前置页装好 OpenClaw,日常高频用到的命令其实不超过十个:先把下面两张表过一遍,之后遇到具体任务再回来查这份 OpenClaw 命令大全。本页事实基于 2026.10.9 版本。

命令速查表 ​

先看官方 CLI 索引中与本页最相关的三个命令域:

命令域命令
安装与引导openclaw · setup · onboard · configure · config · completion · doctor · dashboard
重置、备份与迁移backup · database · migrate · reset · uninstall · update
消息与 agentmessage · 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)是另一套体系,见延伸阅读。

相关入口 ​

搞懂AI关于我们怎么写隐私说明

独立的第三方教程,与文中提到的任何产品及其公司没有隶属或合作关系;产品名称和商标归各自所有者。价格和政策以官方页面为准。