新手引导向导

openclaw onboard 是 OpenClaw 在 macOS、Linux 和 Windows（通过 WSL2）上的推荐配置方式。它能在一个引导流程里完成模型认证、工作区、Gateway、渠道、守护进程与 Skills 的初始化。

开始使用快速开始 Gateway 配置

Quick vs Advanced

Quick 默认

快速开始

保留默认值：本地 Gateway、默认工作区、18789 端口、自动生成 token、基础渠道安全策略和推荐 Skills。

Advanced

高级模式

暴露每一步：工作区、Gateway 绑定、认证模式、渠道、守护进程、Skills 选择与更多模型细节。

Local

本地模式

在当前机器上创建或更新配置，安装守护进程、写入凭证，并执行完整健康检查。

Remote

远程模式

只配置当前客户端如何连接远程 Gateway，不会在远程主机上安装、修改服务或写入凭证。

向导会做什么

现有配置检测

如果 ~/.openclaw/openclaw.json 已存在，向导会让你保留、修改或重置。除非你明确选择重置，否则不会清空已有配置。

模型与认证

支持 Anthropic API Key / setup-token、OpenAI / Codex OAuth、OpenAI API Key、Moonshot、GLM、MiniMax、AI Gateway 等模式，并可顺便设置默认模型。

工作区与 Gateway

配置默认工作区、Gateway 端口、绑定方式、认证 token、是否暴露到 tailnet，以及是否启用后台服务。

渠道与配对安全

根据需要接入 WhatsApp、Telegram、Discord、Google Chat、Mattermost、Signal 等渠道，并默认开启私信配对保护。

健康检查与 Skills

启动 Gateway、运行健康探测，并协助你安装推荐 Skills 与依赖。

常用命令

启动向导

openclaw onboard

重新配置

当你只是想修改某一部分配置而不是重装。

openclaw configure

添加另一个智能体

为不同工作区、模型或用途创建隔离智能体。

openclaw agents add <name>

非交互模式

适合自动化脚本或 CI 初始化。

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice apiKey \
  --gateway-port 18789 \
  --gateway-bind loopback \
  --install-daemon \
  --daemon-runtime node \
  --skip-skills