openclaw setup /configure/onboard 三者核心区别（OpenClaw 官方定义）

一句话分层定位：

1. openclaw setup：底层初始化工具，只创建配置文件 + 工作区骨架，无完整交互向导；
2. openclaw configure：局部 / 全量配置修改器，仅改参数、不初始化环境、不装后台服务；
3. openclaw onboard：完整一站式初始化向导（新手 / 全新部署专用），包含 setup+configure + 服务安装 + 环境校验全流程。

一、openclaw setup（底层初始化，最轻量）

核心作用

只做文件系统初始化：生成 openclaw.json 空配置、创建 agent 工作目录、生成基础 bootstrap 模板文件，默认不弹出交互式问答docs.openc...。

关键特征

1. 纯文件创建，不会引导你填 API Key、网关、聊天渠道、模型；
2. 无系统守护进程安装逻辑；
3. 仅当加 --wizard 参数时，才会唤起简易配置流程；
4. 适用场景：脚本自动化部署、容器批量初始化、仅重建工作目录不修改业务参数。

典型用法

bash

运行

# 仅生成配置与工作区，无交互
openclaw setup
# 初始化 + 唤起简易向导
openclaw setup --wizard
# 指定自定义工作目录
openclaw setup --workspace D:\openclaw-agents

局限

单独执行完 setup 后配置是空的，网关无法正常运行，必须再执行 configure 补全模型、网关、通道参数。

二、openclaw configure（配置编辑器，日常修改专用）

核心作用

交互式修改已有配置，针对已初始化好的环境，增量更新各类业务参数。

关键特征

1. 只读写 openclaw.json 配置，不重建工作区、不重装 daemon、不重置身份 / 会话缓存；
2. 支持按模块局部配置，不用走完全套流程：

   bash

   运行

   # 只修改大模型相关配置
   openclaw configure --section models
   # 只修改消息渠道（飞书/微信/Discord）
   openclaw configure --section channels
   # 完整全参数交互式修改
   openclaw configure
   

3. 不会覆盖已有完整配置，仅覆盖你选择修改的模块；
4. 无系统服务安装 / 卸载逻辑；

适用场景

• 更换 LLM 厂商、更新 API Key；
• 新增 / 删除 IM 聊天通道；
• 修改 Gateway 端口、认证 Token、工具权限策略；
• 日常运维微调参数，不需要重置整套环境。

三、openclaw onboard（完整一站式初始化，全新部署首选）

核心作用

完整环境初始化流水线，内部自动包含 setup 初始化文件 + configure 全量配置 + 可选安装后台守护进程 + 健康自检。

完整执行步骤（本地模式）

1. 检测是否存在配置 / 工作区，不存在则调用 setup 创建骨架；
2. 交互式向导：选择模型厂商、录入 API Key、设置网关端口 / 鉴权；
3. 绑定各类消息通道（Telegram / 飞书 / WhatsApp 等）；
4. 可选执行 --install-daemon：注册 systemd/LaunchAgent/Windows 开机自启服务；
5. 自动安装推荐 Skills 工具集；
6. 启动网关做连通性健康校验，输出部署完成报告。

关键独有能力（setup/configure 都没有）

1. 一键安装开机自启后台服务；
2. 支持导入 Hermes 旧配置迁移（--flow import）；
3. 远程网关模式：本机客户端对接远端 OpenClaw 网关；
4. 内置 QuickStart 快速默认模板，新手零门槛；

典型用法

bash

运行

# 标准首次部署，交互式全套配置
openclaw onboard
# 全套配置 + 安装系统后台守护（最常用）
openclaw onboard --install-daemon
# 非交互脚本自动化部署
openclaw onboard --non-interactive --model glm-4
# 迁移Hermes旧配置
openclaw onboard --flow import --import-from hermes

适用场景

• 全新机器第一次安装 OpenClaw；
• 配置完全损坏，需要重置整套环境；
• 需要部署后台常驻网关、开机自启；
• 旧 Hermes 项目迁移到 OpenClaw。

四、三者横向对比总表

表格

能力项	openclaw setup	openclaw configure	openclaw onboard
创建配置 / 工作目录	✅ 核心功能	❌ 仅修改已有文件	✅ 内部自动调用 setup
交互式参数向导	默认关闭，需 --wizard	✅ 完整交互，支持分模块	✅ 全套分步向导（新手友好）
填写模型 / API 密钥	❌ 不引导	✅ 支持修改	✅ 强制引导录入
配置 IM 聊天通道	❌	✅	✅
安装系统 daemon 开机自启	❌	❌	✅ 带 --install-daemon 开启
旧项目配置迁移导入	❌	❌	✅ --flow import
健康校验网关连通性	❌	❌	✅ 收尾自动检测
日常微调参数	不适合	最优选择	过重，不推荐
全新空白机器部署	仅底层初始化，需搭配 configure	缺少文件骨架，会报错	一键全套，官方推荐

五、场景选择指南

1. 新电脑第一次装 OpenClaw 直接用：openclaw onboard --install-daemon
2. 已经部署好，只想换大模型 API Key / 改网关端口 用：openclaw configure --section models
3. 容器 / CI 脚本批量初始化，只创建目录骨架，后续脚本填参数 用：openclaw setup
4. 原有配置全部错乱，彻底重置整套环境 删除～/.openclaw 目录，再执行 openclaw onboard
5. 只想新增飞书 / 企业微信通道，其他配置不动 用：openclaw configure --section channels

六、执行流程关系

全新机器完整部署链路： openclaw onboard → 内部执行 setup 创建文件 → 启动 configure 全套向导 → 可选安装 daemon → 健康检查

日常修改链路： 已有完整环境 → openclaw configure 直接修改指定模块，不触碰文件骨架、不重装服务