Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
openclaw setup
初始化基线配置和 Agent 工作区。只要存在任何新手引导标志，也会运行向导。
openclaw setup 用于可变配置安装。在 Nix 模式（OPENCLAW_NIX_MODE=1）下，OpenClaw 会拒绝 setup 写入，因为配置文件由 Nix 管理。请使用第一方 nix-openclaw 快速开始，或为另一个 Nix 包使用等效的源配置。选项
| 标志 | 描述 |
|---|---|
--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 setup会初始化配置和工作区，而不运行完整的新手引导流程。 - 普通 setup 后，运行
openclaw onboard开始完整的引导流程，运行openclaw configure进行定向更改，或运行openclaw channels add添加渠道账户。 - 如果检测到 Hermes 状态，交互式新手引导可以自动提供迁移。导入式新手引导需要全新 setup；在新手引导之外，请使用 迁移 来进行试运行计划、备份和覆盖模式。