本文记录了在 MacBook M1 (Apple Silicon) 上安装 OpenClaw 的完整过程,包括遇到的坑和解决方案。
OpenClaw 是一个开源的个人 AI 助手,可以连接 WhatsApp、Telegram、Discord、Slack 等多种聊天平台。本文将详细介绍如何在 M1 Mac 上从零开始安装和配置 OpenClaw。
这是 M1 Mac 上最容易踩的坑!
很多人通过 nvm 安装的 Node.js 实际上是 x86_64 版本(通过 Rosetta 运行),这会导致 OpenClaw 的 依赖安装失败。
GPT plus 代充 只需 145
如果输出是 ,说明你安装的是 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…
- 控制面板文档: docs.openclaw.ai/web/control…
- Token 问题排查: clawd.org.cn/gateway/tok…
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/213928.html