# openclaw setup

初始化 ~/.openclaw/openclaw.json 和智能体工作区。

相关：

• 入门指南：入门指南
• CLI 新手引导：新手引导（CLI）

# 示例

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>

# 选项

• --workspace <dir>：智能体工作区目录（存储为 agents.defaults.workspace）
• --wizard：运行新手引导
• --non-interactive：无需提示运行新手引导
• --mode <local|remote>：新手引导模式
• --import-from <provider>：新手引导期间要运行的迁移提供商
• --import-source <path>：用于 --import-from 的源智能体主目录
• --import-secrets：在新手引导迁移期间导入支持的密钥
• --remote-url <url>：远程 Gateway 网关 WebSocket URL
• --remote-token <token>：远程 Gateway 网关令牌

要通过 setup 运行新手引导：

openclaw setup --wizard

说明：

• 普通 openclaw setup 会初始化配置 + 工作区，但不会运行完整的新手引导流程。
• 普通 setup 后，运行 openclaw configure 来选择模型、渠道、Gateway 网关、插件、Skills 或健康检查。
• 当存在任何新手引导标志时（--wizard、--non-interactive、--mode、--import-from、--import-source、--import-secrets、--remote-url、--remote-token），新手引导会自动运行。
• 如果检测到 Hermes 状态，交互式新手引导可以自动提供迁移。导入新手引导需要全新 setup；在新手引导之外，请使用 迁移 进行 dry-run 计划、备份和覆盖模式。

# 相关

• CLI 参考
• 安装概览