以下是 macOS 上安裝 OpenClaw 的詳細(xì)流程，包含一鍵安裝、手動安裝、初始化配置、啟動與訪問及常見問題排查，覆蓋 Intel/M1/M2 全機(jī)型。
一、環(huán)境準(zhǔn)備（必做）
OpenClaw 依賴 Node.js ≥ 22（推薦 LTS 22/24），建議先安裝 Homebrew 方便管理依賴。
1. 安裝 Homebrew（如未裝）
打開終端（Command+空格 → 輸入 Terminal），執(zhí)行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
按提示輸入電腦密碼（輸入不顯示），等待完成。
驗(yàn)證：
brew --version
2. 安裝 Node.js（≥22）
# 安裝 Node.js 22 LTS
brew install node@22
# 驗(yàn)證版本
node --version # 應(yīng) ≥ v22.x.x
npm --version
也可直接下載 pkg 安裝：https://nodejs.org/zh-cn/download/
二、安裝 OpenClaw（兩種方式）
方式一：一鍵腳本安裝（推薦，新手首選）
自動檢測 Node.js、安裝 CLI、啟動配置向?qū)А?/p>
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
- 過程：自動下載依賴 → 全局安裝
openclawCLI → 自動啟動onboard配置向?qū)?/li> - 驗(yàn)證安裝：
openclaw --version
出現(xiàn)版本號（如 v2026.3.x）即成功。
方式二：手動 npm 安裝（適合自定義/網(wǎng)絡(luò)問題）
# 全局安裝最新版
npm install -g openclaw@latest
# 驗(yàn)證
openclaw --version
用 pnpm 更快：
pnpm add -g openclaw@latest
pnpm approve-builds -g # 批準(zhǔn)構(gòu)建腳本
三、初始化配置（onboard 向?qū)В?/h3>
一鍵安裝會自動啟動；手動安裝需手動執(zhí)行：
openclaw onboard --install-daemon
按終端提示完成：
-
風(fēng)險(xiǎn)提示：確認(rèn) OpenClaw 可執(zhí)行命令、訪問文件，輸入
y繼續(xù) -
選擇 Gateway 模式：選
local（本地運(yùn)行） -
配置 AI 提供商：
- OpenAI（需 API Key）
- Anthropic（Claude，需 API Key）
- Google Gemini
- 本地模型（Ollama 等）
- 輸入 API Key：粘貼對應(yīng)平臺的 Key
-
選擇模型：如
gpt-4o、claude-3-5-sonnet - 安全配置：開啟基礎(chǔ)防護(hù)（默認(rèn)即可）
-
完成：生成配置文件
~/.openclaw/
四、啟動與訪問
1. 啟動 OpenClaw 服務(wù)
openclaw start
- 首次啟動：生成本地配置、下載依賴、啟動網(wǎng)關(guān)
- 查看狀態(tài)：
openclaw status
2. 訪問 Web 控制面板（Dashboard）
openclaw dashboard
默認(rèn)在瀏覽器打開：http://localhost:3210
- 管理 AI 代理、查看日志、配置插件、執(zhí)行任務(wù)
3. 命令行交互（可選）
openclaw chat
直接在終端與 AI 對話。
五、常見問題排查
1. 命令找不到（command not found）
- 新開終端，或重載配置：
source ~/.zshrc # zsh（默認(rèn)）
# 或
source ~/.bashrc
- 檢查 PATH：
echo $PATH | grep npm
which openclaw
2. Node.js 版本過低
# 升級到 22+
brew upgrade node@22
# 或用 fnm 管理多版本
brew install fnm
fnm install 24
fnm use 24
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc
source ~/.zshrc
3. 安裝失敗/依賴沖突
清理舊版本后重裝：
npm uninstall -g clawdbot moltbot openclaw
rm -rf ~/.openclaw
# 重新一鍵安裝
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
4. 網(wǎng)絡(luò)慢/安裝卡住
切換 npm 鏡像：
npm config set registry https://registry.npmmirror.com
再執(zhí)行安裝命令。
六、常用命令速查
openclaw --version # 查看版本
openclaw onboard # 重新配置
openclaw start # 啟動服務(wù)
openclaw stop # 停止服務(wù)
openclaw status # 查看狀態(tài)
openclaw dashboard # 打開 Web 面板
openclaw chat # 終端對話
openclaw config edit # 編輯配置文件
