CLI 命令
设置
openclaw setup
openclaw setup 是系统智能体入口点。在已配置的系统上，直接运行
openclaw setup 会打开交互式 OpenClaw 聊天。在全新系统上，它会
转入引导式新手引导。使用 -m/--message 处理单个请求，或使用
--baseline 在不使用向导的情况下初始化配置/工作区文件夹。
路由顺序：
- 任何新手引导选项（
--wizard、--baseline、工作区、重置、 非交互式、流程、模式、Gateway 网关、守护进程、跳过、导入、远程或身份验证 选项）都会以与openclaw onboard完全相同的方式运行新手引导。 -m/--message或--yes会运行系统智能体。- 未提供路由选项时，已配置的交互式系统会打开 OpenClaw。全新
系统会运行新手引导。在已配置的系统上，即使没有 TTY，
--json也会输出 系统概览；若提供了新手引导选项，则保留新手引导的 JSON 摘要。
在引导模式下，--workspace <dir> 是向 OpenClaw 提议的工作区；
只有在你批准该提议后才会持久化。对于全新安装，基线、经典和
非交互式设置会通过各自的正常流程持久化所提供的工作区。
当现有智能体清单将被重新映射时，经典向导要求明确确认；非交互式设置会保留
当前智能体群的工作区并输出警告。
引导式推理检测在 macOS 或 Linux 上的 Gateway 网关主机中运行。CLI 和 macOS 应用调用由同一 Gateway 网关所有的检测器，该检测器会检查已配置的 模型、受支持的 CLI 登录、API 密钥环境变量，以及已安装的 Ollama 或 LM Studio 模型。此自动流程绝不会下载本地模型。 在 CLI 和 API 密钥候选项之后，会自动测试检测到的本地运行时；当有多个本地模型可用时，OpenClaw 会优先选择 工具调用能力最强的指令模型系列。所选候选项必须成功返回一次 真实补全，之后才会保存其提供商和模型配置。 已安装的 Gemini、Antigravity、Pi 和 OpenCode CLI 也会被报告，即使 它们无法作为引导式设置可复用的推理路由。
setup 接受与 openclaw onboard 相同的新手引导标志，包括
身份验证（--auth-choice、--token、提供商密钥标志）、Gateway 网关
（--gateway-port、--gateway-bind、--gateway-auth、--install-daemon）、
Tailscale（--tailscale）、重置（--reset、--reset-scope）、流程
（--flow quickstart|advanced|manual|import）和跳过标志
（--skip-channels、--skip-skills、--skip-bootstrap、--skip-search、
--skip-health、--skip-ui、--skip-hooks）。传入 --tui 可使用与
openclaw onboard --tui 相同的终端入口。有关完整的标志参考和
非交互式示例，请参阅引导设置和
CLI 自动化。openclaw onboard --modern 仍作为同一
受推理能力检查约束的 OpenClaw 助手的兼容入口。
选项
| 标志 | 说明 |
|---|---|
-m, --message <text> |
运行一个 OpenClaw 请求。 |
--yes |
批准为单个 --message 请求持久写入配置。 |
--workspace <dir> |
工作区提议；现有智能体群需要在经典模式中确认，非交互模式则会予以保留。 |
--baseline |
在不运行新手引导的情况下创建基线配置/工作区/会话文件夹。 |
--wizard |
强制运行交互式新手引导。 |
--tui |
使用终端入口，而不是浏览器转交。 |
--non-interactive |
运行无提示的新手引导。 |
--accept-risk |
确认完整系统智能体访问风险；与 --non-interactive 一起使用时为必需项。 |
--mode <mode> |
新手引导模式：local 或 remote。 |
--flow <flow> |
新手引导流程：quickstart、advanced、manual 或 import。 |
--reset |
在新手引导前重置配置 + 凭据 + 会话（仅当使用 --reset-scope full 时重置工作区）。 |
--reset-scope <scope> |
重置范围：config、config+creds+sessions 或 full。 |
--import-from <provider> |
在新手引导期间运行的迁移提供商。 |
--import-source <path> |
--import-from 的源智能体主目录。 |
--import-secrets |
在新手引导迁移期间导入受支持的密钥。 |
--remote-url <url> |
远程 Gateway 网关 WebSocket URL。 |
--remote-token <token> |
远程 Gateway 网关令牌（可选）。 |
--json |
已配置的系统：OpenClaw 概览。新手引导路由：新手引导摘要。 |
--classic 和 --non-interactive 互斥：经典模式会打开
带提示的向导，而非交互式设置使用自动化路径。
在交互式新手引导中，--remote-url 和 --remote-token 会预填
远程 Gateway 网关步骤，并在该次运行中优先于已存储的远程值。
除非同时传入令牌，否则更改 URL 不会复用已存储的凭据。
令牌会保持掩码状态，并使用向导所选的明文或 SecretRef
存储模式。
基线模式
openclaw setup --baseline 保留较旧的纯基线行为：它会
创建配置、工作区和会话目录，然后退出而不
运行新手引导。它接受 --workspace 和无副作用的输出控制项，但会
拒绝显式的新手引导、Gateway 网关、身份验证、重置或守护进程选项，而不是
静默忽略它们。如果现有配置无效，基线设置会保留
该配置，并要求你在重试前运行 openclaw doctor。
示例
openclaw setupopenclaw setup -m "status"openclaw setup -m "restart gateway" --yesopenclaw setup --jsonopenclaw setup --wizardopenclaw setup --baselineopenclaw setup --workspace ~/.openclaw/workspaceopenclaw setup --import-from hermes --import-source ~/.hermesopenclaw setup --non-interactive --accept-risk --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>注意事项
- 基线设置完成后，运行
openclaw onboard以完成完整的引导流程，运行openclaw configure进行针对性更改，或运行openclaw channels add添加渠道账户。 - 如果检测到 Hermes 状态，交互式新手引导可以自动提供迁移选项。导入式新手引导要求全新设置；若要在新手引导之外使用试运行计划、备份和覆盖模式，请使用迁移。
