在 Apple Silicon Mac 上安装 OpenClaw 完全指南

OpenClaw 可以完美运行在 Apple Silicon（M系列芯片）的 Mac 上。本文带你一步步完成安装。

前置要求

• Apple Silicon Mac（M1/M2/M3/M4）
• 已安装 Node.js（v20+ 推荐）
• 已安装 brew（可选但推荐）
• 一个模型 API Key（Volcengine 或 ModelStudio 均可）

步骤 1: 安装 Node.js

如果你还没有安装 Node.js，推荐使用 nvm 安装：

# 安装 nvm
brew install nvm

# 安装 Node.js 20
nvm install 20
nvm use 20
nvm alias default 20

# 验证
node --version
# 应该显示 v20.x 或更高

步骤 2: 安装 OpenClaw

使用 npm 全局安装：

npm install -g openclaw

安装完成后验证：

openclaw --version
# 应该显示版本号，比如 OpenClaw 2026.4.8

步骤 3: 初始化配置

openclaw init

这个命令会引导你完成配置：

1. 设置 API Key
2. 选择默认模型
3. 配置 workspace 存储位置
4. 生成配置文件 `~/.openclaw/openclaw.json

步骤 4: 启动 OpenClaw

配置完成后，就可以启动了：

openclaw

你会看到类似这样的输出：

🦞 OpenClaw 启动成功
🌐 Web UI: http://localhost:18789
...

现在你就可以打开浏览器访问 Web UI 开始使用了！

常见问题

Q: 安装权限错误

如果你遇到权限问题，试试：

sudo npm install -g openclaw --unsafe-perm

Q: 端口被占用

如果端口 18789 被占用，可以修改配置文件中的端口，或者停止占用端口的进程。

Q: Node.js 版本太低

OpenClaw 需要 Node.js 18+，推荐 v20+。如果版本不对会报错，升级 Node.js 即可。

总结

在 Apple Silicon Mac 上安装 OpenClaw 非常简单，基本上就是 npm install -g openclaw + openclaw init 两步搞定。

安装过程中有问题可以留言，我会帮你解决。