2026年手把手教你安装 OpenClaw 小龙虾（MAC安装教程），一次成功不踩坑

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

在开始之前，请确保你的 Mac 满足以下条件：

磁盘空间：建议预留 5GB 以上，因为 Node.js 模块和项目构建会占用不少空间。
网络环境：由于 GitHub 和 NPM 官方源在国内访问较慢，强烈建议全程开启魔法（全局模式）。
终端工具：按下，输入 (终端) 并回车。

更多工具获取地址：https://docs..com/sheet/DWE1hQXRyWVZ2dmpB?tab=BB08J2

Homebrew 是 macOS 上的包管理器，相当于 Linux 的 apt/yum。

2.1 安装 Homebrew：Mac 软件管家

打开终端（，输入），

在终端输入命令：

开始安装 Homebrew如下图所示：

上图的这句话需要我们按下enter键，接下来他会安装，如下图所示：

⚠️ 常见错误 1：网络超时

GPT plus 代充 只需 145

解决方案：开启后重试。如果开启魔法还是不行，那就等几个小时后再安装，过一会可能就安装成功了，我就等了一晚，早上起来安装成功的！

⚠️ 常见错误 2：GitHub 连接失败

安装过程中可能出现以下错误：

解决方案：

开启
或等待网络恢复后重试

⚠️ 常见错误 3：安装过程卡住

如果出现，按 回车键 继续安装。

2.2 手动配置 PATH

安装完成后，需要将 Homebrew 添加到系统 PATH，并且终端已经给我们提示了如下图所示：

在终端执行以下命令：

GPT plus 代充 只需 145

2.3 验证安装结果

验证：在终端输入，

看到版本号即表示成功，如下图所示：

Node.js 是运行 OpenClaw 的引擎。版本低于 22 将直接导致程序崩溃或无法编译。

3.1 检查当前环境

首先确认你的 Mac 是否已经安装了 Node.js 以及具体的版本号：

GPT plus 代充 只需 145

版本＞ 22：恭喜你，可以直接跳到第四步。
版本 < 22 或显示：请继续执行以下步骤进行安装或升级。

3.2 方案一：使用 Homebrew 快速安装（推荐）

如果你希望简单快捷，直接使用安装最新稳定版：

如下图所示：

❝
💡 注意： > 执行完后，如果依然显示旧版本，通常是因为旧版本的路径优先级更高。你可以尝试运行来强制刷新软链接。

3.3 验证安装结果

安装完成后，务必再次确认版本：

GPT plus 代充 只需 145

同时检查 Node 的包管理器 npm 是否正常：

输入两次命令后，正确安装如下图所示：

⚠️ 注意事项：

M 系列芯片原生支持：通过安装的 Node.js 是原生支持 Apple Silicon 的，性能极佳。
编译权限：如果在安装过程中遇到报错，请检查是否在命令前误加了（通常 brew 不需要 sudo，npm 全局安装时可能需要）。

4.1 执行安装命令

在终端中输入以下指令并回车：

GPT plus 代充 只需 145

4.2 验证安装是否成功

安装完成后，输入以下命令检查 Git 是否已就绪：

预期输出：

如果你看到类似的字样，说明 Git 已经成功入驻你的 Mac。

⚠️ 常见问题排查

下载速度极慢：Git 的安装包托管在 GitHub 上，如果进度条长时间不动，请确保你的已开启全局模式。
报错 "xcrun: error"：这通常是因为 Xcode 路径损坏。尝试运行重新修复开发工具环境。

在准备好 Git 和 Node.js 22+ 之后，我们终于可以开始正式获取 OpenClaw 的源代码了。这一步不仅是将代码“下载”下来，更是建立本地运行环境的起点。

5.1 克隆项目：将代码下载至本地

“克隆”（Clone）是 Git 的术语，意为在你的电脑上创建一个远程仓库的完整拷贝。输入以下命令从 GitHub 拉取代码：

GPT plus 代充 只需 145

命令解析：是下载指令，后面的 URL 是 OpenClaw 的官方仓库地址。
成功标志：终端显示且没有报错。

进入项目目录

下载完成后，你需要“走进”这个文件夹才能进行后续操作：

❝
💡 小贴士：

这一步非常重要！如果你不执行，后续的命令会因为找不到配置文件而报错。

5.2 安装依赖包

在目录下执行：

GPT plus 代充 只需 145

5.3 全局安装OpenClaw

这一步会将注册为系统命令，方便你在任何地方调用，我们在终端输入如下命令：

5.4 初始化与运行

运行设置向导

GPT plus 代充 只需 145

系统会自动初始化配置文件并确认工作区状态。

输出：

启动网关 (Gateway)，继续在终端输入下面的命令：

GPT plus 代充 只需 145

输出：

重要：如果是第一次启动，UI 构建需要几分钟时间。如果此时访问网页提示，请稍等片刻再重新运行。

安装成功后显示：

⚠️ 常见错误：command not found

GPT plus 代充 只需 145

解决方案：执行即可解决。

5.5 打开控制面板 (Dashboard)

保持网关窗口开启，新开一个终端窗口输入：

浏览器会自动打开。

到这里我已经成功安装了openclaw。但这个openclaw还是没有思想的，我们需要给openclaw配置大模型。

5.6 给OpenClaw大模型 (终端版)

除了在 Web UI 界面配置外，你也可以直接在终端完成配置。我们就以在终端为例。

我们在终端输入命令

GPT plus 代充 只需 145

在图片所示的界面中，系统提示：，使用键盘方向键选择 Yes 并回车。

接下来我们继续点击回车键，选择该工作目录。

使用键盘方向键选择 Yes 并回车，来配置模型。

接下来的终端界面会列出多个模型提供商。

我这里使用的是MiniMax这个大模型，使用方向键找到 MiniMax。按下回车键确认选择带（cn）。大家可以选择其他的模型。

接下是需要黏贴API key，如下图所示：

5.7 输入 API Key 与配置

系统会依次弹出输入提示，输入你在 MiniMax 开放平台申请的。

接下来我们不选择配置聊天工具，选择no，

5.8 验证配置

配置完成后，重新运行网关以激活配置：

打开浏览器进入 Dashboard ()，我们在对话框中问他是哪个模型？

我们看到图中回复我是minimax2.5模型，说明配置已成功生效。

这样我们就配置好了 OpenClaw 小龙虾。

此文章花费2天时间制作，希望能够帮助大家。