openclaw setup
openclaw setup 是系统代理的入口点。在已配置的系统上，直接运行
openclaw setup 会打开一个交互式 OpenClaw 对话。在全新系统上，它
会转入引导式 onboarding。使用 -m/--message 发起一次请求，或使用
--baseline 在不运行向导的情况下初始化配置/工作区文件夹。
路由顺序：
- 任何 onboarding 选项（
--wizard、--baseline、workspace、reset、 non-interactive、flow、mode、Gateway、daemon、skip、import、remote 或 auth 选项）都会像openclaw onboard一样运行 onboarding。 -m/--message或--yes运行系统代理。- 如果没有路由选项，已配置的交互式系统会打开 OpenClaw。全新系统会运行 onboarding。在已配置的系统上，即使没有 TTY，
--json也会打印系统概览；onboarding 选项则会保留 onboarding 的 JSON 摘要。
--workspace <dir> 是提供给 OpenClaw 的工作区；
只有在你批准该提议后，它才会被持久化。Baseline、经典模式和
非交互式 setup 会在全新安装时通过其正常流程持久化所提供的工作区。
如果现有的代理阵列会被重新映射，经典向导需要明确确认；
非交互式 setup 会保留当前的 fleet 工作区并打印警告。
引导式推理检测在 macOS 或 Linux 上的 Gateway 主机上运行。CLI
和 macOS 应用调用同一个由 Gateway 管理的检测器，该检测器会检查已配置的
模型、受支持的 CLI 登录、API 密钥环境变量，以及已安装的 Ollama 或 LM Studio
模型。本地模型不会在此自动检测过程中下载。检测到的本地运行时会在 CLI 和 API
密钥候选项之后自动进行测试；当有多个本地模型可用时，OpenClaw 会优先选择
工具调用能力最强的 instruct 系列。选定的候选项必须先完成一次真实的补全请求，
其提供商和模型配置才会被保存。
当 Pi 和 OpenCode CLI 无法作为引导式设置的可复用推理路径时，也可能会将其
报告出来以供参考。Gemini CLI 和 Antigravity 不会作为检测到的设置路径提供。
setup 接受与 openclaw onboard 相同的 onboarding 标志，包括
auth（--auth-choice、--token、provider key flags）、Gateway
（--gateway-port、--gateway-bind、--gateway-auth、--install-daemon）、
Tailscale（--tailscale）、reset（--reset、--reset-scope）、flow
（--flow quickstart|advanced|manual|import），以及 skip 标志
（--skip-channels、--skip-skills、--skip-bootstrap、--skip-search、
--skip-health、--skip-ui、--skip-hooks）。传入 --tui 可使用与 openclaw onboard --tui 相同的终端入口。
完整的标志参考和非交互式示例请参见 Onboard 和
CLI 自动化。openclaw onboard --modern 仍然是同一基于推理门控的 OpenClaw 助手的兼容入口。
openclaw setup 适用于可变配置安装。在 Nix 模式（OPENCLAW_NIX_MODE=1）下，OpenClaw 会拒绝 setup 写入，因为配置文件由 Nix 管理。请使用官方的 nix-openclaw 快速开始，或者其他 Nix 包对应的源配置。选项
--classic 和 --non-interactive 互斥：classic 会打开带提示的
向导，而非交互式设置使用自动化路径。
在交互式引导中，--remote-url 和 --remote-token 会预填远程
Gateway 步骤，并在该次运行中优先于已存储的远程值。
更改 URL 不会复用已存储的凭据，除非你同时传入令牌。
令牌仍然会被遮蔽，并使用向导所选的明文或 SecretRef
存储模式。
基础模式
openclaw setup --baseline 保留了旧的仅基础模式行为：它会
创建配置、工作区和会话目录，然后退出，不会运行引导。它接受
--workspace 和无害的输出控制选项，但会拒绝显式引导、Gateway、认证、重置或守护进程选项，
而不是静默忽略它们。如果现有配置无效，基础设置会保留它，
并提示你先运行 openclaw doctor，然后再重试。
示例
说明
- 在交互式 OpenClaw 聊天中，
configure skills、configure web search和configure gateway会运行托管式设置流程。open search wizard和open gateway wizard会将凭据输入交给带掩码的终端向导。Gateway 设置仅限本地且仅修改配置；之后请在聊天中使用restart gateway，或在终端中使用openclaw gateway restart进行重启。请参阅openclaw setup操作。 import memory会将检测到的本地记忆复制到现有的默认代理工作区，但不会导入配置、凭据或技能。请先完成入门流程；聊天会报告部分复制和复制失败的情况，而不会默认认为操作成功。- 完成基础设置后，运行
openclaw onboard以进行完整的引导式流程，运行openclaw configure进行针对性更改，或运行openclaw channels add添加频道账户。 - 如果检测到 Hermes 状态，交互式入门流程可以自动提供迁移选项。导入入门要求全新设置；如需在入门流程之外执行试运行计划、备份和覆盖模式，请使用迁移。