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

前言

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

環(huán)境要求

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

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

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

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

node -p "process.arch"

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

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

file $(which node)

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

安裝 ARM64 版本的 Node.js

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

# 1. 先切換到其他版本（因?yàn)椴荒苄遁d正在使用的版本）
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. 驗(yàn)證架構(gòu)
node -p "process.arch"  # 應(yīng)輸出: arm64

第二步：安裝 OpenClaw

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

npm install -g openclaw@latest

驗(yàn)證安裝：

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

第三步：運(yùn)行 Onboard 向?qū)?/h2>

這是配置 OpenClaw 的核心步驟：

openclaw onboard --install-daemon

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

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

3.2 選擇 Onboarding 模式

選擇 QuickStart，這是最簡(jiǎn)單的配置方式：

◇  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 配置聊天渠道

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

◇  Select channel (QuickStart)
│  → Skip for now

3.5 配置 Skills

也可以先跳過(guò)，按需配置：

◇  Configure skills now? (recommended)
│  → No

◇  Install missing skill dependencies
│  → Skip for now

3.6 安裝 Gateway 服務(wù)

向?qū)?huì)自動(dòng)安裝 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 補(bǔ)全

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

source ~/.zshrc

3.8 完成

向?qū)瓿珊髸?huì)顯示控制面板地址：

◇  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.

第四步：驗(yàn)證安裝

檢查 Gateway 狀態(tài)

openclaw gateway status

正常輸出：

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

訪問(wèn)控制面板

重要：不要直接訪問(wèn) http://127.0.0.1:18789/，這樣會(huì)因?yàn)槿鄙?Token 而無(wú)法連接。

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

openclaw dashboard --no-open

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

重要文件路徑

常用命令速查

常見(jiàn)問(wèn)題 FAQ

Q1: 安裝時(shí)報(bào)錯(cuò) "llama.cpp is not supported under Rosetta"

原因：你的 Node.js 是 x86_64 版本，在 Apple Silicon Mac 上通過(guò) Rosetta 運(yùn)行。

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

驗(yàn)證方法：

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

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

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

解決方案：

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

openclaw dashboard --no-open

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

方法二：手動(dòng)獲取 Token

openclaw config get gateway.auth.token

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

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

openclaw doctor --generate-gateway-token

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

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

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

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

需要配置 Brave Search API Key：

openclaw configure --section web

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

openclaw channels add

Q6: Gateway 服務(wù)沒(méi)有啟動(dòng)怎么辦？

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

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

openclaw onboard --install-daemon

總結(jié)

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

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

完成以上步驟后，就可以通過(guò)瀏覽器訪問(wèn) OpenClaw 控制面板，開(kāi)始體驗(yàn) AI 助手了！??

參考鏈接

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

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

最新評(píng)論