MacOS程序安装OpenClaw安装避坑教程！详细教程，零踩坑

大家好，我是星哥！最近很多朋友问我 MacOS 怎么装 OpenClaw，踩了不少坑才摸透流程 —— 不管你是 Intel 芯片还是 M 系列的 Mac。哪怕是用 VMware 虚拟的 MacOS 程序，跟着我这篇教程走，从依赖安装到配置大模型，一步都不踩雷！

一、程序准备

• 兼容性确认：
• 官方最低要求这方面，macOS Monterey 及以上。说起来，
• 说到芯片类型。Intel / Apple Silicon 均兼容。
• 常见痛点：在旧版 macOS上尝试时会出现“Unsupported platform”错误，请先升级程序。
• 安装前必备依赖：
1. Node.js ≥ v22。注意：若使用 Homebrew 安装 node@20，请手动切换到 v22 或更高。
2. NPM ≥ 10.x。
3. Homebrew: 用于统一管理依赖与快速更新。

二、前期准备

痛点提示：Mavericks/VMware 虚拟机往往缺少 Xcode 命令行工具。需要手动安装，否则后续编译会报错。怎么说呢，

1️⃣ 在虚拟机里开启 SSH

sudo systemsetup -setremotelogin on
sudo systemsetup -getremotelogin

输入管理员密码后即可开启 SSH；若提示 “Remote Login already enabled”，可忽略。

2️⃣ 查看 macOS 版本信息

sw_vers
# 输出示例：
# ProductName: macOS
# ProductVersion: 14.0
# BuildVersion: XXH1005

User Pain Point: 如果版本显示为 “10.x” 或 “11.x”，请先升级至 Monterey 或更高。

三、OpenClaw 环境准备

1️⃣ 安装 Git 与 Xcode 命令行工具

// Terminal
xcode-select --install // 若已安装，可跳过
git --version // 验证是否成功

Pitfall: 在 M1/M2 上首次运行 git 时可能出现“zsh: command not found: git”。此时需确保 Xcode 工具已正确安装。

2️⃣ 安装 Homebrew

// 国内镜像脚本
/bin/zsh -c "$"
// 官方脚本
/bin/bash -c "$"

Pitfall: 若出现 “Permission denied” 错误，请检查 /usr/local/bin 权限或使用 sudo。

3️⃣ 查看 Brew 与 Node.js 是否正常工作：

brew -v # 应输出 brew version
node -v # 应输出 v22+ 或更高版本
npm -v # 应输出>=10.x

. 安装 Node.js ​

注：如你遇到 “node is not recognized as an internal or external command”，请确保 PATH 中包含 /usr/local/bin 和 /opt/homebrew/bin。可以通过以下命令快速修复：

$ echo 'export PATH="/usr/local/bin:/opt/homebrew/bin:$PATH"'>> ~/.zshrc && source ~/.zshrc
$ node -v && npm -v

⚠️ 小技巧：如果你在虚拟机中碰到网络访问慢的问题。可以先切换 npm 源为淘宝镜像，再执行后续步骤。 下面就来演示一次完整的 OpenClaw 一键安装吧！⚡️

四、快速一键安装 OpenClaw

bash curl -fsSL https://openclaw.ai/install.sh | bash **常见错误**：

错误	原因	方法
I understand this is personal-by-default …	安装脚本要求确认	按左右箭头选择 Yes 并回车
permission denied	文件权限不足	chmod +x install.sh 后重试
网络超时	网络被墙或慢速代理	切换 npm 源后重试

---

五、配置 OpenClaw

5.1 接受风险提示 & 启动模式

bash I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?│ ● Yes / ○ No

按 左右键 → Yes → 回车。

接下来选择启动模式：

bash Onboarding mode │ QuickStart # 推荐快速启动，无需繁琐设置。

5.2 AI 模型选择 & 提供 API Key

• 默认跳过模型选择 → 后面手动配置；
• 若已有模型 API，可直接填写。老实说，

5.3 网络搜索 & Skills 配置

均可暂时跳过；稍后想要启用功能再回来开启。

5.4 Hook 配置

全选 → 回车就可以完成。

---

六、验证是否成功

打开浏览器访问：

text 从http来看，//localhost:/#token=

再看例如。

bash 从http来看，//localhost:/#token=feaedb229ae3e48d804a740f56fdf3647117cf58d3a9a277

如果看到 Dashboard 页面即表示 OpenClaw 已经启动并可正常访问。

---

七、常用命令速查

bash openclaw gateway status # 查看网关状态 openclaw gateway start # 启动网关 openclaw gateway stop # 停止网关 openclaw gateway restart # 重启网关 openclaw gateway install # 安装网关服务

---

八、如何配置大模型

1. 购买云端大模型阿里云/OpenAI/腾讯云等提供 API Key。文档参考各网站官方说明，
2. 编辑配置文件

bash vim ~/.openclaw/openclaw.json # 打开文本编辑器，例如 vim 或 VS Code。

示例内容这方面，

jsoncjson { "models":。"agents": }

说到保存后执行，

bash openclaw gateway restart # 重启网关以加载新配置。

💡 小技巧若想快速测试。可以先使用免费版 OpenAI 的 gpt-3.5-turbo 模型，只需把上述 endpoint 替换为对应地址并填入自己的 API Key 即可。

---

• 保持程序和软件最新——特别是 macOS 和 Node.js，否则会出现兼容性问题。
• 提前设置 npm 镜像源——国内使用者请务必切换至淘宝镜像，否则下载包极慢甚至失败。
• 记录每一步日志——遇到错误时能迅速定位原因；建议将终端输出来保存或复制粘贴到 issue 跟踪中。
• 关注官方文档与社区讨论——OpenClaw 正在不断迭代，官方更新可能带来新特性或改动。

只要按以上步骤操作。你就能零踩坑顺利完成 MacOS 上的 OpenClaw 部署，并随时 自己的 AI 功能。祝编码愉快 🚀，