2026年MacBook M1 安装 OpenClaw 完整指南

MacBook M1 安装 OpenClaw 完整指南本文记录了在 MacBook M1 Apple Silicon 上安装 OpenClaw 的完整过程 包括遇到的坑和解决方案 OpenClaw 是一个开源的个人 AI 助手 可以连接 WhatsApp Telegram Discord Slack 等多种聊天平台 本文将详细介绍如何在 M1 Mac 上从零开始安装和配置 OpenClaw 要求 说明 Node js 22 必须是

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



本文记录了在 MacBook M1 (Apple Silicon) 上安装 OpenClaw 的完整过程,包括遇到的坑和解决方案。

OpenClaw 是一个开源的个人 AI 助手,可以连接 WhatsApp、Telegram、Discord、Slack 等多种聊天平台。本文将详细介绍如何在 M1 Mac 上从零开始安装和配置 OpenClaw。

要求 说明 Node.js ≥22, 必须是 ARM64 原生版本 操作系统 macOS (Apple Silicon) 包管理器 npm 或 pnpm

这是 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:

  1. Model/auth provider → 选择
  2. MiniMax auth method → 选择 (不要选 OAuth)
  3. Enter MiniMax API key → 输入你的 API Key
  4. Default model → 选择

注意:如果使用 API Key,一定要选择具体的模型(如 M2.1),不要选择 OAuth 方式。

可以先跳过,后续通过 添加:

讯享网

也可以先跳过,按需配置:

 

向导会自动安装 macOS LaunchAgent 服务:

讯享网

选择 Yes 启用命令补全,然后重新加载配置:

 

向导完成后会显示控制面板地址:

讯享网
 

正常输出:

讯享网

重要:不要直接访问 ,这样会因为缺少 Token 而无法连接。

正确做法是获取带 Token 的 URL:

 

复制输出的完整 URL(包含 )到浏览器打开。

路径 说明 主配置文件 Agent 工作区 凭证存储 会话记录 Gateway 日志 macOS 服务配置
命令 说明 查看版本 查看网关状态 获取带 Token 的控制面板 URL 查看整体状态 健康检查 诊断问题 添加聊天渠道 管理 Skills 配置网页搜索 安全审计 获取 Gateway Token

原因:你的 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 的关键点:

  1. 确保 Node.js 是 ARM64 版本 - 这是最容易踩的坑
  2. 使用 - 一键完成配置和服务安装
  3. 访问控制面板要带 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…


小讯
上一篇 2026-03-12 08:57
下一篇 2026-03-12 08:59

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/213928.html