本文记录了在 MacBook M1 (Apple Silicon) 上安装 OpenClaw 的完整过程，包括遇到的坑和解决方案。
OpenClaw 是一个开源的个人 AI 助手，可以连接 WhatsApp、Telegram、Discord、Slack 等多种聊天平台。本文将详细介绍如何在 M1 Mac 上从零开始安装和配置 OpenClaw。
这是 M1 Mac 上最容易踩的坑！
很多人通过 nvm 安装的 Node.js 实际上是 x86_64 版本（通过 Rosetta 运行），这会导致 OpenClaw 的 依赖安装失败。
如果输出是 ，说明你安装的是 x86_64 版本，需要重新安装。
也可以用这个命令确认：
正确的输出应该包含 ，而不是 。
如果你用 nvm 管理 Node.js，按以下步骤操作：
确认 Node.js 架构正确后，安装 OpenClaw：
验证安装：
这是配置 OpenClaw 的核心步骤：
向导首先会显示安全警告，提醒你 OpenClaw 可以读取文件和执行操作。确认后选择 Yes 继续。
选择 QuickStart，这是最简单的配置方式：
我使用的是 MiniMax API Key：
- Model/auth provider → 选择
- MiniMax auth method → 选择 （不要选 OAuth）
- Enter MiniMax API key → 输入你的 API Key
- Default model → 选择
注意：如果使用 API Key，一定要选择具体的模型（如 M2.1），不要选择 OAuth 方式。
可以先跳过，后续通过 添加：
也可以先跳过，按需配置：
向导会自动安装 macOS LaunchAgent 服务：
选择 Yes 启用命令补全，然后重新加载配置：
向导完成后会显示控制面板地址：
正常输出：
重要：不要直接访问 ，这样会因为缺少 Token 而无法连接。
正确做法是获取带 Token 的 URL：
复制输出的完整 URL（包含 ）到浏览器打开。
原因：你的 Node.js 是 x86_64 版本，在 Apple Silicon Mac 上通过 Rosetta 运行。
解决方案：按照本文「第一步」的方法，卸载 x86_64 版本，安装 ARM64 原生版本。
验证方法：
原因：直接访问 没有带 Token 认证。
解决方案：
方法一（推荐）：使用命令获取带 Token 的链接
复制输出的完整 URL 到浏览器打开。
方法二：手动获取 Token
然后在控制面板的设置中粘贴 Token。
方法三：如果 Token 丢失，重新生成
Token 首次加载后会保存在浏览器的 localStorage 中，之后访问无需重复输入。
需要配置 Brave Search API Key：
在 M1 Mac 上安装 OpenClaw 的关键点：
- 确保 Node.js 是 ARM64 版本 – 这是最容易踩的坑
- 使用 – 一键完成配置和服务安装
- 访问控制面板要带 Token – 使用 获取完整 URL
完成以上步骤后，就可以通过浏览器访问 OpenClaw 控制面板，开始体验 AI 助手了！🦞
- 官方文档: docs.openclaw.ai
- 中文文档: clawcn.net/start/getti…
- GitHub: github.com/openclaw/op…
- 安全指南: docs.openclaw.ai/gateway/sec…openclaw
- 控制面板文档: docs.openclaw.ai/web/control…
- Token 问题排查: clawd.org.cn/gateway/tok…
发布者：Ai探索者，转载请注明出处：https://javaforall.net/254717.html原文链接：https://javaforall.net
