OpenClaw `openclaw onboard` 命令完全指南：交互式引导配置 Gateway、工作区、认证与渠道-北京尧图网络

人工智能大模型LLM 网关AI Agent即时通讯【免费下载链接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi项目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token点击查看免费下载openclaw onboard是 OpenClaw 的交互式新手引导向导用于在本机或远程完成 Gateway 网关、工作区、模型认证、渠道Channels与 Skills 的引导式设置。读完本文你将掌握quickstart与manualadvanced两种流程的差异、完整的命令行参数表、本地与远程网关的配置原理以及如何用openclaw dashboard跳过渠道配置直接开始聊天。文中所有行为均以当前仓库 commands/onboard.ts、wizard/setup.ts 等源码为据。命令概览本地或远程 Gateway 网关设置openclaw onboard定位于交互式新手引导向导其 CLI 描述为Interactive onboarding for the gateway, workspace, and skills见 cli/program/register.onboard.ts。它覆盖四个核心设置面Gateway 网关端口、绑定地址、认证方式token / password、Tailscale 暴露方式工作区workspaceAgent 的默认工作目录默认~/.openclaw/workspace对应源码中的DEFAULT_AGENT_WORKSPACE_DIR认证auth选择模型提供方如 OpenAI、DeepSeek、Gemini、ZAI、MiniMax 等并写入 API Key渠道与 Skills引导接入聊天渠道Channels与安装 Skills并顺手完成搜索提供方、内部 hooks 的配置。命令入口为 commands/onboard.ts 中的setupWizardCommand它会先执行运行时校验再根据是否带--non-interactive分流到 commands/onboard-interactive.ts 的交互式向导或 commands/onboard-non-interactive.ts 的非交互式流程。基本用法与流程选择原文档给出的四种典型调用openclaw onboard openclaw onboard --flow quickstart openclaw onboard --flow manual openclaw onboard --mode remote --remote-url ws://gateway-host:18789流程说明quickstart最少提示自动生成 Gateway 网关令牌。向导会用默认值完成大部分配置——默认端口ws://127.0.0.1:18789见 commands/onboard-remote.ts 中的DEFAULT_GATEWAY_URL、Loopback 绑定、token 认证、Tailscale 关闭并直接进入渠道设置manual完整的端口/绑定/认证提示是advanced的别名。该别名在 commands/onboard.ts 中显式归一化const flow opts.flow manual ? advanced : opts.flow最快开始聊天openclaw dashboard打开 Control UI无需渠道设置。需要注意两个流程间存在隐式约束QuickStart 只支持本地网关。在 wizard/setup.ts 中如果mode remote且flow quickstart向导会提示 QuickStart only supports local gateways. Switching to Manual mode. 并自动切换为advanced流程。完整命令行参数参考openclaw onboard的全部选项注册在 cli/program/register.onboard.ts参数类型定义在 commands/onboard-types.ts。核心参数整理如下参数说明取值/默认值--flow flow引导流程quickstart、advanced、manualmanual是advanced别名--mode mode引导模式local、remoteQuickStart 下强制 local--workspace dirAgent 工作区目录默认~/.openclaw/workspace--reset引导前重置配置凭据会话配合--reset-scope full才重置工作区布尔--reset-scope scope重置范围config、configcredssessions默认、full--non-interactive无提示运行布尔需配合--accept-risk--accept-risk明确接受风险声明--non-interactive必需布尔--auth-choice choice认证方式选择见下文认证选择列表--token-provider idtoken 提供方 id非交互式配合--auth-choice token字符串--token tokentoken 值非交互式字符串--token-profile-id id认证 profile id非交互式默认provider:manual--token-expires-in duration可选 token 过期时长如365d、12h--secret-input-mode modeAPI Key 持久化方式plaintext默认、ref--gateway-port portGateway 端口整数--gateway-bind modeGateway 绑定loopback、tailnet、lan、auto、custom--gateway-auth modeGateway 认证token、password--gateway-token tokenGateway token字符串--gateway-token-ref-env nametoken 的 SecretRef 环境变量名如OPENCLAW_GATEWAY_TOKEN--gateway-password passwordGateway 密码字符串--remote-url url远程 Gateway WebSocket URLws://或wss://--remote-token token远程 Gateway token可选字符串--tailscale modeTailscale 暴露方式off、serve、funnel--tailscale-reset-on-exit退出时重置 Tailscale serve/funnel布尔--install-daemon/--no-install-daemon/--skip-daemon安装/跳过 Gateway 服务布尔--daemon-runtime runtimeGateway 服务运行时node、bun--skip-channels跳过渠道设置布尔--skip-skills跳过 Skills 设置布尔--skip-search跳过搜索提供方设置布尔--skip-health跳过健康检查布尔--skip-ui跳过 Control UI / TUI 提示布尔--node-manager nameSkills 安装用的 Node 包管理器npm、pnpm、bun--json输出 JSON 摘要布尔认证选择--auth-choice与 API Key 直传BuiltInAuthChoice枚举见 commands/onboard-types.ts覆盖了大量提供方包括openai-api-key、deepseek-api-key、gemini-api-key、moonshot-api-key、zai-api-key、xiaomi-api-key、minimax-global-api、openrouter-api-key、github-copilot、custom-api-key、skip等以及兼容旧版 CLI 的别名如oauth是setup-token的旧别名。除内置选择外还支持通过--custom-base-url、--custom-api-key、--custom-model-id、--custom-compatibilityopenai/anthropic接入自定义提供方。在非交互模式下可通过--deepseek-api-key、--openai-api-key、--gemini-api-key等由 commands/onboard-core-auth-flags.ts 注册的每提供方 API Key标志直传密钥向导会将其按--secret-input-mode指定的方式明文写入配置或ref引用持久化。本地网关引导流程详解以本地模式默认为例交互式向导在 wizard/setup.ts 中按固定顺序执行。理解这一顺序有助于在使用时预判每一步的输入风险确认向导首先展示安全提示默认是个人 Agent单一可信操作者边界需要用户确认接受交互模式下以确认框呈现非交互模式则要求显式--accept-risk读取现有配置若~/.openclaw/openclaw.json已存在向导会汇总显示现有 workspace、model、gateway 配置并提供三种处理方式——Use existing values沿用/ Update values更新/ Reset重置若配置无效则提示先运行openclaw doctor修复选择流程与模式默认quickstart高级流程下会询问 What do you want to set up?本地网关 / 远程网关设置工作区目录认证与默认模型选择认证方式含skip跳过并挑选默认模型QuickStart 流程默认采用各提供方的推荐模型Gateway 配置端口、绑定、认证、Tailscale渠道设置QuickStart 只列出声明了quickstartAllowFrom的渠道插件跳过 DM 策略与确认提示直接写入 allow-from 配置搜索提供方可用--skip-search跳过Skills 安装可用--skip-skills跳过安装前会询问 Node 包管理器 npm/pnpm/bun内部 hooks设置/new时注入的会话记忆 hooks收尾安装 Gateway 服务、健康检查、展示 Control UI 链接、shell 补全安装。QuickStart 的网关默认值QuickStart 的关键在于最少提示自动生成令牌。从 wizard/setup.gateway-config.ts 的configureGatewayForSetup可以看到其默认策略端口沿用现有配置或默认 18789绑定loopback127.0.0.1认证token令牌由 commands/onboard-helpers.ts 的randomToken()生成24 字节随机数转 hex共 48 个十六进制字符若环境变量OPENCLAW_GATEWAY_TOKEN已设置则优先使用Tailscaleoff若此前没有网关配置QuickStart 还会为新增网关写入默认的危险命令拒绝列表denyCommands见 gateway/node-command-policy.ts并开启 loopback 下的controlUi.allowInsecureAuth。Manualadvanced流程的完整提示manual流程则会逐一提示Gateway 端口默认 18789输入必须是合法数字Gateway bindloopback127.0.0.1、lan0.0.0.0、tailnetTailscale IP、autoLoopback → LAN 自动回退、custom自定义 IPv4 地址须通过validateIPv4AddressInput校验Gateway authtoken默认推荐或passwordtoken 可留空由系统生成也可通过--gateway-token-ref-env指定 SecretRef 环境变量Tailscale exposureoff/serve/funnel并询问是否在退出时重置 serve/funnel。源码中还强制了两条安全约束Tailscale 非off时绑定必须为loopback避免非 loopback 服务与 Tailscale 同时暴露funnel模式必须使用password认证。这些约束由向导自动修正并在界面中提示。远程网关模式--mode remote远程模式用于连接在其他主机上运行的 Gateway向导只写入远程连接信息不会在本机配置认证凭据必须已存在于网关主机上。对应实现见 commands/onboard-remote.ts。openclaw onboard --mode remote --remote-url ws://gateway-host:18789远程模式的配置项包括URL 校验必须以ws://或wss://开头远程主机默认要求wss://仅ws://127.0.0.1/ localhost 允许明文典型场景是 SSH 隧道如需在可信私网放行可使用环境变量OPENCLAW_ALLOW_INSECURE_PRIVATE_WS1Bonjour 发现本机存在dns-sdmacOS或avahi-browseLinux时会询问是否在局域网发现网关发现到候选后可选直接连接wss://host:port含 TLS 指纹确认与 pin或SSH 隧道loopback保持ws://127.0.0.1:18789认证token推荐默认、password、no auth三种token/password 均可选择明文输入或以 SecretRef 方式引用首选环境变量OPENCLAW_GATEWAY_TOKEN/OPENCLAW_GATEWAY_PASSWORD。完成后的配置写入gateway.mode: remote与gateway.remote.url且使用非 loopback 绑定时会自动补充 Control UI 的允许来源allowedOrigins。非交互式安装--non-interactive面向脚本与自动化场景openclaw onboard支持完全无提示的安装。由于 Agent 具备系统访问能力非交互模式必须显式传入--accept-risk否则命令直接报错退出见 commands/onboard.tsopenclaw onboard --non-interactive --accept-risk --flow quickstart openclaw onboard --non-interactive --accept-risk --auth-choice deepseek-api-key \ --deepseek-api-key sk-xxx --gateway-port 18789校验规则还包括--secret-input-mode只允许plaintext/ref--reset-scope只允许config/configcredssessions/full。非交互流程在 commands/onboard-non-interactive 下按 local / remote 两个子路径实现可用--json输出机器可读的安装摘要。现有配置处理与重置重新运行onboard时向导会先汇总现有配置摘要workspace、model、gateway.mode/port/bind、remote URL、nodeManager。若选择Reset或使用--reset标志则按--reset-scope执行不同深度的清理对应实现 commands/onboard-helpers.ts 的handleResetconfig仅移入回收站删除配置文件openclaw.jsonconfigcredssessions默认额外清理credentials目录与会话记录full再清理整个 Agent 工作区目录。openclaw onboard --reset --reset-scope full引导收尾服务安装、健康检查与 Control UI收尾阶段由 wizard/setup.finalize.ts 完成包括Gateway 服务安装QuickStart 默认安装Linux 下为 systemd user service且会检查并提示启用 linger 防止登出后服务被杀advanced 流程询问是否安装、选择运行时node/bun若服务已存在则提供 Restart / Reinstall / Skip 三选一健康检查通过waitForGatewayReachable轮询 WebSocket 端点默认 15 秒超时成功后自动运行openclaw health失败时给出openclaw gateway run、openclaw onboard --install-daemon、openclaw onboard --skip-health等提示Control UI / TUI 引导展示 Web UI 地址token 模式下附#token...认证 URL与 Gateway WS 地址并提供在 TUI 中孵化推荐/ 打开 Web UI / 稍后再说三选一最后提示openclaw dashboard --no-open随时重开控制台shell 补全向导会自动检查并安装当前 shellbash / zsh / fish / powershell的openclaw补全QuickStart 流程直接安装advanced 流程询问确认。收尾时还会提示备份 Agent 工作区、阅读安全加固文档并总结 Web 搜索配置状态已配置 / 缺 Key / 被禁用时给出openclaw configure --section web的修复入口。最快开始聊天openclaw dashboard如果只想尽快开始对话、跳过渠道配置直接运行openclaw dashboard该命令打开 Control UIWeb 控制台默认http://127.0.0.1:gateway-port无需先完成渠道设置即可与 Agent 聊天无 GUI 环境下可用--no-open仅打印带 token 的 URL。之后随时可回到openclaw onboard补充渠道、搜索或 Skills 配置或使用openclaw configure逐项调整。相关资源macOS 桌面端的第一启动流程参考docs/start/onboarding.md更细化的配置向导命令openclaw setup相关见 docs/cli/setup.md引导后的配置修复与体检openclaw doctor逐项配置openclaw configure渠道管理openclaw channels。提示本文描述的默认端口 18789、参数名与流程行为均取自当前仓库源码commands/onboard.ts、cli/program/register.onboard.ts、wizard/setup.ts实际使用时以你安装的 OpenClaw 版本openclaw onboard --help输出为准。赞分享人工智能大模型LLM 网关AI Agent即时通讯【免费下载链接】openclaw-zero-tokenOpenClaw: Use All Major AI Models NO API Token! Claude/ChatGPT/Gemini/DeepSeek/Doubao/Grok/Qwen/Manus/Kimi项目地址https://gitcode.com/gh_mirrors/op/openclaw-zero-token点击查看免费下载相关推荐OpenClaw CLI 新手引导向导openclaw onboard一条命令完成 Gateway、工作区、渠道与 Skills 配置OpenClaw CLI 新手引导向导openclaw onboard一条命令完成 Gateway、工作区、渠道与 Skills 配置 OpenClaw人工智能大模型LLM 网关AI Agent即时通讯OpenClaw 引导向导openclaw onboard完全指南一站式配置 Gateway、模型认证、频道与技能OpenClaw 引导向导openclaw onboard完全指南一站式配置 Gateway、模型认证、频道与技能导读 openclaw onboard人工智能大模型LLM 网关AI Agent即时通讯openclaw-cn onboard 命令全解从交互式引导到脚本化非交互部署的完整指南openclaw cn onboard 命令全解从交互式引导到脚本化非交互部署的完整指南导读 openclaw cn onboard 是 OpenClaw提示工程AI 安全治理上一篇终极视频分析工具5分钟构建高效智能视频理解系统下一篇3个关键问题如何快速搭建专业在线考试系统创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

OpenClaw `openclaw onboard` 命令完全指南：交互式引导配置 Gateway、工作区、认证与渠道

相关推荐

LangChain入门---基于DeepSeek-V4-Pro模型

Fusion 360 自制机械臂：从设计到 URDF+ROS2+Rviz联合Gazebo+MoveIt+Setup_Assistant+程序控制+录制动作运动规划保姆级教程

Linux内核层定制实战：配置裁剪、启动参数调优与驱动适配

更多资讯

文件时间属性修改全攻略：批量操作、工具选型与避坑指南

电视播不了视频怎么办？格式、投屏、解码问题排查指南

X startup failed 报错排查：服务器安装图形界面失败怎么办

Java调用海康威视HCNetSDK实现无浏览器视频预览

微信聊天记录导出指南：用 WeChatMsg 把消息变成 HTML、Word 与 CSV 文件

HTML常用标签深度实战：语义化、表单与可访问性避坑指南

今日更新

Cephadm实战指南：Linux系统工程师的生产级Ceph集群部署与排障

不想再被 Token 额度卡脖子？把免费 API 接入 WorkBuddy 的完整教程

ITK中SpatialObject几何体系解析：坐标系、变换与管道集成

本周精选

交通拥堵预测毕设：基于Python+LSTM的车辆流量预测系统全流程解析

MATLAB/Simulink搭建10机39节点电力系统暂态稳定仿真实战

无人机航拍三维重建全流程：从SfM到网格生成的避坑指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？