CLI 命令
设置
openclaw setup
openclaw setup 运行与 openclaw onboard 相同的引导式新手引导流程：
它首先验证并持久化推理配置，然后启动 Crestodian，以配置
工作区、Gateway 网关、渠道、Skills 和健康状态。当你只需初始化配置/工作区文件夹而不运行向导时，请使用 --baseline。
在引导模式下，--workspace <dir> 是向 Crestodian 提议的工作区；
只有在你批准该提议后才会持久化。基线、经典和
非交互式设置会通过各自的正常流程持久化所提供的工作区。
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 没有对应选项。
选项
| 标志 | 说明 |
|---|---|
--workspace <dir> |
引导模式中的工作区提议；基线、经典和非交互式设置会直接将其持久化。 |
--baseline |
不运行新手引导，创建基线配置、工作区和会话文件夹。 |
--wizard |
为兼容性而接受；设置默认运行新手引导。 |
--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 |
输出 JSON 摘要。 |
--classic 和 --non-interactive 互斥：经典模式会打开
交互式向导，而非交互式设置使用自动化路径。
基线模式
openclaw setup --baseline 保留旧版仅基线行为：它会
创建配置、工作区和会话目录，然后退出，不运行
新手引导。
示例
openclaw setupopenclaw 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 setup或openclaw onboard以体验完整的引导流程，运行openclaw configure进行针对性更改，或运行openclaw channels add添加渠道账户。 - 如果检测到 Hermes 状态，交互式新手引导可以自动提供迁移选项。导入式新手引导要求全新设置；如需在新手引导之外使用试运行计划、备份和覆盖模式，请使用迁移。
