openclaw setup
openclaw setup 运行与 openclaw onboard 相同的引导式新手引导流程（身份验证、工作区、Gateway 网关、渠道、Skills、健康）。当你只需要初始化配置/工作区文件夹而不使用向导时，请使用 --baseline。
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）。完整标志参考和非交互式示例请参阅 引导设置 和 CLI 自动化；openclaw onboard --modern（Crestodian 对话式助手）没有对应的 setup 等效命令。
openclaw setup 用于可变配置安装。在 Nix 模式（OPENCLAW_NIX_MODE=1）下，OpenClaw 会拒绝 setup 写入，因为配置文件由 Nix 管理。请使用第一方 nix-openclaw 快速开始，或为其他 Nix 包使用等效的源配置。选项
| 标志 | 描述 |
|---|---|
--workspace <dir> | Agent 工作区目录（默认 ~/.openclaw/workspace；存储为 agents.defaults.workspace）。 |
--baseline | 创建基线配置/工作区/会话文件夹，不运行新手引导。 |
--wizard | 为兼容性而接受；setup 默认运行新手引导。 |
--non-interactive | 在无提示的情况下运行新手引导。 |
--accept-risk | 确认全系统 Agent 访问风险；与 --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 的源 Agent 主目录。 |
--import-secrets | 在新手引导迁移期间导入受支持的密钥。 |
--remote-url <url> | 远程 Gateway 网关 WebSocket URL。 |
--remote-token <token> | 远程 Gateway 网关令牌（可选）。 |
--json | 输出 JSON 摘要。 |
基线模式
openclaw setup --baseline 保留较旧的仅基线行为：它会创建配置、工作区和会话目录，然后退出而不运行新手引导。
示例
说明
- 基线设置后，运行
openclaw setup或openclaw onboard进入完整的引导式流程，运行openclaw configure进行针对性更改，或运行openclaw channels add添加渠道账号。 - 如果检测到 Hermes 状态，交互式新手引导可以自动提供迁移。导入新手引导需要全新设置；如需在新手引导之外进行试运行计划、备份和覆盖模式，请使用 迁移。