当前位置： 首页 > news >正文

OpenClaw04_基础设置VS向导流程

news 2026/5/11 18:31:40

OpenClaw04_基础设置VS向导流程

针对中文版本openClaw进行源码阅读，当前项目针对openClaw安装中的源码进行安装模式分析

文章目录

  • OpenClaw04_基础设置VS向导流程
  • 1-参考地址
  • 2-知识整理
  • 3-setup 命令与 onboard 命令对比
    • 概述
    • setup 命令详解
      • 功能定位
      • 命令参数
      • 执行逻辑
      • 适用场景
    • onboard 命令详解
      • 功能定位
      • 命令参数
        • 基础选项
        • 认证选项
        • 网关配置选项
        • Tailscale 选项
        • 守护进程选项
        • 流程控制选项
      • 适用场景
    • 关系与区别
      • 命令关系
      • 功能对比
      • 使用建议
    • 示例
      • setup 命令示例
      • onboard 命令示例
    • 相关文档

1-参考地址

  • github版本OpenClawCN
  • gitee版本OpenClawCN
  • mac进行openclaw卸载参考
  • openClaw源码拆解系列

2-知识整理

  • 1）setupCommand (基础设置)
  • 2）onboardCommand (完整向导流程)

3-setup 命令与 onboard 命令对比

本文档说明register.setup.ts和register.onboard.ts两个注册模块的功能区别。

概述

特性setup 命令onboard 命令
主要用途初始化基础配置和工作区交互式向导，完整配置系统
命令名称openclaw setupopenclaw onboard
交互性非交互式为主交互式向导
配置范围基础配置文件和工作区网关、认证、网络、技能等全流程

setup 命令详解

文件位置:src/cli/program/register.setup.ts

功能定位

setup 命令是系统的基础初始化工具，负责：

  1. 初始化配置文件: 创建~/.openclaw/openclaw.json
  2. 设置工作区: 初始化智能体工作区目录
  3. 可选向导模式: 支持通过--wizard参数触发完整的入驻向导

命令参数

openclaw setup[options]
参数说明
--workspace <dir>指定智能体工作区目录（默认：~/clawd）
--wizard启用交互式引导向导模式
--non-interactive静默模式运行向导
--mode <mode>工作模式：local/remote
--remote-url <url>远程网关 WebSocket 地址
--remote-token <token>远程网关身份验证令牌

执行逻辑

用户执行 setup 命令 ↓ 检查是否指定 --wizard 或相关选项 ↓ ┌─────────────┬────────────────┐ │ 是 (向导模式) │ 否 (标准模式) │ ├─────────────┼────────────────┤ │ 调用 onboardCommand │ 调用 setupCommand │ │ (完整入驻流程) │ (基础环境设置) │ └─────────────┴────────────────┘

适用场景

  • 首次安装: 快速初始化基础配置
  • 工作区迁移: 更改工作区目录位置
  • 配置重置: 重新初始化配置文件
  • 向导入口: 通过--wizard进入完整配置流程

onboard 命令详解

文件位置:src/cli/program/register.onboard.ts

功能定位

onboard 命令是系统的完整入驻向导，提供交互式配置体验，涵盖：

  1. 工作区配置: 设置 Agent 工作区目录
  2. 认证设置: 配置 AI 服务商密钥（支持多种服务商）
  3. 网关配置: 网络端口、绑定模式、认证方式
  4. 网络隧道: Tailscale 集成配置
  5. 守护进程: 网关服务安装与运行时选择
  6. 组件管理: 频道、技能、健康检查等

命令参数

openclaw onboard[options]
基础选项
参数说明
--workspace <dir>Agent 工作区目录
--reset重置配置、凭证、会话及工作区
--non-interactive静默模式运行
--accept-risk确认已知悉风险（非交互模式必需）
--flow <flow>向导流程：quickstart/advanced/manual
--mode <mode>连接模式：local/remote
认证选项
参数说明
--auth-choice <choice>认证方式选择（token/多种 API Key）
--anthropic-api-key <key>Anthropic API 密钥
--openai-api-key <key>OpenAI API 密钥
--moonshot-api-key <key>Moonshot API 密钥
--gemini-api-key <key>Gemini API 密钥
--minimax-api-key <key>MiniMax API 密钥
…（支持 10+ 种 AI 服务商）
网关配置选项
参数说明
--gateway-port <port>网关监听端口
--gateway-bind <mode>绑定模式：loopback/tailnet/lan/auto/custom
--gateway-auth <mode>认证模式：token/password
--gateway-token <token>网关 Token
--gateway-password <password>网关密码
Tailscale 选项
参数说明
--tailscale <mode>Tailscale 模式：off/serve/funnel
--tailscale-reset-on-exit退出时重置状态
守护进程选项
参数说明
--install-daemon安装网关服务
--no-install-daemon跳过网关服务安装
--skip-daemon跳过网关服务安装
--daemon-runtime <runtime>运行时：node/bun
流程控制选项
参数说明
--skip-channels跳过频道设置
--skip-skills跳过技能设置
--skip-health跳过健康检查
--skip-ui跳过控制面板 UI 交互
--node-manager <name>节点管理器：npm/pnpm/bun
--json输出 JSON 格式摘要

适用场景

  • 首次部署: 完整的系统初始化和配置
  • 高级配置: 需要详细配置网关、认证、网络等
  • 非交互部署: 通过参数实现自动化部署
  • 组件管理: 精确控制哪些组件需要安装配置

关系与区别

命令关系

┌─────────────────────────────────────────────────────┐ │ setup 命令 │ │ (基础初始化入口) │ └───────────────────┬─────────────────────────────────┘ │ ┌───────────┴───────────┐ │ │ 标准 mode Wizard mode │ │ ▼ ▼ ┌───────────────┐ ┌─────────────────────┐ │ setupCommand │ │ onboardCommand │ │ (基础设置) │ │ (完整向导流程) │ └───────────────┘ └─────────────────────┘ │ ▼ ┌─────────────────┐ │ onboard 命令 │ │ (直接调用) │ └─────────────────┘

功能对比

维度setuponboard
命令层级上层入口专项命令
配置深度基础深度
参数数量6 个40+ 个
交互性低高
灵活性中等高
学习曲线简单较复杂

使用建议

  1. 新手用户: 从openclaw onboard开始，使用交互式向导
  2. 快速开始: 使用openclaw setup --wizard进入向导
  3. 仅初始化配置: 使用openclaw setup（不带向导参数）
  4. 自动化部署: 使用openclaw onboard --non-interactive配合参数
  5. 高级定制: 使用openclaw onboard的详细参数进行精确配置

示例

setup 命令示例

# 基础初始化openclaw setup# 指定工作区目录openclaw setup--workspace~/my-workspace# 启动向导模式openclaw setup--wizard# 远程网关模式openclaw setup--moderemote --remote-url ws://example.com

onboard 命令示例

# 交互式向导openclaw onboard# 快速开始模式openclaw onboard--flowquickstart# 非交互模式配置openclaw onboard --non-interactive --accept-risk\--anthropic-api-key sk-ant-xxx\--gateway-port18789\--gateway-bind loopback# 跳过某些步骤openclaw onboard --skip-channels --skip-skills# 完整自动化部署openclaw onboard --non-interactive --accept-risk\--workspace~/clawd\--auth-choice anthropic-api-key\--anthropic-api-key sk-ant-xxx\--gateway-port18789\--gateway-bind loopback\--gateway-auth token\--gateway-token my-token\--install-daemon\--daemon-runtime bun\--tailscaleserve\--skip-ui

相关文档

  • setup 命令文档
  • onboard 命令文档
  • 配置文件参考
  • 网关配置指南
http://www.jsqmd.com/news/503487/

相关文章：

  • 网页富文本编辑器CKEditor如何处理Word文档中的表格粘贴？
  • 万象熔炉效果实测：1536x768超宽屏动漫海报生成能力验证
  • OpenClaw05_回声机制
  • Qwen3-VL-8B GPU利用率提升：从45%→89%的vLLM参数调优全过程
  • 告别磁盘爆满！用LVM动态扩展Docker存储空间的完整指南（/dev/sdb1案例）
  • SiameseUIE GPU加速部署教程：显存优化+Web服务自启，生产环境稳定运行指南
  • 如何手动下载并安装特定版本的transformers库（以v4.49.0-Gemma-3为例）
  • 拥抱未来：Kotlin Multiplatform 与鸿蒙应用开发深度解析与实践指南
  • WIFI国家码修改背后的秘密：高通平台Regulatory_BDF工具深度解析
  • 3个步骤教你用HomeKit集成实现智能家居控制
  • xManager实战指南：构建无广告音乐流媒体应用管理器的完整方案
  • charting_library_master.zip V31 下载
  • 单片机中断实战：用STM32 HAL库实现UART中断接收数据（附避坑指南）
  • 清华大学Timer模型实战：从数据清洗到预测的完整时间序列分析流程
  • Vue+ElementUI表单校验优化：精准清除校验提示的实战技巧
  • 广州高考复读学校避坑指南 - 妙妙水侠
  • 广州高考复读学校哪家正规？5大核心维度+10所正规院校深度解析 - 妙妙水侠
  • 可视化开发与网站构建：零基础建站者的响应式设计指南
  • NVMe SSD扇区大小与DMASM兼容性问题：read error in os_file_read_by_offset解析
  • P1546 [USACO3.1] 最短网络 Agri-Net
  • 微信版“小龙虾” QClaw 上线，Agent 正在从能力竞争走向入口竞争
  • 性能基准测试案例：系统容量规划的科学实践
  • Keil5开发环境模拟调用丹青识画系统API：嵌入式AI应用前瞻性实验
  • AI大模型训推一体机原生大模型解决方案：AI大模型训推一体机、应用场景与客户价值、典型案例
  • PX4飞控+NOKOV动捕系统实战：从零搭建无人机室内定位（附VRPN配置详解）
  • 2026年河北水利闸门启闭机标杆厂家最新推荐：机闸一体闸门、钢制闸门、平面闸门、拱形闸门、平板闸门、渠道闸门、河道闸门、新河县铄洋水利机械厂，水利工程设备新标杆 - 海棠依旧大
  • AI 辅助开发实战：基于思科毕业设计的网络配置自动化方案
  • python 通过操作鼠标定位来操作Windows软件模拟人工操作
  • 如何从零开始打造你的Stack-Chan？解锁JavaScript驱动机器人的创意无限指南
  • ESP32 OTA更新实战：PlatformIO+Arduino框架下的5分钟快速配置指南