入门概述

OpenClaw 支持从终端、macOS 应用和 Linux 桌面伴侣进行入门引导。每条路径都会先建立推理：它会检测现有的 AI 访问权限，要求一次实时补全，然后才启动 OpenClaw 以配置其余设置。在 macOS 入门引导期间，选择已配置的模型会在打开正常仪表盘之前验证该路由。终端流程还提供完整的经典向导，用于详细设置。

我该使用哪条路径？¶

大多数用户应从 CLI 入门引导 开始——它到处可用，并给你最大的控制权。

入门引导配置什么¶

引导式推理阶段仅建立：

1. 模型提供商和认证 — 检测到的访问权限，或经过验证的提供商登录、API 密钥或 Token
2. 已验证推理 — 在默认代理的生效模型上的一次真实补全

当该补全通过后，OpenClaw 可以配置工作区、Gateway、Gateway 服务、通道、代理、插件和其他可选功能。

经典 CLI 向导还可以额外配置：

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

CLI 入门引导¶

在任意终端中运行：

openclaw onboard

在全新安装中，引导式流程提供 快速开始 和 自定义设置，检测你已有的 AI 访问权限，用一次真实补全验证你选择的唯一连接，然后才配置其余设置。两条路径、提供商选择器、暂时跳过 以及前台 Gateway 在 入门引导（CLI） 中逐步说明。

推理通过后，OpenClaw 可以将通道设置交给带掩码的终端向导。它不会打开引导式或经典提供商设置。退出 OpenClaw 并运行 openclaw onboard 以更改模型提供商或其认证。

使用 openclaw onboard --classic 进行详细的模型/认证、通道、技能、远程 Gateway 或导入设置。添加 --install-daemon 也会选择经典流程，并一步安装后台服务。使用 openclaw setup 进行对话式非推理设置和修复。openclaw onboard --modern 是一个兼容别名，使用相同的实时推理门禁。

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

macOS 应用入门引导¶

下载 macOS 应用，然后打开它。如果其已配置的本地或远程 Gateway 可访问，并且默认代理已有已配置的模型，入门引导会提供 当前模型。选择它以运行真实模型检查并打开正常仪表盘。加载页面只会检测可用连接，包括当此 Mac 首次加入现有 Gateway 时。

对于全新或不完整的 Gateway，原生设置会处理 Gateway 连接、任何所需的本地 CLI/运行时安装以及 AI 访问权限。它会检测现有凭据或符合条件的已加载本地模型，但不测试或选择它们，然后等待明确点击后再激活。提供商列表包括可安装的官方提供商插件和自定义 OpenAI/Anthropic 兼容端点流程。全新安装默认关闭原生 Claude/Codex 对话发现，并在启用前询问。新模型通过后，应用会在仪表盘中打开引导式入门引导，用于可选设置，包括记忆导入和通道，然后才切换到正常代理聊天。记忆导入和权限不是单独的原生首次运行页面；macOS 权限仍可在 设置 → 权限 中可用。

Gemini CLI 在设置后仍可作为明确配置的运行时使用，但 Gemini CLI 和 Antigravity 不作为检测到的推理路由提供。引导式设置请使用 Google AI Studio API 密钥或 Vertex AI。可选的 Gemini CLI 运行时特别要求 AI Studio API 密钥配置文件。

完整参考：入门引导（macOS 应用）

Linux 应用入门引导¶

安装 Linux 桌面伴侣，然后打开它。欢迎屏幕让你选择 此计算机 或 另一台计算机 上的 Gateway。本地设置会在私有托管运行时中安装任何缺失的 CLI 和 Node，然后启动 systemd 用户服务。远程设置会连接到已发现的 Gateway、手动输入的 Gateway URL，或通过 SSH 隧道到达的 Gateway；支持 Token 和密码认证。

模型设置会检查现有提供商访问权限，并在需要时提供登录或 API 密钥输入。所选 Gateway 会在引导式入门引导开始前验证真实模型响应。已配置的 Gateway 验证后会打开正常代理 UI。重启/重新打开恢复使用绑定到 Gateway、代理和认证的临时记录：已知模型会在不重复激活的情况下验证，而未知结果需要明确的 验证并使用所选模型 操作。过期、已清除或不可用的浏览器存储，或更改的连接所有权可能会阻止恢复。有关恢复详情，请参阅 首次运行设置。

平台和远程访问详情：Linux 应用 和 远程访问。

自定义或未列出的提供商¶

如果你的提供商未列出，请在 Gateway 主机的终端中运行 openclaw onboard，选择 自定义提供商（显示时在 更多… 下），并输入：

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

多个自定义端点可以共存——每个端点都有自己独立的端点 ID。引导式设置会在保存提供商并激活其模型之前，验证真实的模型回复。检查失败或取消会保留之前的配置。经典向导也保留其自定义提供商设置。

如果端点拒绝连接或其主机名无法找到，设置会立即报告连接失败，而不是等待正常的聊天重试。请在 Gateway 主机上启动服务器或更正 URL 和网络设置，然后重试。普通代理会话仍保留其连接重试。

相关¶

• 入门指南
• CLI 设置参考