CLI 命令
设置
openclaw setup
初始化基线配置和 Agent 工作区。只要存在任何新手引导标志，也会运行向导。
选项
| 标志 | 描述 |
|---|---|
--workspace <dir> |
Agent 工作区目录（默认 ~/.openclaw/workspace；存储为 agents.defaults.workspace）。 |
--wizard |
运行交互式新手引导。 |
--non-interactive |
在没有提示的情况下运行新手引导。 |
--mode <mode> |
新手引导模式：local 或 remote。 |
--import-from <provider> |
新手引导期间要运行的迁移提供商。 |
--import-source <path> |
--import-from 的源 Agent 主目录。 |
--import-secrets |
在新手引导迁移期间导入支持的密钥。 |
--remote-url <url> |
远程 Gateway 网关 WebSocket URL。 |
--remote-token <token> |
远程 Gateway 网关令牌（可选）。 |
向导自动触发
即使没有 --wizard，当显式提供以下任意标志时，openclaw setup 也会运行向导：
--wizard、--non-interactive、--mode、--import-from、--import-source、--import-secrets、--remote-url、--remote-token。
示例
openclaw setupopenclaw setup --workspace ~/.openclaw/workspaceopenclaw setup --wizardopenclaw setup --wizard --import-from hermes --import-source ~/.hermesopenclaw setup --non-interactive --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>说明
- 普通的
openclaw setup会初始化配置和工作区，而不运行完整的新手引导流程。 - 普通 setup 后，运行
openclaw onboard开始完整的引导流程，运行openclaw configure进行定向更改，或运行openclaw channels add添加渠道账户。 - 如果检测到 Hermes 状态，交互式新手引导可以自动提供迁移。导入式新手引导需要全新 setup；在新手引导之外，请使用 迁移 来进行试运行计划、备份和覆盖模式。