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 助手的兼容入口。
openclaw setup 适用于配置可变的安装。在 Nix 模式（OPENCLAW_NIX_MODE=1）下，OpenClaw 会拒绝设置写入，因为配置文件由 Nix 管理。请使用第一方 nix-openclaw 快速开始，或其他 Nix 软件包的等效源配置。选项
--classic 和 --non-interactive 互斥：经典模式会打开
带提示的向导，而非交互式设置使用自动化路径。
在交互式新手引导中，--remote-url 和 --remote-token 会预填
远程 Gateway 网关步骤，并在该次运行中优先于已存储的远程值。
除非同时传入令牌，否则更改 URL 不会复用已存储的凭据。
令牌会保持掩码状态，并使用向导所选的明文或 SecretRef
存储模式。
基线模式
openclaw setup --baseline 保留较旧的纯基线行为：它会
创建配置、工作区和会话目录，然后退出而不
运行新手引导。它接受 --workspace 和无副作用的输出控制项，但会
拒绝显式的新手引导、Gateway 网关、身份验证、重置或守护进程选项，而不是
静默忽略它们。如果现有配置无效，基线设置会保留
该配置，并要求你在重试前运行 openclaw doctor。
示例
注意事项
- 基线设置完成后，运行
openclaw onboard以完成完整的引导流程，运行openclaw configure进行针对性更改，或运行openclaw channels add添加渠道账户。 - 如果检测到 Hermes 状态，交互式新手引导可以自动提供迁移选项。导入式新手引导要求全新设置；若要在新手引导之外使用试运行计划、备份和覆盖模式，请使用迁移。