嘿，朋友！今天咱们来聊聊怎么在 M1 版的 MacBook 上安装 OpenClaw。说实话，这玩意儿一开始我也没搞懂，踩了不少坑，不过现在总算顺了来分享一下经验哈～

先说重点：为啥要在 M1 上装 OpenClaw？

害，你懂的，M1 芯片性Neng强，功耗低，本地跑 AI 模型简直不要太爽。OpenClaw 是个本地 AI 助手，Neng帮你自动化处理hen多事，比如聊天、文件处理、甚至帮你写代码。

不过呢，M1 是 ARM 架构，hen多开源项目还没完全适配好，所以安装的时候容易出岔子。别急，咱慢慢来一步步搞定它。

第一步：确认你的 Node.js 是 ARM64 版本

这一步特别重要，不然你后面会遇到一堆奇怪的错误，比如依赖编译失败、segment fault 什么的，我一开始就被坑惨了。

你得先确认你用的是原生 ARM64 的 Node.js，不是通过 Rosetta 跑的 x86 版本。怎么查？hen简单：

node -p "process.arch"

Ru果输出是 arm64，那恭喜你，Ke以继续了。Ru果是 x64，那你得重新装个 ARM 原生版的 Node.js，不然后面装 node-llama-cpp 这类依赖的时候会直接报错。

我推荐用 nvm 来管理 Node.js 版本，这样切换起来方便。不过注意，别直接用 nvm install，要用这个命令强制用 ARM64 架构安装：

arch -arm64 /bin/zsh -c "export NVM_DIR=~/.nvm && source ~/.nvm/nvm.sh && nvm install 18"

装完记得设置默认版本：

nvm alias default 18
nvm use default

再跑一次 node -p "process.arch"，确认是 arm64 就 OK 了。

第二步：安装 OpenClaw

确认 Node.js 没问题后就Ke以正式安装 OpenClaw 了。直接用 npm 安装：

npm install -g openclaw@latest

装完后验证一下版本：

openclaw --version

Ru果输出类似 2026.2.6-3 这样的版本号，说明安装成功啦！🎉

第三步：初始化配置

安装完后得跑一下初始化向导，这一步会帮你配置 Gateway 服务、Token、Shell 补全啥的，非常关键：

openclaw onboard --install-daemon

向导会提示你一堆配置项，比如 Gateway 端口、Token 认证、是否启用 Tailscale、是否配置技Neng等。你Ke以选择 QuickStart 模式，Zui省心。

比如这个输出就说明 Gateway 服务装好了：

◇  Gateway service installed.
Service: LaunchAgent 
Runtime: running 
RPC probe: ok
Listening: 127.0.0.1:8080

然后它会给你一个控制面板地址，比如：

Web UI: http://127.0.0.1:8080#token=xxxxxx

记住别直接访问 http://127.0.0.1:8080，一定要带 Token，不然会提示你 unauthorized，害我一开始就被这个坑了。

第四步：访问控制面板

你Ke以用这个命令获取带 Token 的链接：

openclaw dashboard --no-open

然后复制输出的 URL，粘贴到浏览器里打开。Token 会自动保存在浏览器的 localStorage 里之后就不用再输 Token 啦。

Ru果你不小心丢了 Token，也Ke以重新生成：

openclaw doctor --generate-gateway-token

第五步：配置模型和技Neng

OpenClaw 支持接入各种大模型，比如百川、MiniMax、Llama 等。你Ke以通过配置文件或命令行来设置模型认证信息：

openclaw configure --section model

Ru果你用的是 MiniMax，记得选具体的模型，比如 M2，别用 OAuth，不然会出问题。

技NengKe以按需配置，也Ke以先跳过后面再加：

openclaw skills add

常见问题和解决方法 Q1：Gateway 服务启动失败怎么办？

Ke以手动加载服务：

launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist

或者前台调试运行：

openclaw gateway --port 8080 --verbose

Q2：控制面板提示 Token 缺失？

别慌，用这个命令获取带 Token 的链接：

openclaw dashboard --no-open

然后复制完整 URL 打开浏览器就行啦。

Q3：如何添加 Telegram、Discord 等聊天平台？

用这个命令添加：

openclaw channels add

它会引导你一步步配置，比如 Token、Webhook 地址啥的，挺方便的。

Q4：AI 不Neng上网搜索？

你需要配置 Brave Search API Key：

openclaw configure --section web

然后 AI 就Neng帮你查资料啦，比如“今天天气怎么样”这种问题它就Neng自己去网上找答案。

Zui后一下

在 M1 Mac 上装 OpenClaw，关键就几个：

Node.js 必须是 ARM64 原生版

别用 x86 的版本，不然依赖会炸

Token 一定要带，不然进不去控制面板

Gateway 服务记得启动，不然本地跑不起来

搞定这些，你就Neng愉快地在本地跑 AI 助手啦！🦞

说实话，一开始我也被 Rosetta 和架构问题搞得hen头大，不过现在跑起来之后感觉真香。你要是也想在本地跑 AI，M1 + OpenClaw 绝对是个不错的选择。

好了今天就聊到这有问题随时来问我哈～

---