新手引导概览

OpenClaw 提供终端和 macOS 应用新手引导。两者都会先建立推理能力： 检测现有的 AI 访问方式，要求成功完成一次实时补全，然后才启动 OpenClaw 以配置其余设置。如果已配置且可访问的 Gateway 网关中， 默认智能体已有配置好的模型，则会跳过新手引导和 OpenClaw 设置， 直接打开常规智能体 UI。终端流程还提供完整的经典向导， 用于详细设置。

应该使用哪种方式？

大多数用户应从 CLI 新手引导 开始——它适用于所有平台， 并能提供最大程度的控制。

新手引导会配置什么

引导式推理阶段只会建立：

1. 模型提供商和身份验证——检测到的访问方式，或经过验证的提供商登录、 API key 或令牌
2. 经过验证的推理——使用默认智能体实际生效的模型完成一次真实补全

该补全通过后，OpenClaw 可以配置工作区、Gateway 网关、 Gateway 网关服务、渠道、智能体、插件及其他可选功能。

经典 CLI 向导还可以配置：

1. 渠道（可选）——内置及捆绑的聊天渠道，例如 Discord、Feishu、Google Chat、iMessage、Mattermost、Microsoft Teams、 Telegram、WhatsApp 等
2. 高级 Gateway 网关控制——远程模式、网络设置和守护进程选项

CLI 新手引导

在任意终端中运行：

openclaw onboard

引导流程会检测现有的 AI 访问方式，按顺序对候选项进行实时测试， 并在失败时继续尝试下一项。如果检测过程未找到可用项，它会优先显示 OpenAI、 Anthropic、xAI (Grok)、Google 和 OpenRouter。More… 的第二级菜单 按提供商组列出其余提供商，以及地区、套餐和支持的 浏览器、设备、API key 或令牌方式。只有补全成功后，它才会保存模型 和凭据，然后启动 OpenClaw，以配置工作区、Gateway 网关、渠道、 智能体、插件及其他可选功能。Skip for now 会直接退出，不启动 OpenClaw。流程中不会转入经典向导；如需改用经典向导，请退出并运行 openclaw onboard --classic。

推理通过后，OpenClaw 可以将渠道设置交给使用掩码输入的终端 向导。它不会打开引导式或经典提供商设置；如需更改模型提供商或其身份验证， 请退出 OpenClaw 并运行 openclaw onboard。

使用 openclaw onboard --classic 进行详细的模型/身份验证、渠道、技能、 远程 Gateway 网关或导入设置。添加 --install-daemon 还会选择 经典流程，并一步安装后台服务。使用 openclaw openclaw 以对话方式执行非推理设置和修复。openclaw onboard --modern 是使用相同实时推理 门槛的兼容性别名。

完整参考：新手引导（CLI） CLI 命令文档：openclaw onboard

macOS 应用新手引导

打开 OpenClaw 应用。如果其配置的本地或远程 Gateway 网关可访问， 且默认智能体已有配置好的模型，应用会跳过新手引导 和 OpenClaw 设置，并立即打开常规智能体 UI。

对于全新或尚未完成配置的 Gateway 网关，首次运行流程会检测现有的 AI 访问方式（Claude Code、Codex 或 API key），实时测试最佳 选项，并仅在获得真实回复后保存——如果失败则自动尝试其他选项， 在未找到任何访问方式时提供经过验证的手动 API key 设置步骤。敏感 凭据采用掩码输入。推理通过后，OpenClaw 会启动 并协助配置其余内容。

设置完成后，Gemini CLI 仍可供常规智能体使用，但不会用于 此推理门槛，因为它无法强制执行无工具探测。

完整参考：新手引导（macOS 应用）

自定义或未列出的提供商

如果提供商未列出，请运行 openclaw onboard --classic，选择 Custom Provider，然后输入：

• 端点兼容性：兼容 OpenAI（/chat/completions）、兼容 OpenAI Responses（/responses）、兼容 Anthropic（/messages），或未知（探测全部三种并自动检测）
• 基础 URL 和 API key（如果端点不要求 API key，则可以不填）
• 模型 ID 和可选模型别名

可以同时使用多个自定义端点——每个端点都有独立的端点 ID。

相关内容

• 入门指南
• CLI 设置参考