新手引导向导是在 macOS、Linux 或 Windows（通过 WSL2；强烈推荐）上设置 OpenClaw 的推荐方式。 它可以在一个引导式流程中配置本地 Gateway 网关或远程 Gateway 网关连接，以及渠道、Skills 和工作区默认值。 主要入口：

最快开始聊天的方式：打开控制界面（无需设置渠道）。运行并在浏览器中聊天。文档：控制面板。 后续重新配置：

推荐：设置 Brave Search API 密钥，以便智能体可以使用（无需密钥即可使用）。最简单的方式：，它会存储。文档：Web 工具。

向导从快速开始（默认值）vs高级（完全控制）开始。快速开始保持默认值：

高级暴露每个步骤（模式、工作区、Gateway 网关、渠道、守护进程、Skills）。

本地模式（默认）引导你完成：

远程模式仅配置本地客户端连接到其他位置的 Gateway 网关。 它不会在远程主机上安装或更改任何内容。 要添加更多隔离的智能体（独立的工作区 + 会话 + 认证），使用：

openclaw agents add <name

提示：不意味着非交互模式。脚本中请使用（和）。

远程模式配置本地客户端连接到其他位置的 Gateway 网关。 你将设置的内容：

注意事项：

使用创建一个具有独立工作区、会话和认证配置文件的单独智能体。不带运行会启动向导。 它设置的内容：

注意事项：

使用自动化或脚本化新手引导：

GPT plus 代充 只需 145openclaw&nbsp;onboard&nbsp;–non-interactive&nbsp;&nbsp;–mode&nbsp;local&nbsp;&nbsp;–auth-choice&nbsp;apiKey&nbsp;&nbsp;–anthropic-api-key&nbsp;“\(ANTHROPICAPIKEY"&nbsp;&nbsp;--gateway-port&nbsp;18789&nbsp;&nbsp;--gateway-bind&nbsp;loopback&nbsp;&nbsp;--install-daemon&nbsp;&nbsp;--daemon-runtime&nbsp;node&nbsp;&nbsp;--skip-skills</pre><p>添加以获取机器可读的摘要。 Gemini 示例：</p><pre>openclaw&nbsp;onboard&nbsp;--non-interactive&nbsp;&nbsp;--mode&nbsp;local&nbsp;&nbsp;--auth-choice&nbsp;gemini-api-key&nbsp;&nbsp;--gemini-api-key&nbsp;"\)GEMINIAPIKEY”&nbsp;&nbsp;–gateway-port&nbsp;18789&nbsp;&nbsp;–gateway-bind&nbsp;loopback

Z.AI 示例：

openclaw&nbsp;onboard&nbsp;–non-interactive&nbsp;&nbsp;–mode&nbsp;local&nbsp;&nbsp;–auth-choice&nbsp;zai-api-key&nbsp;&nbsp;–zai-api-key&nbsp;“\(ZAIAPIKEY"&nbsp;&nbsp;--gateway-port&nbsp;18789&nbsp;&nbsp;--gateway-bind&nbsp;loopback</pre><p>Vercel AI Gateway 示例：</p><pre>openclaw&nbsp;onboard&nbsp;--non-interactive&nbsp;&nbsp;--mode&nbsp;local&nbsp;&nbsp;--auth-choice&nbsp;ai-gateway-api-key&nbsp;&nbsp;--ai-gateway-api-key&nbsp;"\)AIGATEWAYAPI_KEY”&nbsp;&nbsp;–gateway-port&nbsp;18789&nbsp;&nbsp;–gateway-bind&nbsp;loopback

Moonshot 示例：

GPT plus 代充 只需 145openclaw&nbsp;onboard&nbsp;–non-interactive&nbsp;&nbsp;–mode&nbsp;local&nbsp;&nbsp;–auth-choice&nbsp;moonshot-api-key&nbsp;&nbsp;–moonshot-api-key&nbsp;“\(MOONSHOTAPIKEY"&nbsp;&nbsp;--gateway-port&nbsp;18789&nbsp;&nbsp;--gateway-bind&nbsp;loopback</pre><p>Synthetic 示例：</p><pre>openclaw&nbsp;onboard&nbsp;--non-interactive&nbsp;&nbsp;--mode&nbsp;local&nbsp;&nbsp;--auth-choice&nbsp;synthetic-api-key&nbsp;&nbsp;--synthetic-api-key&nbsp;"\)SYNTHETICAPIKEY”&nbsp;&nbsp;–gateway-port&nbsp;18789&nbsp;&nbsp;–gateway-bind&nbsp;loopback

OpenCode Zen 示例：

openclaw onboard –non-interactive  –mode local  –auth-choice opencode-zen  –opencode-zen-api-key ”$OPENCODEAPIKEY”  –gateway-port 18789  –gateway-bind loopback

添加智能体（非交互）示例：

GPT plus 代充 只需 145openclaw agents add work  –workspace ~/.openclaw/workspace-work  –model openai/gpt-5.2  –bind whatsapp:biz  –non-interactive  –json

Gateway 网关通过 RPC 暴露向导流程（、、、）。 客户端（macOS 应用、控制界面）可以渲染步骤而无需重新实现新手引导逻辑。

向导可以从 GitHub releases 安装：

注意事项：

中的典型字段：

写入和可选的。 WhatsApp 凭证存储在下。 会话存储在下。 某些渠道以插件形式提供。当你在新手引导期间选择一个时，向导会在配置之前提示安装它（npm 或本地路径）。