既然你想在自己的Mac上部署OpenClaw，那我就給你一份2026年最新、最詳細(xì)、最靠譜的“養(yǎng)龍蝦”指南。按照這個教程操作，哪怕你是技術(shù)小白，也能在30分鐘內(nèi)讓你的Mac“長出”一只能干活的小龍蝦。

本文整合了阿里云開發(fā)者社區(qū)、騰訊云技術(shù)百科、Apifox等多方權(quán)威教程，所有命令均可直接復(fù)制執(zhí)行。

一、部署前必讀：你的Mac夠格“養(yǎng)蝦”嗎？

1.1 硬件要求（別擔(dān)心，要求不高）

1.2 你需要準(zhǔn)備的東西

• 一個API Key：OpenClaw需要大模型“大腦”才能理解指令，推薦使用阿里云百煉（新用戶有免費(fèi)額度）或OpenAI API
• 穩(wěn)定的網(wǎng)絡(luò)：安裝過程需要下載依賴包
• 耐心：大概15-30分鐘

二、Step 1：安裝Homebrew（Mac的“應(yīng)用商店”）

Homebrew是Mac上必備的包管理器，后續(xù)很多依賴都要靠它安裝。打開終端（Terminal），執(zhí)行：

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

安裝完成后，根據(jù)終端提示運(yùn)行接下來的兩條命令（通常是讓你把brew加入環(huán)境變量）。

驗證安裝：

brew --version # 輸出版本號即成功，如下圖所示：

三、Step 2：安裝Node.js（OpenClaw的運(yùn)行環(huán)境）

OpenClaw基于Node.js開發(fā)，需要v22.0.0及以上版本。

# 安裝Node.js 24.x LTS（推薦）
brew install node@24
# 將node加入PATH
echo 'export PATH="/usr/local/opt/node@24/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 驗證安裝
node --version  # 應(yīng)顯示 v24.x.x
npm --version   # 應(yīng)顯示 10.x.x

安裝成功后，如下圖所示：

小貼士：如果你需要管理多個Node版本，可以安裝nvm：

brew install nvm
nvm install --lts
nvm use --lts

可選但推薦：安裝Redis

Redis用于提升OpenClaw的記憶和任務(wù)隊列能力：

brew install redis
brew services start redis
redis-cli ping  # 返回PONG即成功，如下圖所示：

四、Step 3：安裝OpenClaw（核心步驟）

4.1 一鍵安裝腳本（最簡單，推薦）

OpenClaw官方提供了一鍵安裝腳本，會自動處理所有依賴：

curl -fsSL https://openclaw.ai/install.sh | bash

或者指定安裝 beta版（2026年最新版）：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- -Tag beta

安裝完成后，需要重新加載終端配置：

source ~/.zshrc

驗證安裝：

openclaw --version 
# 應(yīng)顯示 2026.x.x 版本號

安裝成功后，如下圖所示：

4.2 如果一鍵腳本失?。▊溆梅桨福菏謩影惭b）

如果網(wǎng)絡(luò)原因?qū)е乱绘I腳本失敗，可以嘗試手動安裝：

# 全局安裝
npm install -g openclaw@latest
# 如果遇到sharp模塊報錯（常見于M芯片Mac）
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

4.3 解決“command not found”問題

如果安裝后輸入openclaw提示找不到命令，說明npm全局路徑?jīng)]加到環(huán)境變量：

# 找到npm全局路徑
npm prefix -g
# 假設(shè)輸出是 /usr/local，則二進(jìn)制路徑是 /usr/local/bin
# 添加到環(huán)境變量
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

五、Step 4：初始化配置（Onboarding向?qū)В?/h2>

安裝完成后，需要運(yùn)行初始化向?qū)砼渲肙penClaw：

openclaw onboard --install-daemon

這個向?qū)徊讲揭龑?dǎo)你完成關(guān)鍵配置，以下是詳細(xì)步驟：

5.1 交互式配置步驟

5.2 驗證初始化狀態(tài)

# 健康檢查
openclaw doctor

這個命令非常重要，運(yùn)行后出現(xiàn)下面界面：

選擇Yes，后出現(xiàn)下面的界面：

選擇Yes,出現(xiàn)下面的界面：

# 查看服務(wù)狀態(tài) 
openclaw status

通過openclaw status可以看到非常多的openclaw狀態(tài)信息：

六、Step 5：配置Gateway服務(wù)

Gateway是OpenClaw的核心服務(wù)，負(fù)責(zé)消息調(diào)度、任務(wù)執(zhí)行和Web控制臺。

6.1 配置Gateway模式

# 設(shè)置Gateway為本地模式
openclaw config set gateway.mode local

運(yùn)行命令openclaw config set gateway.mode local后，出現(xiàn)下面界面：

上圖的意思是：你已經(jīng)成功設(shè)置了Gateway的本地模式，現(xiàn)在只需要重啟Gateway服務(wù)就能讓配置生效了。立即執(zhí)行：

openclaw gateway restart

看到這個輸出說明OpenClaw的Gateway服務(wù)已經(jīng)以LaunchAgent（macOS后臺服務(wù)）的形式重新啟動了。gui/501/ 表示它是在你的用戶權(quán)限下運(yùn)行的，501是你的用戶ID

6.2 啟動Gateway服務(wù)

# 啟動服務(wù)
openclaw gateway start

成功如下圖所示：

看到這個友好的輸出——“I'm not magic—I'm just extremely persistent with retries and coping strategies”（我不是魔法，我只是對重試和應(yīng)對策略極其執(zhí)著）——這是OpenClaw的特色幽默，說明它已經(jīng)成功重啟了。

# 查看服務(wù)狀態(tài)（應(yīng)顯示Running） 
openclaw gateway status

出現(xiàn)下面的界面，即為成功：

6.3 配置開機(jī)自啟（可選）

# 安裝為系統(tǒng)服務(wù)（開機(jī)自動啟動） 
sudo openclaw gateway install

執(zhí)行sudo openclaw gateway install出現(xiàn)下面內(nèi)容：

看到這個錯誤提示，別擔(dān)心！這是macOS權(quán)限管理的常見問題。錯誤 125: Domain does not support specified action 通常是因為 sudo 和 LaunchAgent 權(quán)限沖突。

OpenClaw Gateway 是以用戶級服務(wù)（LaunchAgent） 運(yùn)行的，而 sudo 是系統(tǒng)級權(quán)限，兩者不在同一個“域”里，所以會報錯?？焖俳鉀Q方案，去掉sudo可以成功：

七、Step 6：配置大模型API（給龍蝦裝上“大腦”）

OpenClaw本身沒有推理能力，需要對接大模型API。這里以阿里云百煉為例（推薦，國內(nèi)訪問穩(wěn)定且有免費(fèi)額度）。

7.1 獲取阿里云百煉API Key

1. 訪問阿里云百煉控制臺
2. 進(jìn)入“密鑰管理”頁面
3. 點(diǎn)擊“創(chuàng)建API-Key”，復(fù)制生成的密鑰（僅顯示一次，務(wù)必保存）

可以看到API密鑰

核心結(jié)論：API Key = accessKeyId（不需要accessKeySecret）

查看模型的用量：

7.2 配置API Key

# 配置API憑證
openclaw config set models.providers.bailian.accessKeyId "你的AccessKeyId"

報錯了：

查看OpenClaw配置文件：vim ~/.openclaw/openclaw.json

直接找到文件絕對路徑修改更快：echo ~/.openclaw/openclaw.json

/Users/linfawei/.openclaw/openclaw.json

上圖是阿里云官方提供的配置。 

# 重啟Gateway使配置生效
openclaw gateway restart

網(wǎng)關(guān)重啟成功，可以看到下面的界面：

7.3 驗證模型配置

# 檢查模型狀態(tài)
openclaw models status 

模型配置成功，會出現(xiàn)下面的界面：

八、Step 7：訪問Web控制臺

配置完成后，可以通過Web界面與你的“龍蝦”對話。

8.1 啟動控制臺

openclaw dashboard

運(yùn)行命令openclaw dashboard后，可以打開上面面板，但是報錯：

disconnected (1008): unauthorized: gateway token missing (open a tokenized dashboard URL or paste token in Control UI settings)

【修復(fù)步驟】

第一步：修復(fù)會話狀態(tài)問題
從輸出中看到有個關(guān)鍵警告：

text
- Main session transcript missing (~/.openclaw/agents/main/sessions/bea1d1ae-a758-4660-9ea2-ea565a16f37f.jsonl)
這個缺失的會話文件可能是導(dǎo)致連接問題的原因。我們可以用自動修復(fù)功能：
openclaw doctor --fix
這個命令會嘗試自動修復(fù)檢測到的問題，包括那個缺失的會話文件。

第二步：重啟網(wǎng)關(guān)服務(wù)
修復(fù)完成后，重啟網(wǎng)關(guān)讓所有配置生效：
openclaw gateway restart
第三步：重新獲取并訪問帶令牌的URL
現(xiàn)在重新生成帶令牌的訪問鏈接：
openclaw dashboard --no-open

網(wǎng)關(guān)界面：

http://127.0.0.1:18789/chat?session=agent%3Amain%3Amain

這個命令會自動：

1. 生成一個臨時登錄Token
2. 用默認(rèn)瀏覽器打開 http://127.0.0.1:18789/?token=你的Token

如果瀏覽器沒自動打開，手動訪問 http://localhost:18789 并輸入以下命令查看Token：

# 查看Token 
cat ~/.openclaw/openclaw.json | grep '"token"' | awk -F'"' '{print $4}'

其他模型配置

當(dāng)使用不同模型時，配置方式不一樣，需要用下面命令按步驟配置模型
openclaw onboard

包括配置飛書，都可以使用該命令openclaw onboard

8.2 控制臺界面介紹

進(jìn)入Web控制臺后，你可以：

• 聊天：直接與AI助理對話

問你好后，AI回復(fù)下圖內(nèi)容：

可以命令OpenClaw自動完成改名操作。

• 管理技能：安裝/卸載各種功能擴(kuò)展
• 查看日志：實時監(jiān)控運(yùn)行狀態(tài)
• 配置定時任務(wù)：讓龍蝦自動干活

九、可選進(jìn)階：安裝常用技能（Skills）

Skills是OpenClaw的“雙手”，讓它能執(zhí)行具體任務(wù)。ClawHub社區(qū)已有超過1.3萬個技能。

9.1 查看可用技能

# 列出已安裝技能 
openclaw skills list

【系統(tǒng)默認(rèn)安裝】

1、 ? ready   │ ?? bluebubbles    │ Build or update the BlueBubbles external channel plugin for OpenClaw  

為 OpenClaw 構(gòu)建或更新一個名為 "BlueBubbles" 的外部通信渠道插件 。

簡單來說，它是在幫你打通 iMessage 和 OpenClaw 的連接

2、? ready │ ?? skill-creator │ Create or update AgentSkills. Use when designing, structuring, or packaging │ openclaw-bundled 的意思是：

skill-creator 是一個由 OpenClaw 官方預(yù)置（bundled） 的元技能，它的作用是幫助你創(chuàng)建、設(shè)計、結(jié)構(gòu)化和打包其他的 Agent 技能。

簡單來說，這是一個“制造技能的技能”。

3、? ready   │ ??? weather       │ Get current weather and forecasts (no API key required). 

weather 是一個無需 API 密鑰就能使用的天氣查詢工具，可以獲取當(dāng)前天氣和天氣預(yù)報**。

【系統(tǒng)擴(kuò)展安裝】

4、Self-Improving Agent 自我進(jìn)化Agent skill。

5、Word / Docx

• ? 讀取 Word (.docx) 文檔結(jié)構(gòu)
• ? 生成格式正確的 Word 文檔
• ? 處理樣式、列表、頁眉頁腳
• ? 跨平臺兼容（Windows/Mac/Linux）

6、Feishu Doc Manager | 飛書文檔管理器

 這個技能的作用

核心功能：

• ? 將 Markdown 內(nèi)容發(fā)布到飛書文檔
• ? 自動渲染格式（標(biāo)題、列表、粗體等）
• ? Markdown 表格自動轉(zhuǎn)換為格式化列表
• ? 一鍵協(xié)作者權(quán)限管理
• ? 長內(nèi)容自動分段（避免 400 錯誤）

解決的痛點(diǎn)：

9.2 安裝實用技能

安裝clawhub命令：
npm i -g clawhub
安裝技能
clawhub install find-skills

報錯：

# 安裝瀏覽器自動化技能

npx clawhub install agent-browser --force

? Rate limit exceeded

Error: Rate limit exceeded

看到 Rate limit exceeded 這個錯誤，說明你遇到了 GitHub API 的訪問頻率限制。這是因為在沒有正確配置 GitHub Token 的情況下，clawhub 使用的是匿名訪問，每小時只有 60 次請求的額度，很容易就被用完了，可以通過設(shè)置gittoken的方式解決。

查詢已經(jīng)安裝的技能：

openclaw skills list | grep browser
# 安裝日程管理技能
openclaw skills install calendar

9.3 技能選擇黃金法則

• 痛點(diǎn)優(yōu)先：缺什么裝什么，別貪多
• 安全第一：安裝前審閱技能腳本，警惕過度索權(quán)
• 輕量化：同類功能二選一，避免沖突

十、常用命令速查表

十一、常見問題排查（避坑指南）

問題1：端口18789被占用

# 查找占用端口的進(jìn)程
lsof -i :18789
# 殺死進(jìn)程（替換PID）
kill -9 PID

問題2：Node.js版本不對

# 使用nvm切換版本
nvm install 24
nvm use 24

問題3：權(quán)限錯誤（EACCES）

# 修復(fù)npm權(quán)限
sudo chown -R $(whoami) ~/.npm

問題4：Redis連接失敗

# 啟動Redis服務(wù)
brew services start redis
# 測試連接
redis-cli ping

問題5：API調(diào)用失敗

• 檢查API Key是否正確
• 確認(rèn)網(wǎng)絡(luò)能訪問API服務(wù)
• 查看日志：tail -f ~/.openclaw/logs/gateway.log

十二、寫在最后：你的“龍蝦”養(yǎng)成記

恭喜！現(xiàn)在你的Mac上已經(jīng)有了一只功能強(qiáng)大的“小龍蝦”。你可以通過Web界面或終端與它對話，讓它幫你處理郵件、管理日程、編寫代碼，甚至控制智能家居。

記住幾個核心原則：

1. 把它當(dāng)實習(xí)生：初期多檢查它的工作成果
2. 給最小權(quán)限：只授予完成任務(wù)所需權(quán)限
3. 定期審計：查看行為日志，發(fā)現(xiàn)異常及時處理
4. 及時更新：openclaw update保持最新版本

OpenClaw的魅力在于它的可擴(kuò)展性——你可以教它新技能，讓它自己編寫代碼來改進(jìn)自己。歡迎來到個人AI助理的新時代！

以上就是OpenClaw Mac本地部署保姆級教程的詳細(xì)內(nèi)容，更多關(guān)于OpenClaw Mac本地部署的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論