跳转到内容
OpenClaw Docs

Setup

openclaw setup

Section titled “openclaw setup”

初始化基准配置和代理工作区。如果存在任何新手引导标志，也会运行向导。

选项

Section titled “选项”
标志描述
--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(网关) 令牌（可选）。

向导自动触发

Section titled “向导自动触发”

只要明确存在以下任一标志，即使没有 --wizard，openclaw setup 也会运行向导：

--wizard、--non-interactive、--mode、--import-from、--import-source、--import-secrets、--remote-url、--remote-token。

示例

Section titled “示例”
Terminal window
openclaw setup
openclaw setup --workspace ~/.openclaw/workspace
openclaw setup --wizard
openclaw setup --wizard --import-from hermes --import-source ~/.hermes
openclaw setup --non-interactive --mode remote --remote-url wss://gateway-host:18789 --remote-token <token>

注

Section titled “注”
  • 普通的 openclaw setup 会初始化配置和工作区，而不运行完整的新手引导流程。
  • 在普通设置后，运行 openclaw onboard 以进入完整的引导流程，运行 openclaw configure 进行针对性更改，或运行 openclaw channels add 添加渠道账户。
  • 如果检测到 Hermes 状态，交互式新手引导可以自动提供迁移。导入新手引导需要全新的设置；在新手引导之外，请使用 Migrate 进行试运行计划、备份和覆盖模式。

相关

Section titled “相关”