前期準(zhǔn)備： 任何一家的大模型調(diào)用的 base url 和 key(附免費(fèi)和低價(jià)方案) + 海外上網(wǎng)環(huán)境(否則很難安裝與通訊) + UU遠(yuǎn)程(提供遠(yuǎn)程桌面)

在我寫這篇文章的這個(gè)版本里，由于是全新機(jī)器，系統(tǒng)里還沒有安裝 Homebrew，安裝腳本會(huì)先報(bào)錯(cuò)提示，并且提醒需要 sudo 權(quán)限來運(yùn)行腳本。

我的做法是：先單獨(dú)安裝好 Homebrew，然后再執(zhí)行上面的安裝命令，而不是直接用 sudo 去跑 curl ... | bash。

一、Mac Mini 本地部署詳解

Mac Mini 是運(yùn)行 OpenClaw 的理想本地硬件方案——低功耗（20-40W）、高性能、零云端費(fèi)用。

硬件選型推薦

性能參考: GLM-4.7-Flash 在 24GB 系統(tǒng)上可達(dá) 15-20 tokens/秒；Qwen3-Coder-30B 在 32GB 模型上可達(dá) 10-15 tokens/秒。

二、安裝Homebrew 

安裝OpenClaw

要想跑通本地 AI，你的系統(tǒng)得先有個(gè)強(qiáng)大的“后勤部長”。

在 Mac 系統(tǒng)里，這個(gè)部長叫 Homebrew。打開終端（Terminal），把這行咒語復(fù)制進(jìn)去，一鍵回車：

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

運(yùn)行后如下圖所示

安裝好以后

在終端中輸入以下命令，將Homebrew添加到你的PATH環(huán)境變量中：
執(zhí)行命令：

eval "$(/opt/homebrew/bin/brew shellenv zsh)"

運(yùn)行“brew help”以開始使用

三、安裝與配置OpenClaw

在瀏覽器打開 openclaw.ai，可以看到官網(wǎng)提供了多種安裝方式。最推薦的是 One-liner 一鍵安裝：

在終端中輸入如下命令

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

官網(wǎng)承諾：自動(dòng)安裝 Node.js 和所有依賴，支持 macOS / Windows / Linux。

打開終端（Terminal），粘貼命令并回車。

安裝程序會(huì)自動(dòng)檢測(cè)環(huán)境：

• ? Detected: macOS
• ? Homebrew already installed
• ? Node.js v22.22.0 found
• ? Git already installed

然后開始下載安裝包…

完成標(biāo)準(zhǔn)： 運(yùn)行 openclaw --version 或 openclaw --help 能正常顯示信息

四、選擇 AI 模型提供商

引導(dǎo)程序會(huì)讓你選擇 AI 模型，支持：

• OpenAI
• Anthropic (Claude)
• MiniMax (M2.5) ? 推薦
• Google
• Ollama
• 本地模型
• 等等…

回車?yán)^續(xù)后會(huì)讓你填入miniMax的API Key，如果沒有可以選擇 Skip for now

如下圖，直接選擇最后一步跳過。

后面的選擇根據(jù)我們自己的需要，一步步配置即可。

注意

這里也是我們最重要的一步，有如下兩個(gè)選擇

1) 假如你有下列模型的管訂賬號(hào)，直接選擇跳轉(zhuǎn)登錄或者輸入api信息即可
2) 假如你沒有下列模型的官訂賬號(hào)，則進(jìn)行如下配置： 我們跳過模型的秘鑰選擇(因?yàn)榇蟛糠秩税ㄎ叶紱]有管訂賬號(hào))，所以后面讓Claude Code給我們自己配置第三方。

這時(shí)候，系統(tǒng)會(huì)讓你選擇底層的大模型。聽好，這里有個(gè)天坑。

過去圈內(nèi)人都喜歡閉眼選 Claude，但因?yàn)樽罱?Anthropic 搞起了極為嚴(yán)苛的風(fēng)控（而且明確說明了不給openclaw使用），之前的配置經(jīng)驗(yàn)已經(jīng)徹底作廢了。

現(xiàn)在的最優(yōu)解，是直接選擇 OpenAI。國內(nèi)用戶可以選擇minimax2.5 這也是openclaw推薦的搭配

強(qiáng)烈建議你在動(dòng)手前，先搞定一個(gè) ChatGPT Plus 會(huì)員。在終端界面選擇 OpenAI 后，系統(tǒng)會(huì)自動(dòng)跳轉(zhuǎn)到瀏覽器，你只需要登錄賬號(hào)點(diǎn)個(gè)授權(quán)，這顆地表最強(qiáng)的大腦就正式接入了。

五、openclaw初始化配置

先閱讀安全警告

OpenClaw 很強(qiáng)大，但也有風(fēng)險(xiǎn)。它會(huì)執(zhí)行你給的命令，包括可能危險(xiǎn)的指令。

選項(xiàng)：

• 輸入 Yes 繼續(xù)
• 按 Ctrl+C 中止
• 空格 選擇
• 回車 確認(rèn)

onboard 向?qū)?huì)做什么

openclaw onboard 會(huì)引導(dǎo)你完成：

• Gateway 基本配置（端口、綁定方式、鑒權(quán)、daemon）
• Workspace 初始化（默認(rèn)在 ~/.openclaw/workspace，可改）
• Model/Auth（API Key / OAuth / setup-token）
• Channels（Telegram/Discord/WhatsApp/Google Chat/Signal/iMessage/…）
• Skills（挑選/安裝）

如果你不想一步到位：

跑向?qū)r(shí)可以跳過某些步驟（例如 --skip-channels / --skip-skills）。+

新手引導(dǎo)向?qū)?/h3>

運(yùn)行新手引導(dǎo)向?qū)Вú惭b服務(wù)）

openclaw onboard --install-daemon

這條命令會(huì)啟動(dòng)配置向?qū)?，在命令行界面一步步提問。并且重啟后可以自?dòng)運(yùn)行，如果不需要直接openclaw onboard也可以。你可以通過鍵盤上下方向鍵選擇，按回車確認(rèn)，大部分場景跟著提示走就能完成初始配置。

確認(rèn)安裝方式

出現(xiàn)下面這句提示時(shí)：
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
這里選擇 YES，然后按回車，可以使用鍵盤方向鍵進(jìn)行選擇。

?選擇 YES?

為了快速跑起來，先選擇QuickStart

選擇 AI 模型提供商（OpenAI GPT / minimax/本地模型），國內(nèi)推薦使用minimax 2.5 為了快速測(cè)試，這里直接選擇Qwen方便快速跑通流程

選擇完成之后，會(huì)在瀏覽器彈出登陸頁面

有為老哥提出疑問：為什么沒有支付寶或者手機(jī)之類的登陸方式呢？因?yàn)閛penclaw 作為一個(gè)開源工具，其默認(rèn)的 Qwen 配置（qwen-portal）通常指向國際版 API，國際版顯然沒有支付寶、國內(nèi)手機(jī)號(hào)直接登錄等登陸方式，取而代之的是Google 賬號(hào)、GitHub 賬號(hào)等，如果沒有賬號(hào)，注冊(cè)一個(gè)賬號(hào)即可

選擇Qwen也是因?yàn)殚T檻地，快速上手，國際版往往提供針對(duì)開發(fā)者的免費(fèi)試用額度（如每天 2000 次請(qǐng)求）

后面可以換模型供應(yīng)商，所以當(dāng)前的目標(biāo)是快速搭建并且跑通流程，所以選擇Qwen。繼續(xù)...

完成登陸之后回到控制臺(tái)，選擇具體模型，選擇默認(rèn)的即可

下一步，選擇渠道，這里先跳過，因?yàn)檫@一步后面會(huì)詳細(xì)描述，這里的目標(biāo)還是先完成安裝并且跑通

選擇是否配置skills，是

同樣，先跳過，后面再來配置

下面的全選否

Set GOOGLE_PLACES_API_KEY for goplaces，是否要選擇Google Places API 來查詢現(xiàn)實(shí)世界中的地點(diǎn)信息（比如電影院、餐館等），首先是不能使用google服務(wù)，并且不在我們本文的流程中，暫時(shí)不需要，選否

Set GEMINI_API_KEY for nano-banana-pro，詢問你是否要為名為 nano-banana-pro 設(shè)置 Google Gemini API 密鑰，問題還是不能使用google的服務(wù)，選否。至于nano-banana-pro是什么東西，我也不知道...

Set NOTION_API_KEY for notion?，配置notion的使用權(quán)限，notion是什么？Notion 是一款集筆記、文檔、任務(wù)管理、數(shù)據(jù)庫和協(xié)作于一體的“超級(jí)辦公室”軟件。用不上，選否

Set ELEVENLABS_API_KEY for sag?，讓openclaw說話，而不是只有文字交流，而說話的能力正是ElevenLabs賦予的，它提供的服務(wù)是目前行業(yè)內(nèi)領(lǐng)先的文本轉(zhuǎn)語音（Text-to-Speech, TTS）平臺(tái)。其生成的語音非常自然、富有情感，聽起來幾乎和真人一樣。不在當(dāng)前流程，先選否

下一步詢問你是否要啟用 Hooks（鉤子/插件），選擇session-memory，讓 AI “記住”之前的對(duì)話內(nèi)容或項(xiàng)目上下文，即使你關(guān)閉了終端再重新打開，它也能延續(xù)之前的話題

到此基本配置已經(jīng)結(jié)束，下一步問你怎么孵化小機(jī)器人，直接選擇推薦的方式，使用tui（terminal ui）完成最后一步

這是終結(jié)者要來了嗎？斯瓦辛格從天而將，并且bgm：”洞洞咚，懂凍，洞洞咚，懂洞咚“

斯瓦辛格能不能說中文阿？

能說中文啊，那就更簡單了，現(xiàn)在需要告訴配置初始化一下這個(gè)機(jī)器人，就像星級(jí)穿越里面，男主重新配置TAS一樣

配置完成，回歸測(cè)試一下

安裝完成

六、配置 Telegram 或 Discord

選擇消息平臺(tái)（Telegram / Discord / WhatsApp 等）

聊天渠道這里選擇：Telegram然后選擇：Enter Telegram bot token接著輸入你的 Telegram Bot Token，如果沒有的申請(qǐng)的同學(xué)可以通過下面的步驟

具體步驟如下

1、在 Telegram 中搜索 @BotFather（官方 Bot 創(chuàng)建工具）
2、發(fā)送命令：/newbot
3、按提示設(shè)置 bot 名稱和用戶名
機(jī)器人顯示名：用戶看到的名字
機(jī)器人用戶名：用于搜索
機(jī)器人用戶名規(guī)則：只能使用 英文字母、數(shù)字、下劃線，必須以 bot 結(jié)尾
例如：my_xiaoc752_bot 或 Myxiaoc752Bot
4、獲得 Bot Token（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

聊天渠道這里選擇：Telegram
然后選擇：Enter Telegram bot token
接著輸入你前面保存好的 Telegram Bot Token

選擇：Telegram

選擇：Enter Telegram bot token

接著輸入你前面保存好的 Telegram Bot Token

啟用 Telegram 插件

如果之前跳過了這個(gè)配置，可以通過下面的方法設(shè)置

在終端中執(zhí)行（插件默認(rèn)是關(guān)閉的）：

openclaw plugins enable telegram

配置 Bot Token

在終端中執(zhí)行：

openclaw config set channels.telegram.botToken "你的Bot_Token"

將 你的Bot_Token 替換為第一步獲取的 Token。

啟動(dòng) Gateway

openclaw gateway run

如果報(bào)錯(cuò)，可以先嘗試停止：

openclaw gateway stop
openclaw gateway run

配對(duì)驗(yàn)證

在 Telegram 中找到你的 bot
發(fā)送任意消息
Bot 會(huì)返回一個(gè)驗(yàn)證碼（6位數(shù)字）
在終端中執(zhí)行：

openclaw pairing approve telegram 你的驗(yàn)證碼

配對(duì)成功后，你就可以和 Bot 對(duì)話了！

第一次對(duì)話

啟動(dòng) OpenClaw

# 啟動(dòng) OpenClaw

# 或者啟動(dòng) Dashboard（Web 界面）

openclaw dashboard

如果對(duì)話框中沒有選擇tg，可以如下設(shè)置配置tg到 OpenClaw:

openclaw config set channels.telegram.botToken "YOUR_BOT_TOKEN"
openclaw config set channels.telegram.enabled true

在 Telegram 中搜索你的機(jī)器人并開始對(duì)話

實(shí)踐任務(wù) 4：第一次對(duì)話

與你的 OpenClaw 助手進(jìn)行第一次對(duì)話，測(cè)試以下命令：

需要給他起個(gè)名字或讓他自己選擇一個(gè)名字

• 你好，介紹一下你自己
• 你能幫我做什么？
• 現(xiàn)在幾點(diǎn)了？

完成標(biāo)準(zhǔn)： 機(jī)器人能正常回復(fù)你的消息

七、安裝skill

光有腦子不行，咱們還得給它裝上手腳。

在終端界面里，你會(huì)看到一堆花里胡哨的常用技能模塊。記住這里的核心操作邏輯：上下鍵切換，空格鍵選中，回車鍵確認(rèn)。

不知道怎么選的，直接抄我的滿分作業(yè)：

選中 apple-notes（備忘錄）、apple-reminders（日程管理）、github（代碼庫）、imsg（蘋果信息）、model-usage（算力賬單）、obsidian（神仙筆記軟件）、summarize（長文總結(jié)）。

選完之后一路回車往下走。

最后到了 Enable hooks（啟用鉤子）這步，千萬別手抖，一定要選上 command-logger 和 session-memory。這倆玩意兒能讓你的 AI 擁有過目不忘的長期記憶，而不是聊兩句就失憶的金魚腦。

Hooks 是自動(dòng)化工具，可以幫你執(zhí)行一些預(yù)設(shè)任務(wù)。

可以選擇：

No - 跳過，后續(xù)再配置

Yes - 現(xiàn)在配置

我選了 No，先跑起來再說。

默認(rèn)會(huì)啟用 3 個(gè)有用的鉤子：

?? boot-md - 啟動(dòng)時(shí)讀取配置

?? command-logger - 記錄命令日志

?? session-memory - 保持會(huì)話記憶

八、給 OpenClaw 開啟完整權(quán)限+設(shè)置白名單

1.打開網(wǎng)頁版控制臺(tái)，如果之前沒有打開，可以在 Ubuntu 中輸入：

openclaw dashboard

2. 進(jìn)入配置頁面進(jìn)入控制臺(tái)后：選擇 配置點(diǎn)擊 All Settings在下方選擇 Raw

點(diǎn)擊紅框標(biāo)注的地方

3. 修改工具權(quán)限把原來的：

"tools": {
"profile": "messaging"
}

換為：

"tools": {
"profile": "full",
"exec": {
"host": "gateway",
"security": "full",
"ask": "off"
},
"web": {
"fetch": {
"enabled": true
}
}
},

替換后點(diǎn)Save保存

保存后即可生效。

點(diǎn)擊Tools這邊出現(xiàn)Full就是設(shè)置完成了

這表示把工具配置從僅消息模式改成完整模式，并把本機(jī)執(zhí)行權(quán)限開到最高，同時(shí)關(guān)閉逐次確認(rèn)。

4.給 Telegram 機(jī)器人設(shè)置白名單

為了防止別人隨意使用你的機(jī)器人，建議開啟白名單功能
開啟后，只有被添加到白名單里的 Telegram 用戶，才能給機(jī)器人發(fā)送指令并正常使用
設(shè)置方法打開 OpenClaw 控制臺(tái)點(diǎn)擊 頻道找到 Allow From點(diǎn)擊 Add添加你自己的 Telegram 用戶 ID滑到最下方點(diǎn)Save 保存設(shè)置設(shè)置完成后，只有這個(gè) Telegram ID 對(duì)應(yīng)的賬號(hào)可以使用該機(jī)器人。
注意：這里填寫的是 Telegram 用戶 ID（純數(shù)字），不是用戶名

給 Telegram 機(jī)器人設(shè)置白名單

九、理解核心概念

Gateway（網(wǎng)關(guān)）

Gateway 是 OpenClaw 與外部世界交互的方式：

• 消息網(wǎng)關(guān)： Telegram、Discord、WhatsApp
• API 網(wǎng)關(guān)： HTTP API 接口
• CLI 網(wǎng)關(guān)： 命令行交互

Skills（技能）

Skills 是 OpenClaw 的能力擴(kuò)展，類似于“插件”或“應(yīng)用”：

• 每個(gè) Skill 定義了一組特定任務(wù)
• 可以從 Clawhub 安裝第三方 Skills
• 也可以自己編寫自定義 Skills

Memory（記憶）

OpenClaw 會(huì)記?。?/p>

• 你的偏好和習(xí)慣
• 之前的對(duì)話上下文
• 重要的信息和任務(wù)

Sandbox（沙盒）

沙盒模式限制 OpenClaw 的系統(tǒng)訪問權(quán)限，保護(hù)你的電腦安全：

• Sandbox Mode: 限制文件系統(tǒng)、網(wǎng)絡(luò)、Shell 訪問
• Full Access Mode: 完全權(quán)限（需謹(jǐn)慎使用）

實(shí)踐任務(wù) 5：探索工作空間

# 查看 OpenClaw 的工作目錄
ls ~/.openclaw
# 查看配置文件
openclaw config list
# 查看已安裝的 Skills
openclaw skills list
# 運(yùn)行安全審計(jì)
openclaw security audit

完成標(biāo)準(zhǔn)： 理解 OpenClaw 的文件結(jié)構(gòu)和基本配置

十、額外配置

配置1：網(wǎng)絡(luò)代理 (假如上面配置完成后還不能對(duì)話)

這里還是使用你的外網(wǎng)軟件，并且導(dǎo)入訂閱鏈接后，打開TUN模式。 然后給Claude Code發(fā)送這段話： “幫我配置OpenClaw的環(huán)境，使其適配目前的網(wǎng)絡(luò)代理” Claude Code 配置完成后，你的龍蝦就能夠正常使用了。

配置2：大模型

目前龍蝦中最為強(qiáng)力的模型還是Claude(賬號(hào)容易被關(guān)閉，現(xiàn)在推薦openai，國內(nèi)用戶使用minimax2.5更合適)的Sonnet和Opus，如果你是土豪，可以直接買中轉(zhuǎn)站的原生Claude Max，但是大部分OpenClaw的用量其實(shí)一天有保底100美金。 所以這里推薦我的逆向半公益站和免費(fèi)站AnyRouter，AnyRouter目前只能使用Linuxdo登錄了，每天簽到贈(zèng)送25$，我的公益站提供逆向AWS的Claude Sonnet模型，便宜不穩(wěn)定，15元100刀。 但是也有其他的選擇，比如說GPT-5(來自Codex)、GLM-5、MiniMAX、Kimi等，效果會(huì)差一點(diǎn)

配置3：UU遠(yuǎn)程 下載UU遠(yuǎn)程，安裝到Mac mini上，然后在我們經(jīng)常用的電腦上也安裝一個(gè)，如圖所示

好處是：

1. 手機(jī)與電腦都能夠操控Macmini遠(yuǎn)程桌面(不需要顯示器了)

2. OpenClaw掛掉了，我們隨時(shí)能夠通過遠(yuǎn)程桌面的Claude Code來重啟OpenClaw

看到這里了，相信大家都能順利配置好OpenClaw。

常見問題及解決方案

Homebrew not found

蘋果系統(tǒng)需要先安裝Homebrew，在終端中輸入如下命令即可：

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

命令未找到（command not found）

• 確保終端已重啟或運(yùn)行source ~/.zshrc（如果使用Zsh）。
• 確保Homebrew和Node.js安裝成功。

權(quán)限問題（EACCES錯(cuò)誤）

運(yùn)行以下命令修復(fù)權(quán)限：

sudo chown -R $USER /usr/local/lib/node_modules

鏡像源失效

重置為官方源：

npm config set registry https://registry.npmjs.org

界面1008code問題

當(dāng)然：4008、401的問題是不是很多人都遇到過；command not found 是不是也很多人都遇到過。

遇到4008、code1008解決辦法：

# 生成新的 gateway token
openclaw doctor --generate-gateway-token
# 重啟服務(wù)
systemctl --user restart openclaw-gateway
# 打開帶 token 的 dashboard
openclaw dashboard

遇到401的解決辦法

1、模型沒有錢了，快去沖錢

2、minmax這個(gè)模型試了幾個(gè)機(jī)器都不行，換個(gè)模型試試

命令不存在

windows建議安裝順序：

Powershell -> wsl ->nodejs ->openclaw

nodejs的win安裝命令

apk update
apk add curl bash 
# 用 nvm 安裝指定版本 
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash  
# 加載 
nvm source ~/.bashrc  
# 安裝 Node.js 23 
nvm install 23

code 128的問題

解決辦法

git config --global url."https://github.com/".insteadOf ssh://git@github.com/ git config --global url."https://github.com/".insteadOf git@github.com:

模型配置不成功的問題

去到用戶目錄，找到.openclaw/openclaw.json，配置你的模型

或者

openclaw config

 到此這篇關(guān)于蘋果Macmini下OpenClaw保姆級(jí)配置教程(全網(wǎng)最簡單)的文章就介紹到這了,更多相關(guān)Macmini配置OpenClaw內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論