新手引导概览

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 设置参考