在 macOS 系统下安装和配置 OpenClaw 自动化框架的完整流程。首先需准备磁盘空间与网络环境，通过 Homebrew 安装包管理器及 Node.js 22+ 版本，并配置 Git。随后克隆项目源码，使用 npm 安装依赖并全局注册命令。完成基础安装后，通过命令行初始化工作区并启动网关。最后需在终端配置大模型 API Key（如 MiniMax）以激活智能代理功能，确保 Dashboard 可正常访问。
在开始之前，请确保你的 Mac 满足以下条件：
Command + 空格，输入 Terminal (终端) 并回车。Homebrew 是 macOS 上的包管理器，相当于 Linux 的 apt/yum。
打开终端（Command + 空格，输入 terminal），
在终端输入命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
开始安装 Homebrew 如下图所示：
上图的这句话 Press RETURN/ENTER to continue or any other key to abort: 需要我们按下 enter 键，接下来他会安装 Command Line Tools for Xcode 26.3，如下图所示：
⚠️ 常见错误 1：网络超时
curl: (56) Recv failure: Operation timed out
解决方案：检查网络连接后重试。如果开启代理还是不行，那就等几个小时后再安装，过一会可能就安装成功了，我就等了一晚，早上起来安装成功的！
⚠️ 常见错误 2：GitHub 连接失败
安装过程中可能出现以下错误：
error: RPC failed; curl 28 Failed to connect to github.com port 443 fatal: unable to access 'https://github.com/Homebrew/brew/': SSL connection timeout
解决方案：
⚠️ 常见错误 3：安装过程卡住
如果出现 Press RETURN/ENTER to continue or any other key to abort:，按 回车键 继续安装。
安装完成后，需要将 Homebrew 添加到系统 PATH，并且终端已经给我们提示了如下图所示：
在终端执行以下命令：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$( /opt/homebrew/bin/brew shellenv)"
验证：在终端输入 brew --version，
brew --version
看到版本号 Homebrew 5.0.16 即表示成功，如下图所示：
Node.js 是运行 OpenClaw 的引擎。版本低于 22 将直接导致程序崩溃或无法编译。
首先确认你的 Mac 是否已经安装了 Node.js 以及具体的版本号：
node -v
command not found：请继续执行以下步骤进行安装或升级。如果你希望简单快捷，直接使用 brew 安装最新稳定版：
# 安装最新版 Node.js
brew install node
如下图所示：
❝
💡 注意：
执行完
brew install node后，如果node -v依然显示旧版本，通常是因为旧版本的路径优先级更高。你可以尝试运行brew link --overwrite node来强制刷新软链接。
安装完成后，务必再次确认版本：
node -v # 预期输出类似：v22.x.x 或 v23.x.x
同时检查 Node 的包管理器 npm 是否正常：
npm -v
输入两次命令后，正确安装如下图所示：
⚠️ 注意事项：
brew 安装的 Node.js 是原生支持 Apple Silicon 的，性能极佳。Permission denied 报错，请检查是否在命令前误加了 sudo（通常 brew 不需要 sudo，npm 全局安装时可能需要）。在终端中输入以下指令并回车：
brew install git
安装完成后，输入以下命令检查 Git 是否已就绪：
git --version
预期输出：
如果你看到类似 git version 2.4x.x 的字样，说明 Git 已经成功入驻你的 Mac。
⚠️ 常见问题排查
xcode-select --install 重新修复开发工具环境。在准备好 Git 和 Node.js 22+ 之后，我们终于可以开始正式获取 OpenClaw 的源代码了。这一步不仅是将代码'下载'下来，更是建立本地运行环境的起点。
'克隆'（Clone）是 Git 的术语，意为在你的电脑上创建一个远程仓库的完整拷贝。输入以下命令从 GitHub 拉取代码：
git clone https://github.com/openclaw/openclaw.git
git clone 是下载指令，后面的 URL 是 OpenClaw 的官方仓库地址。Receiving objects: 100% ... done. 且没有报错。进入项目目录
下载完成后，你需要'走进'这个文件夹才能进行后续操作：
cd openclaw
❝
💡 小贴士：
这一步非常重要！如果你不执行
cd openclaw，后续的npm install命令会因为找不到配置文件而报错。
在 openclaw 目录下执行：
npm install
这一步会将 openclaw 注册为系统命令，方便你在任何地方调用，我们在终端输入如下命令：
npm install -g .
运行设置向导
openclaw setup
系统会自动初始化配置文件并确认工作区状态。
输出：
🦞 OpenClaw 2026.3.2 (132794f) — Automation with claws: minimal fuss, maximal pinch. Wrote ~/.openclaw/openclaw.json Workspace OK: ~/.openclaw/workspace Sessions OK: ~/.openclaw/agents/main/sessions
启动网关 (Gateway)，继续在终端输入下面的命令：
openclaw gateway
输出：
🦞 OpenClaw 2026.3.2 (132794f) — Your messages, your servers, your control.
重要：如果是第一次启动，UI 构建需要几分钟时间。如果此时访问网页提示 ERR_CONNECTION_REFUSED，请稍等片刻再重新运行。
安装成功后显示：
⚠️ 常见错误 ：command not found
zsh: command not found: openclaw
解决方案：执行 npm install -g . 即可解决。
保持网关窗口开启，新开一个终端窗口输入：
openclaw dashboard
浏览器会自动打开 http://127.0.0.1:18789。
到这里我已经成功安装了 openclaw。但这个 openclaw 还是没有思想的，我们需要给 openclaw 配置大模型。
除了在 Web UI 界面配置外，你也可以直接在终端完成配置。我们就以在终端为例。
我们在终端输入命令
openclaw agents add main
在图片所示的界面中，系统提示 Agent "main" already exists. Update it?：，使用键盘方向键选择 Yes 并回车。
接下来我们继续点击回车键，选择该工作目录。
使用键盘方向键选择 Yes 并回车，来配置模型。
接下来的终端界面会列出多个模型提供商。
我这里使用的是 MiniMax 这个大模型，使用方向键找到 MiniMax。按下回车键确认选择带（cn）。大家可以选择其他的模型。
接下是需要黏贴 API key，如下图所示：
系统会依次弹出输入提示，输入你在 MiniMax 开放平台申请的 API Key。
接下来我们不选择配置聊天工具，选择 no，
配置完成后，重新运行网关以激活配置：
openclaw gateway
打开浏览器进入 Dashboard (http://127.0.0.1:18789)，我们在对话框中问他是哪个模型？
我们看到图中回复我是 minimax2.5 模型，说明配置已成功生效。
这样我们就配置好了 OpenClaw 小龙虾。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online