资料核对日期:2026年11月16日。本文未做本地安装实测,适用于在受支持的 macOS 上安装 OpenClaw 原生应用,并完成首次 AI 对话验收。

确认系统与发行版范围

本文依据官方文档提交 3dc7eb96a52859815e1f6b36f524bab875d4a08a 核对。该版本文档明确写明:原生 OpenClaw.app 要求 macOS 26.2(Tahoe)或更高版本;文档中的直接下载链接固定指向 2026.10.3。发布页可能已有更新,因此固定链接、最新发布、主分支和稳定版本不能互相等同。

如果 Mac 低于 macOS 26.2,不应据此假定原生应用可以运行。官方提供的替代方向是 CLI 与 Gateway,但它们有独立的 Node.js 和操作系统支持条件,应转到 Getting started 按当前说明安装;CLI 能运行也不代表原生应用兼容较旧的 macOS。

安装前还要准备一种 AI 连接:已有的 Claude Code 或 Codex CLI 登录,或者服务商签发的 API 密钥。示例变量名和密钥占位符不能作为实际凭据使用。

下载并安装原生应用

打开 OpenClaw GitHub Releases,选择确实包含 macOS 应用资产的发行版,再按 Mac 的 Apple Silicon、Intel 或通用架构选择合适的安装包。官方安装总览优先建议 DMG,也允许使用 ZIP。下载前应查看该发行版的说明与资产,不要仅按版本号大小判断兼容性;如果最新发行版没有 macOS 应用资产,可选择仍提供该资产的最新发行版。源码构建需要额外工具链,不属于这条最小安装路线。

下载后按 macOS 的常规应用安装方式完成安装,然后启动 OpenClaw.app。对于没有已保存 Gateway 或配置的新环境,应用会准备其随附运行时、在本机启动 Gateway,并打开 Dashboard 的首次引导。此阶段的预期结果不是只看到应用图标,而是 Dashboard 可以加载并进入设置流程。应用不会自动加入发现到的 Gateway;需要远程 Gateway 时,应在设置流程中明确选择。

连接 AI 并完成首次引导

在 Dashboard 中选择检测到的 AI 连接,或者按引导改选其他可用连接。官方文档说明,OpenClaw 会在选择后执行实时模型检查;发现了登录或密钥并不等于连接已经可用。

按界面完成必要的登录与设置。可观察的通过条件是:Dashboard 已加载,所选 AI 连接通过检查,聊天输入区域可用。若没有可用的自动检测结果,应进入手动设置并选择受支持的连接,而不是填写示例密钥。

发送并验收首个任务

在聊天区输入一条不含密钥、账号、客户资料或其他敏感信息的公开文本任务,例如:

请用三句话列出今天整理工作计划的步骤。

发送后依次确认:消息已进入当前会话;界面没有停留在认证或连接错误;助手返回了与问题相关的文本。只有这三项均满足,才能把本次操作视为完成了原生应用安装、AI 连接和首个任务的基本验收。

没有收到回复时分阶段检查

先确认 Dashboard 是否已经加载;未加载时,问题仍可能位于运行时准备、Gateway 启动或页面加载阶段。Dashboard 可用但模型检查失败时,重新登录或改选其他 AI 连接。模型检查通过但任务没有回复时,再确认消息是否成功进入当前会话,并记录界面显示的错误。

不要把“应用已安装”“Gateway 已启动”“AI 认证可用”和“任务已获得回复”视为同一个检查点。仍无法继续时,以当前 macOS 应用文档 和 Getting started 为核对入口,并按实际选择的发行版重新确认系统要求。

官方参考资料

继续阅读