本文記錄了在 MacBook M1 (Apple Silicon) 上安裝 OpenClaw 的完整過程，包括遇到的坑和解決方案。

前言

OpenClaw 是一個開源的個人 AI 助手，可以連接 WhatsApp、Telegram、Discord、Slack 等多種聊天平臺。本文將詳細(xì)介紹如何在 M1 Mac 上從零開始安裝和配置 OpenClaw。

環(huán)境要求

第一步：檢查 Node.js 架構(gòu)

這是 M1 Mac 上最容易踩的坑！

很多人通過 nvm 安裝的 Node.js 實際上是 x86_64 版本（通過 Rosetta 運行），這會導(dǎo)致 OpenClaw 的 node-llama-cpp 依賴安裝失敗。

檢查當(dāng)前架構(gòu)

node -p "process.arch"

如果輸出是 x64，說明你安裝的是 x86_64 版本，需要重新安裝。

也可以用這個命令確認(rèn)：

file $(which node)

正確的輸出應(yīng)該包含 arm64，而不是 x86_64。

安裝 ARM64 版本的 Node.js

如果你用 nvm 管理 Node.js，按以下步驟操作：

# 1. 先切換到其他版本（因為不能卸載正在使用的版本）
source ~/.nvm/nvm.sh
nvm use 20  # 或其他已安裝版本
# 2. 卸載 x86_64 版本
nvm uninstall 22
# 3. 在 ARM64 環(huán)境下重新安裝
arch -arm64 /bin/zsh -c "export NVM_DIR=~/.nvm && source ~/.nvm/nvm.sh && nvm install 22"
# 4. 設(shè)置為默認(rèn)版本
nvm alias default 22
nvm use default
# 5. 驗證架構(gòu)
node -p "process.arch"  # 應(yīng)輸出: arm64

第二步：安裝 OpenClaw

確認(rèn) Node.js 架構(gòu)正確后，安裝 OpenClaw：

npm install -g openclaw@latest

驗證安裝：

openclaw --version
# 輸出: 2026.2.6-3 (或更新版本)

第三步：運行 Onboard 向?qū)?/h2>

這是配置 OpenClaw 的核心步驟：

openclaw onboard --install-daemon

3.1 安全警告確認(rèn)

向?qū)紫葧@示安全警告，提醒你 OpenClaw 可以讀取文件和執(zhí)行操作。確認(rèn)后選擇 Yes 繼續(xù)。

3.2 選擇 Onboarding 模式

選擇 QuickStart，這是最簡單的配置方式：

◇  QuickStart ─────────────────────────╮
│                                      │
│  Gateway port: 18789                 │
│  Gateway bind: Loopback (127.0.0.1)  │
│  Gateway auth: Token (default)       │
│  Tailscale exposure: Off             │
│                                      │
├──────────────────────────────────────╯

3.3 配置模型認(rèn)證

我使用的是 MiniMax API Key：

1. Model/auth provider → 選擇 MiniMax
2. MiniMax auth method → 選擇 MiniMax M2.1（不要選 OAuth）
3. Enter MiniMax API key → 輸入你的 API Key
4. Default model → 選擇 Keep current (minimax/MiniMax-M2.1)

注意：如果使用 API Key，一定要選擇具體的模型（如 M2.1），不要選擇 OAuth 方式。

3.4 配置聊天渠道

可以先跳過，后續(xù)通過 openclaw channels add 添加：

◇  Select channel (QuickStart)
│  → Skip for now

3.5 配置 Skills

也可以先跳過，按需配置：

◇  Configure skills now? (recommended)
│  → No

◇  Install missing skill dependencies
│  → Skip for now

3.6 安裝 Gateway 服務(wù)

向?qū)詣影惭b macOS LaunchAgent 服務(wù)：

?  Installing Gateway service…...
Installed LaunchAgent: ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Logs: ~/.openclaw/logs/gateway.log
◇  Gateway service installed.

3.7 配置 Shell 補全

選擇 Yes 啟用命令補全，然后重新加載配置：

source ~/.zshrc

3.8 完成

向?qū)瓿珊髸@示控制面板地址：

◇  Control UI ─────────────────────────────────────────────────────────────────────╮
│                                                                                  │
│  Web UI: http://127.0.0.1:18789/                                                 │
│  Web UI (with token):                                                            │
│  http://127.0.0.1:18789/#token=xxxxxx                                            │
│                                                                                  │
├──────────────────────────────────────────────────────────────────────────────────╯
└  Onboarding complete. Use the dashboard link above to control OpenClaw.

第四步：驗證安裝

檢查 Gateway 狀態(tài)

openclaw gateway status

正常輸出：

Service: LaunchAgent (loaded)
Runtime: running (pid xxxx)
RPC probe: ok
Listening: 127.0.0.1:18789

訪問控制面板

重要：不要直接訪問 http://127.0.0.1:18789/，這樣會因為缺少 Token 而無法連接。

正確做法是獲取帶 Token 的 URL：

openclaw dashboard --no-open

復(fù)制輸出的完整 URL（包含 #token=xxx）到瀏覽器打開。

重要文件路徑

常用命令速查

常見問題 FAQ

Q1: 安裝時報錯 "llama.cpp is not supported under Rosetta"

原因：你的 Node.js 是 x86_64 版本，在 Apple Silicon Mac 上通過 Rosetta 運行。

解決方案：按照本文「第一步」的方法，卸載 x86_64 版本，安裝 ARM64 原生版本。

驗證方法：

node -p "process.arch"  # 應(yīng)輸出: arm64
file $(which node)      # 應(yīng)包含: arm64

Q2: 控制面板顯示 "unauthorized: gateway token missing" 或 "gateway token mismatch"

原因：直接訪問 http://127.0.0.1:18789/ 沒有帶 Token 認(rèn)證。

解決方案：

方法一（推薦）：使用命令獲取帶 Token 的鏈接

openclaw dashboard --no-open

復(fù)制輸出的完整 URL 到瀏覽器打開。

方法二：手動獲取 Token

openclaw config get gateway.auth.token

然后在控制面板的設(shè)置中粘貼 Token。

方法三：如果 Token 丟失，重新生成

openclaw doctor --generate-gateway-token

Token 首次加載后會保存在瀏覽器的 localStorage 中，之后訪問無需重復(fù)輸入。

Q3: 如何查看 Node.js 架構(gòu)？

# 方法 1
node -p "process.arch"
# 方法 2
file $(which node)

Q4: 如何讓 AI 能搜索網(wǎng)頁？

需要配置 Brave Search API Key：

openclaw configure --section web

Q5: 如何添加聊天渠道（Telegram/Discord/WhatsApp 等）？

openclaw channels add

Q6: Gateway 服務(wù)沒有啟動怎么辦？

# 檢查狀態(tài)
openclaw gateway status
# 手動加載服務(wù)
launchctl load ~/Library/LaunchAgents/ai.openclaw.gateway.plist
# 或者前臺運行（調(diào)試用）
openclaw gateway --port 18789 --verbose

Q7: 如何重新運行 onboard 向?qū)В?/h3>

openclaw onboard --install-daemon

總結(jié)

在 M1 Mac 上安裝 OpenClaw 的關(guān)鍵點：

1. 確保 Node.js 是 ARM64 版本 - 這是最容易踩的坑
2. 使用 openclaw onboard --install-daemon - 一鍵完成配置和服務(wù)安裝
3. 訪問控制面板要帶 Token - 使用 openclaw dashboard --no-open 獲取完整 URL

完成以上步驟后，就可以通過瀏覽器訪問 OpenClaw 控制面板，開始體驗 AI 助手了！??

參考鏈接

• 官方文檔: docs.openclaw.ai
• 中文文檔
• GitHub
• 安全指南
• 控制面板文檔
• Token 問題排查

到此這篇關(guān)于MacBook M1安裝OpenClaw完整指南的文章就介紹到這了,更多相關(guān)MacBook M1安裝OpenClaw內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論