🦞 OpenClaw 安装踩坑实录（M1 Mac 版）

适用人群：Apple Silicon（M1/M2/M3）Mac 用户
最终成果：成功装上 OpenClaw，77万 token 瞬间蒸发 💸

📦 第一步：安装 Node.js 22（最大坑点）

M1 Mac 最大的坑就是架构问题。一定要装 arm64 版本的 Node！

# 使用 arch -arm64 强制安装 arm64 版 Node
arch -arm64 brew install node@22

✅ 安装后必须验证架构

node -p "process.arch"
# **必须输出：arm64！！！**
# 如果输出 x64，说明你还在坑里

🕳️ 常见错误及解决方案

错误 1：安装完还是 x64

现象：node -p "process.arch" 输出 x64
原因：终端本身在 Rosetta 下运行

# 强制当前终端切换到 arm64 模式
arch -arm64 zsh

# 再次验证
arch  # 应该输出 arm64
node -p "process.arch"  # 应该输出 arm64

错误 2：iTerm 版本太老

现象：切换后 node -p "process.arch" 依然 x64
原因：老版 iTerm 本身是 x86 架构

解决方案：升级到 iTerm2

# 1. 官网下载最新版 iTerm2
open https://iterm2.com/

# 2. 在 iTerm2 中强制启动原生 shell
/usr/bin/arch -arm64 /bin/zsh

# 3. 验证
arch  # 现在应该是 arm64

错误 3：需要彻底重装 Node

# 删除原有的 x86 版 Node
brew uninstall --ignore-dependencies node
brew uninstall --force node@22

# 重新安装 arm64 版 Node
arch -arm64 brew install node@22

错误 4：Homebrew 本身是 x86 版

现象：which brew 显示 /usr/local/bin/brew（这是 Intel 版路径）
正确路径：arm64 版应该在 /opt/homebrew/bin/brew

# 卸载现有 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

# 安装 arm64 版 Homebrew（会自动装在 /opt/homebrew）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

🚀 第二步：安装 OpenClaw

方法一：一键安装脚本（推荐）

curl -fsSL https://openclaw.ai/install.sh | bash

方法二：npm 安装（如果遇到问题）

# 如果一键安装失败，用 verbose 模式查看详细日志
npm install -g openclaw@latest --verbose

🔒 常见安装错误：SSL 证书验证失败

错误信息：

18 error code UNABLE_TO_GET_ISSUER_CERT_LOCALLY
20 error request to https://registry.npmjs.org/openclaw failed, reason: unable to get local issuer certificate

原因：npm 无法验证 npmjs.org 的 SSL 证书（国内网络常见问题）

解决方案：

# 临时关闭 SSL 严格验证
npm config set strict-ssl false

# 重新安装
npm install -g openclaw@latest --verbose

# 安装成功后重新开启（安全起见）
npm config set strict-ssl true

✅ 第三步：验证安装

# 查看版本
openclaw --version  # 应该显示 2026.x.x

# 运行健康检查
openclaw doctor

# 运行简单命令测试
openclaw --help

🚀 第四步：启动 OpenClaw

# 1. 启动配置向导（会安装 LaunchAgent 守护进程）
openclaw onboard --install-daemon

# 2. 启动网关服务
openclaw gateway start

# 3. 查看服务状态
openclaw status

# 4. 启动 Web 控制台
openclaw dashboard  # 会自动打开 http://127.0.0.1:18789/?token=xxx

⏸️ 如何关闭 OpenClaw

# 临时停止服务
openclaw gateway stop

# 查看状态确认
openclaw status

# 彻底卸载（慎重！会删除所有配置和数据）
openclaw uninstall --all --yes
npm rm -g openclaw

💸 血泪教训：77万 token 是怎么没的？

OpenClaw 安装成功后，我只简单聊了几句：

让它帮我删了两个文件 ✅
让它帮我改了一下简历 ✅
然后发现：77万 token 没了！

给新手的忠告：

开通阿里云百炼后，记得在控制台设置额度预警
刚开始玩用按量付费，别急着买套餐
每次对话前，先确认用的模型是不是免费的（比如 qwen3.5-plus 是收费的 😭）

📝 总结

M1 Mac 用户最大的坑是架构：时刻记住用 arch -arm64 前缀
终端一定要用 arm64 模式：老版 iTerm 果断升级
Homebrew 也要 arm64 版：安装路径在 /opt/homebrew
网络问题就关 strict-ssl：装完记得重新开启
token 不是无限的：且用且珍惜

如果这篇文章帮到了你，欢迎点赞收藏。
如果你也踩了别的坑，欢迎评论区补充。
我去搬砖赚 token 了 😭