[智能体-627]:openclaw configure、openclaw setup、openclaw onboard都是对龙虾进行配置。
2026/7/2 2:28:57 网站建设 项目流程

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 setupopenclaw configureopenclaw 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直接修改指定模块,不触碰文件骨架、不重装服务

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询