openclaw setup /configure/onboard 三者核心区别OpenClaw 官方定义一句话分层定位openclaw setup底层初始化工具只创建配置文件 工作区骨架无完整交互向导openclaw configure局部 / 全量配置修改器仅改参数、不初始化环境、不装后台服务openclaw onboard完整一站式初始化向导新手 / 全新部署专用包含 setupconfigure 服务安装 环境校验全流程。一、openclaw setup底层初始化最轻量核心作用只做文件系统初始化生成openclaw.json空配置、创建 agent 工作目录、生成基础 bootstrap 模板文件默认不弹出交互式问答docs.openc...。关键特征纯文件创建不会引导你填 API Key、网关、聊天渠道、模型无系统守护进程安装逻辑仅当加--wizard参数时才会唤起简易配置流程适用场景脚本自动化部署、容器批量初始化、仅重建工作目录不修改业务参数。典型用法bash运行# 仅生成配置与工作区无交互 openclaw setup # 初始化 唤起简易向导 openclaw setup --wizard # 指定自定义工作目录 openclaw setup --workspace D:\openclaw-agents局限单独执行完setup后配置是空的网关无法正常运行必须再执行configure补全模型、网关、通道参数。二、openclaw configure配置编辑器日常修改专用核心作用交互式修改已有配置针对已初始化好的环境增量更新各类业务参数。关键特征只读写openclaw.json配置不重建工作区、不重装 daemon、不重置身份 / 会话缓存支持按模块局部配置不用走完全套流程bash运行# 只修改大模型相关配置 openclaw configure --section models # 只修改消息渠道飞书/微信/Discord openclaw configure --section channels # 完整全参数交互式修改 openclaw configure不会覆盖已有完整配置仅覆盖你选择修改的模块无系统服务安装 / 卸载逻辑适用场景更换 LLM 厂商、更新 API Key新增 / 删除 IM 聊天通道修改 Gateway 端口、认证 Token、工具权限策略日常运维微调参数不需要重置整套环境。三、openclaw onboard完整一站式初始化全新部署首选核心作用完整环境初始化流水线内部自动包含setup初始化文件 configure全量配置 可选安装后台守护进程 健康自检。完整执行步骤本地模式检测是否存在配置 / 工作区不存在则调用 setup 创建骨架交互式向导选择模型厂商、录入 API Key、设置网关端口 / 鉴权绑定各类消息通道Telegram / 飞书 / WhatsApp 等可选执行--install-daemon注册 systemd/LaunchAgent/Windows 开机自启服务自动安装推荐 Skills 工具集启动网关做连通性健康校验输出部署完成报告。关键独有能力setup/configure 都没有一键安装开机自启后台服务支持导入 Hermes 旧配置迁移--flow import远程网关模式本机客户端对接远端 OpenClaw 网关内置 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 setupopenclaw configureopenclaw onboard创建配置 / 工作目录✅ 核心功能❌ 仅修改已有文件✅ 内部自动调用 setup交互式参数向导默认关闭需 --wizard✅ 完整交互支持分模块✅ 全套分步向导新手友好填写模型 / API 密钥❌ 不引导✅ 支持修改✅ 强制引导录入配置 IM 聊天通道❌✅✅安装系统 daemon 开机自启❌❌✅ 带 --install-daemon 开启旧项目配置迁移导入❌❌✅ --flow import健康校验网关连通性❌❌✅ 收尾自动检测日常微调参数不适合最优选择过重不推荐全新空白机器部署仅底层初始化需搭配 configure缺少文件骨架会报错一键全套官方推荐五、场景选择指南新电脑第一次装 OpenClaw直接用openclaw onboard --install-daemon已经部署好只想换大模型 API Key / 改网关端口用openclaw configure --section models容器 / CI 脚本批量初始化只创建目录骨架后续脚本填参数用openclaw setup原有配置全部错乱彻底重置整套环境删除/.openclaw 目录再执行openclaw onboard只想新增飞书 / 企业微信通道其他配置不动用openclaw configure --section channels六、执行流程关系全新机器完整部署链路openclaw onboard→ 内部执行 setup 创建文件 → 启动 configure 全套向导 → 可选安装 daemon → 健康检查日常修改链路 已有完整环境 →openclaw configure直接修改指定模块不触碰文件骨架、不重装服务