MacOS系統(tǒng)安裝OpenClaw安裝避坑指南！保姆級教程，零踩坑

大家好，我是星哥！最近很多朋友問我 MacOS 怎么裝 OpenClaw，踩了不少坑才摸透流程 —— 不管你是 Intel 芯片還是 M 系列的 Mac，哪怕是用 VMware 虛擬的 MacOS 系統(tǒng)，跟著我這篇教程走，從依賴安裝到配置大模型，一步都不踩雷！

一、系統(tǒng)準(zhǔn)備 1、兼容性確認(rèn)

• ? 官方最低要求： macOS 12+ （Monterey 及以上）

• ? 芯片：Intel / Apple Silicon 均兼容

OpenClaw 基于 Node.js 開發(fā)，必須先裝：

1. 1. Node.js ≥ v22 （推薦 LTS）

2. 2. npm ≥ 9 （隨 Node.js 一起安裝）

3. 3. （推薦） Homebrew ，方便管理依賴

二、前期準(zhǔn)備(準(zhǔn)備MacOS)

星哥的測試環(huán)境，由于手頭目前沒有macos系統(tǒng)，只能使用VMware中虛擬機(jī)，虛擬出來的macos系統(tǒng)

具體可以參考：

MacOS打開SSH(非必須)

為了操作方便，遠(yuǎn)程管理這個macos

打開「終端」（應(yīng)用程序 → 實用工具 → 終端）

                                                           sudo systemsetup -setremotelogin on

輸入管理員密碼，回車確認(rèn)。

查看 SSH 服務(wù)狀態(tài)：

                                                           sudo systemsetup -getremotelogin

這樣就可以遠(yuǎn)程操作我的macos了

sw_vers查看系統(tǒng)版本

                                                           star@stardeMac ~ % sw_vers        
ProductName:            macOS
ProductVersion:         15.3
BuildVersion:           24D60

打開終端（Terminal）。

                                                           # 輸入按回車
xcode-select --install

在直接輸入git按回車

根據(jù)提示進(jìn)行安裝

2.安裝brew

粘貼并運(yùn)行以下命令

                                                           # 腳本由國內(nèi)開發(fā)者維護(hù)，會自動幫你選擇鏡像源并完成安裝
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"


 # github
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

選擇1 或者 2(通過GItee下載brew) 推薦

根據(jù)提示 輸入開機(jī)密碼

根據(jù)提示按回車

3.查看brew版本

                                                           brew -v

                                                           > ~/.zshrc

# 使配置立即生效
source ~/.zshrc

# 驗證版本
node -v  # 應(yīng) ≥ v22.0.0
npm -v   # 應(yīng) ≥ 9.0.0" data-show-line-number="false"># 安裝 Node.js 22
brew install node@22

 # 將路徑寫入 .zshrc
echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc

 # 使配置立即生效
source ~/.zshrc

 # 驗證版本
node -v  # 應(yīng) ≥ v22.0.0
npm -v   # 應(yīng) ≥ 9.0.0

                                                           # 4. 一鍵安裝 OpenClaw（官方腳本）
curl -fsSL https://openclaw.ai/install.sh | bash

出現(xiàn)如下，說明安裝成功。

                                                           I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│  ● Yes / ○ No

左右鍵 選擇Yes,按回車確定

2.更換為國內(nèi)淘寶源(非必須操作)

                                                           # 查看當(dāng)前的鏡像源
npm get registry

 # 配置為淘寶 npm 鏡像源
npm config set registry https://registry.npmmirror.com

 # 關(guān)閉證書驗證（這個很關(guān)鍵）
npm config set strict-ssl false

 # 強(qiáng)制清空 npm 本地緩存
npm cache clean --force

                                                           I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│  ● Yes / ○ No

推薦選擇 QuickStart 快速啟動：

                                                             Onboarding mode
│  QuickStart

這里選擇最后一個Skip for now 跳過,后面在去配置

也可以選擇任意一個，只要你有apikey

4.模型供應(yīng)商:

選擇所有供應(yīng)商

5.設(shè)置默認(rèn)model

選擇默認(rèn)即可,后面還會配置模型

6.選擇聊天工具:

這里選擇最后一個Skip for now 跳過,后面在去配置

7.選擇網(wǎng)絡(luò)搜索:

這里也是跳過

8.配置skills:

這里也是跳過

9 配置hooks:

全選,按上下鍵,按空格鍵選中,最后按回車鍵

安裝成功

                                                           How do you want to hatch your bot?
│  Open the Web UI
│
◇  Dashboard ready ────────────────────────────────────────────────────────────────╮
│                                                                                  │
│  Dashboard link (with token):                                                    │
│  http://127.0.0.1:18789/=feaedb229ae3e48d804a740f56fdf3647117cf58d3a9a277  │
│  Copy/paste this URL in a browser on this machine to control OpenClaw.           │
│  No GUI detected. Open from your computer:                                       │
│  ssh -N -L 18789:127.0.0.1:18789 star@192.168.1.144                              │
│  Then open:                                                                      │
│  http://localhost:18789/                                                         │
│  http://localhost:18789/=feaedb229ae3e48d804a740f56fdf3647117cf58d3a9a277  │
│  Docs:                                                                           │
│  https://docs.openclaw.ai/gateway/remote                                         │
│  https://docs.openclaw.ai/web/control-ui                                         │
│                                                                                  │
├──────────────────────────────────────────────────────────────────────────────────


 star@stardeMac ~ % openclaw --version
OpenClaw 2026.3.8 (3caab92)

驗證

使用瀏覽器打開

                                                           http://localhost:18789/=feaedb229ae3e48d804a740f56fdf3647117cf58d3a9a277

六、常用命令

                                                           openclaw gateway status 網(wǎng)關(guān)狀態(tài)
openclaw gateway 一次性啟動網(wǎng)關(guān)
openclaw gateway stop 網(wǎng)關(guān)服務(wù)停
openclaw gateway start 網(wǎng)關(guān)服務(wù)開
openclaw gateway restart 網(wǎng)關(guān)服務(wù)重啟
openclaw gateway install 安裝網(wǎng)關(guān)服務(wù)

需要購買大模型.平臺參考:阿里云coding plan\騰訊云 coding plan\火山引擎 coding plan\優(yōu)云智算 等等.

訂閱相關(guān)服務(wù),會提供相關(guān)代碼.

用文本編輯器編輯文件: ~/.openclaw/openclaw.json

(打開訪達(dá)--->前往文件夾)

補(bǔ)充內(nèi)容

主要是“models” “agents”參數(shù)

保存文件后,重啟網(wǎng)關(guān)服務(wù),即可與大模型對話

執(zhí)行:openclaw gateway restart

需要更強(qiáng)功能需要配置各種skills

總結(jié)

以上就是星哥親測的 MacOS 安裝 OpenClaw 全流程，從系統(tǒng)準(zhǔn)備到網(wǎng)關(guān)配置、大模型對接，每一步都是實操過的干貨。如果安裝過程中遇到問題，評論區(qū)留言，星哥看到都會回復(fù)！覺得有用的話，記得點(diǎn)贊收藏，后續(xù)還會分享 OpenClaw 的進(jìn)階玩法，比如自定義 skills、多模型切換，關(guān)注我不迷路～