1. 為什么要在 Mac mini 上折騰 OpenClaw 加飛書(shū)這套組合先說(shuō)結(jié)論Mac mini 跑 OpenClaw再通過(guò)飛書(shū)機(jī)器人遠(yuǎn)程調(diào)用是目前我試過(guò)的「家庭 AI 服務(wù)器」方案里性價(jià)比最高的一種。OpenClaw 是一個(gè)完全開(kāi)源、本地部署的 AI 智能體平臺(tái)它和網(wǎng)頁(yè)版對(duì)話工具最大的區(qū)別在于——它能直接操作你的 macOS 系統(tǒng)讀寫(xiě)文件、執(zhí)行腳本、控制瀏覽器、生成文檔相當(dāng)于給你的電腦裝了一個(gè)能動(dòng)手的 AI 管家。而 Mac mini 功耗低、性能夠、可以 7×24 小時(shí)掛著不關(guān)機(jī)天生就是跑這類常駐服務(wù)的料。但光部署上去還不夠。你總不能每次想用 AI 都跑到 Mac mini 面前打開(kāi)瀏覽器。所以我們需要把它接入飛書(shū)——這樣你在手機(jī)上發(fā)一條消息家里的 Mac mini 就會(huì)立刻幫你處理任務(wù)。再配合 cpolar 內(nèi)網(wǎng)穿透OpenClaw 生成的網(wǎng)頁(yè)、搭建的本地服務(wù)還能一鍵暴露到公網(wǎng)朋友點(diǎn)開(kāi)鏈接就能直接體驗(yàn)。這套流程涉及幾個(gè)關(guān)鍵環(huán)節(jié)Node.js 環(huán)境準(zhǔn)備、OpenClaw 安裝與模型配置、飛書(shū)應(yīng)用創(chuàng)建與事件訂閱、cpolar 內(nèi)網(wǎng)穿透。其中模型調(diào)用憑據(jù)的管理我建議用 TaoToken 統(tǒng)一 Key 通道來(lái)處理后面會(huì)詳細(xì)講怎么配。整篇教程按「能跟著做」的標(biāo)準(zhǔn)來(lái)寫(xiě)每個(gè)命令、每段配置都會(huì)給全遇到容易踩坑的地方我會(huì)單獨(dú)標(biāo)出來(lái)。適合誰(shuí)看有一臺(tái) Mac miniM 系列芯片都行、想讓 AI 幫自己干活的開(kāi)發(fā)者或技術(shù)愛(ài)好者、想搭一個(gè)私人 AI 助手但不想把數(shù)據(jù)傳到第三方平臺(tái)的人。如果你之前沒(méi)接觸過(guò) OpenClaw也沒(méi)關(guān)系跟著步驟走就行。2. TaoToken 統(tǒng)一 Key 前置準(zhǔn)備與模型通道配置在開(kāi)始裝 OpenClaw 之前先把模型調(diào)用的憑據(jù)問(wèn)題解決掉。OpenClaw 本身不提供模型它需要你接入一個(gè) AI 大模型的 API。你可以直接去各家平臺(tái)注冊(cè)拿 Key但問(wèn)題是不同平臺(tái)的 Key 格式不一樣、額度分散、切換模型時(shí)要改配置。我實(shí)測(cè)下來(lái)用 TaoToken 做統(tǒng)一 Key 管理會(huì)省事很多——一個(gè) Key 就能調(diào)用多種模型Base URL 統(tǒng)一切換模型只需要改 Model ID。TaoToken 的官網(wǎng)入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。注意 API 地址后面不加 UTM 參數(shù)直接填這個(gè)就行。具體操作步驟先訪問(wèn)官網(wǎng)注冊(cè)賬號(hào)然后進(jìn)入控制臺(tái)創(chuàng)建 API Key?？刂婆_(tái)地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 管理頁(yè)面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。創(chuàng)建好 Key 之后復(fù)制下來(lái)后面配置 OpenClaw 時(shí)要用。這里有個(gè)關(guān)鍵點(diǎn)OpenClaw 的模型配置支持自定義 Provider你需要填三個(gè)東西——Base URL、API Key、Model ID。用 TaoToken 的話Base URL 填https://taotoken.net/apiAPI Key 填你剛創(chuàng)建的那串Model ID 根據(jù)你想用的模型來(lái)填。比如你想用 Claude 系列就填對(duì)應(yīng)的模型標(biāo)識(shí)想用 GPT 系列換一個(gè) Model ID 就行不用改 Base URL 和 Key。如果你后面要長(zhǎng)期跑編碼類任務(wù)或者 Agent 工作流可以考慮 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。模型對(duì)話調(diào)試入口在 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite 接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。Claude Code 相關(guān)配置參考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude-code-anthropicutm_campaignrewrite 。為什么要提前做這一步因?yàn)?OpenClaw 的配置向?qū)Ю飼?huì)讓你選模型提供商如果你選 Custom Provider就需要當(dāng)場(chǎng)填 Base URL 和 Key。提前把 TaoToken 的 Key 準(zhǔn)備好到時(shí)候直接粘貼就行不用中途去注冊(cè)。另外提醒一點(diǎn)TaoToken 是統(tǒng)一的 API 通道不是讓你繞過(guò)什么限制它只是幫你把多個(gè)模型的調(diào)用憑據(jù)統(tǒng)一管理起來(lái)。你該有的賬號(hào)注冊(cè)、額度充值流程一樣不少只是省去了在多個(gè)平臺(tái)之間來(lái)回切換的麻煩。3. Mac mini 環(huán)境準(zhǔn)備與 OpenClaw 可復(fù)制配置片段這一章是整篇教程的核心操作部分我會(huì)把每一步的命令和配置文件都寫(xiě)全。你可以在 Mac mini 上打開(kāi)終端Command 空格輸入「終端」回車(chē)跟著一步步執(zhí)行。3.1 Homebrew 與 Node.js 安裝先檢查 Homebrew 是否已安裝brew -v如果顯示版本號(hào)就跳過(guò)安裝。如果沒(méi)有執(zhí)行官方安裝腳本/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)安裝完成后按照終端提示把 Homebrew 加入 PATH。M 系列芯片的 Mac mini 通常是echo eval $(/opt/homebrew/bin/brew shellenv zsh) ~/.zprofile eval $(/opt/homebrew/bin/brew shellenv zsh)接著安裝 Node.js 22brew install node22安裝完成后把 Node 22 加入系統(tǒng)路徑echo export PATH/opt/homebrew/opt/node22/bin:$PATH ~/.zshrc source ~/.zshrc驗(yàn)證版本node -v npm -v git --versionNode.js 版本需要 22 及以上Git 版本沒(méi)有硬性要求macOS 一般自帶。3.2 OpenClaw 安裝與模型配置執(zhí)行官方一鍵安裝命令curl -fsSL https://openclaw.ai/install.sh | bash安裝完成后會(huì)進(jìn)入配置向?qū)?。如果中途退出了可以用openclaw onboard --install-daemon重新進(jìn)入。在模型提供商選擇界面選 Custom Provider然后填寫(xiě)API Base URLhttps://taotoken.net/apiAPI Key粘貼你在 TaoToken 控制臺(tái)創(chuàng)建的 KeyEndpoint 類型選 OpenAI-compatibleModel ID填你要用的模型標(biāo)識(shí)比如Pro/MiniMaxAI/MiniMax-M2.5或 Claude 系列對(duì)應(yīng)的 ID驗(yàn)證成功后會(huì)提示 Verification successful。接著設(shè)置一個(gè) Model alias模型別名隨便填一個(gè)好記的就行。如果你習(xí)慣用配置文件管理OpenClaw 的配置通常落在~/.openclaw/目錄下。一個(gè)典型的模型配置片段JSON 格式如下{ models: { default: { provider: custom, baseUrl: https://taotoken.net/api, apiKey: 你的_TaoToken_Key, modelId: Pro/MiniMaxAI/MiniMax-M2.5, endpointType: openai-compatible } } }如果你用的是 TOML 格式的配置部分版本支持對(duì)應(yīng)寫(xiě)法[models.default] provider custom baseUrl https://taotoken.net/api apiKey 你的_TaoToken_Key modelId Pro/MiniMaxAI/MiniMax-M2.5 endpointType openai-compatible注意實(shí)際配置文件的路徑和字段名可能因 OpenClaw 版本不同而有差異建議以配置向?qū)傻臑闇?zhǔn)。上面這段是給你一個(gè)結(jié)構(gòu)參考方便你理解三個(gè)核心要素——Base URL、Key、Model ID 是怎么組織的。3.3 飛書(shū)插件安裝在配置向?qū)У?Select channel 頁(yè)面選擇 Feishu/飛書(shū)然后選 Download from npm。下載完成后會(huì)提示輸入 App Secret說(shuō)明插件裝好了。先別急著填下一步我們?nèi)ワw書(shū)開(kāi)放平臺(tái)創(chuàng)建應(yīng)用拿憑據(jù)。4. 飛書(shū)機(jī)器人創(chuàng)建與事件訂閱驗(yàn)證請(qǐng)求4.1 創(chuàng)建企業(yè)自建應(yīng)用訪問(wèn)飛書(shū)開(kāi)放平臺(tái) https://open.feishu.cn/?langzh-CN 登錄后點(diǎn)擊「開(kāi)發(fā)者后臺(tái)」然后點(diǎn)「創(chuàng)建企業(yè)自建應(yīng)用」。填寫(xiě)應(yīng)用名稱、描述、圖標(biāo)點(diǎn)擊創(chuàng)建。進(jìn)入應(yīng)用詳情頁(yè)后點(diǎn)擊「添加應(yīng)用能力」找到「機(jī)器人」點(diǎn)添加。然后在「如何開(kāi)始使用」部分點(diǎn)編輯設(shè)置機(jī)器人名稱。4.2 批量導(dǎo)入權(quán)限點(diǎn)擊左側(cè)菜單「權(quán)限管理」點(diǎn)「批量導(dǎo)入」粘貼以下 JSON{ scopes: { tenant: [ aily:file:read, aily:file:write, application:application.app_message_stats.overview:readonly, application:application:self_manage, application:bot.menu:write, cardkit:card:write, contact:user.employee_id:readonly, corehr:file:download, docs:document.content:read, event:ip_list, im:chat, im:chat.access_event.bot_p2p_chat:read, im:chat.members:bot_access, im:message, im:message.group_at_msg:readonly, im:message.group_msg, im:message.p2p_msg:readonly, im:message:readonly, im:message:send_as_bot, im:resource, sheets:spreadsheet, wiki:wiki:readonly ], user: [ aily:file:read, aily:file:write, im:chat.access_event.bot_p2p_chat:read ] } }粘貼后點(diǎn)「下一步確認(rèn)新增權(quán)限」然后點(diǎn)「申請(qǐng)開(kāi)通」和「確認(rèn)」。4.3 獲取憑據(jù)并填入 OpenClaw在左側(cè)菜單「憑證與基礎(chǔ)信息」頁(yè)面復(fù)制 App Secret 和 App ID?；氐?Mac mini 終端把 App Secret 粘貼進(jìn)去回車(chē)再把 App ID 粘貼進(jìn)去回車(chē)。提示 client ready 就說(shuō)明連接成功了。接著依次選擇 WebSocket (default)、Feishu - China、Allowlist。Group chat allowlist 直接回車(chē)跳過(guò)不讓機(jī)器人加群。4.4 完成剩余配置Search provider 選 Skip for nowConfigure skills now 選 NOEnable hooks 按需勾選我一般全選然后等待網(wǎng)關(guān)安裝完成。安裝完成后選 Open The Web UI瀏覽器會(huì)自動(dòng)打開(kāi) OpenClaw 頁(yè)面。你可以發(fā)一條測(cè)試消息你好你是誰(shuí)你當(dāng)前運(yùn)行在什么操作系統(tǒng)上接入的是什么模型你能夠干什么請(qǐng)?jiān)敿?xì)回答。如果能看到正?；貜?fù)說(shuō)明模型通道和 OpenClaw 本體都通了。4.5 飛書(shū)事件訂閱配置回到飛書(shū)開(kāi)放平臺(tái)在左側(cè)「事件與回調(diào)」菜單里把訂閱方式改為「長(zhǎng)連接」然后保存。注意如果 OpenClaw 網(wǎng)關(guān)沒(méi)啟動(dòng)或者渠道沒(méi)添加長(zhǎng)連接會(huì)保存失敗。保存后點(diǎn)右下角「添加事件」搜索「接收消息」勾選后確認(rèn)。然后到「版本管理與發(fā)布」頁(yè)面點(diǎn)「創(chuàng)建版本」填寫(xiě)版本號(hào)和更新說(shuō)明保存后點(diǎn)「確認(rèn)發(fā)布」。4.6 授權(quán)機(jī)器人下載飛書(shū)客戶端并登錄在「開(kāi)發(fā)小助手」里找到你剛發(fā)布的機(jī)器人點(diǎn)「打開(kāi)應(yīng)用」。隨便發(fā)一條消息會(huì)收到類似這樣的回復(fù)OpenClaw: access not configured. Your Feishu user id: ou_xxxxxxxx Pairing code: XXXXXXXX Ask the bot owner to approve with: openclaw pairing approve feishu XXXXXXXX復(fù)制最后那行命令回到 Mac mini 終端執(zhí)行把 XXXXXXXX 換成你的實(shí)際配對(duì)碼openclaw pairing approve feishu XXXXXXXX出現(xiàn)成功提示后再在飛書(shū)里發(fā)消息測(cè)試機(jī)器人就能正?；貜?fù)了。5. 常見(jiàn)報(bào)錯(cuò)排查與 cpolar 內(nèi)網(wǎng)穿透配置這一章集中處理幾個(gè)高頻報(bào)錯(cuò)以及 cpolar 的安裝和穿透配置。5.1 模型調(diào)用報(bào) 401 或 local proxy failed如果你在 OpenClaw 里發(fā)消息后看到 401 錯(cuò)誤大概率是 API Key 填錯(cuò)了或者過(guò)期了。檢查~/.openclaw/下的配置文件確認(rèn)apiKey字段和 TaoToken 控制臺(tái)里的一致。如果是 local proxy failed通常是 Base URL 寫(xiě)錯(cuò)了確認(rèn)填的是https://taotoken.net/api不要多加斜杠或路徑。5.2 reading choices 報(bào)錯(cuò)這個(gè)報(bào)錯(cuò)一般出現(xiàn)在模型返回格式不兼容的時(shí)候。檢查 Endpoint 類型是否選了 OpenAI-compatible。如果你用的模型 ID 不對(duì)也可能導(dǎo)致返回結(jié)構(gòu)異常。建議先在 TaoToken 的模型對(duì)話頁(yè)面測(cè)試一下該模型是否能正常返回再回到 OpenClaw 里配置。5.3 OAuth 相關(guān)報(bào)錯(cuò)飛書(shū)側(cè)如果出現(xiàn) OAuth 報(bào)錯(cuò)檢查應(yīng)用權(quán)限是否全部開(kāi)通、版本是否已發(fā)布、事件訂閱是否選了長(zhǎng)連接。另外確認(rèn) OpenClaw 網(wǎng)關(guān)處于運(yùn)行狀態(tài)否則長(zhǎng)連接建立不起來(lái)。5.4 cpolar 安裝與穿透cpolar 是一款內(nèi)網(wǎng)穿透工具能把本地服務(wù)映射到公網(wǎng)。在 Mac mini 上安裝brew tap probezy/core brew install cpolar sudo cpolar service install sudo cpolar service start cpolar version然后訪問(wèn) http://127.0.0.1:9200 登錄 cpolar Web UI。注冊(cè)賬號(hào)后在「隧道管理」里創(chuàng)建一個(gè) HTTP 隧道本地地址填你的服務(wù)端口比如 OpenClaw 生成的網(wǎng)頁(yè)跑在 8080就填 8080地區(qū)選 China Top。創(chuàng)建完成后在「狀態(tài)」→「在線隧道列表」里能看到公網(wǎng)地址。比如你的貪吃蛇小游戲跑在 8080穿透后訪問(wèn)https://你的隧道地址/snake.html就能打開(kāi)。如果需要固定域名去 cpolar 的預(yù)留頁(yè)面保留一個(gè)二級(jí)子域名然后在隧道編輯里把域名類型改為「二級(jí)子域名」填入你保留的名稱更新即可。這樣每 24 小時(shí)不會(huì)失效。5.5 CC Switch / Cline MCP / Codex auth.json 三件套如果你同時(shí)用 CC Switch 或 Cline 這類工具配置邏輯是一樣的Base URL 填https://taotoken.net/apiKey 填 TaoToken 的 KeyModel ID 填你要用的模型。Codex 的 auth.json 里對(duì)應(yīng)字段也是這三個(gè)。不管哪個(gè)工具核心就是這三件套對(duì)齊。6. 接入后的玩法與統(tǒng)一 Key 管理建議配置跑通之后你可以讓 OpenClaw 幫你做很多事。比如在飛書(shū)里發(fā)一句「幫我截一張當(dāng)前屏幕的圖發(fā)給我」它就能調(diào)用系統(tǒng)工具截圖并通過(guò)飛書(shū)發(fā)回來(lái)?；蛘咦屗笇?xiě)一個(gè)貪吃蛇小游戲放在桌面并運(yùn)行起來(lái)」它會(huì)生成 HTML 文件、啟動(dòng)本地服務(wù)你通過(guò) cpolar 穿透后就能在手機(jī)上玩。我試過(guò)讓它做 PPT說(shuō)「幫我做一個(gè)關(guān)于元旦節(jié)的 PPT10 頁(yè)左右做完截圖給我看」它會(huì)調(diào)用本地應(yīng)用生成文件并截圖反饋。如果 Mac mini 上沒(méi)裝辦公軟件它還會(huì)問(wèn)你要不要裝一個(gè)。這些玩法的前提是模型通道穩(wěn)定。用 TaoToken 統(tǒng)一 Key 的好處在這里就體現(xiàn)出來(lái)了不管你后面想換 Claude 還是換其他模型只需要改 Model IDBase URL 和 Key 都不用動(dòng)。如果你要長(zhǎng)期跑編碼任務(wù)或 Agent 工作流Coding Plan 會(huì)更劃算如果只是偶爾調(diào)試模型用模型對(duì)話頁(yè)面就夠了。接入文檔里有更詳細(xì)的參數(shù)說(shuō)明和示例遇到配置問(wèn)題可以先查文檔。API Keys 管理頁(yè)面可以隨時(shí)創(chuàng)建、刪除、查看 Key 的使用情況建議定期檢查一下額度消耗。整套流程走下來(lái)你得到的是一個(gè) 7×24 小時(shí)在線、能操作你 Mac mini 全部文件、可以通過(guò)飛書(shū)隨時(shí)隨地調(diào)用的私人 AI 助手。cpolar 負(fù)責(zé)把本地服務(wù)暴露到公網(wǎng)TaoToken 負(fù)責(zé)統(tǒng)一管理模型調(diào)用憑據(jù)OpenClaw 負(fù)責(zé)執(zhí)行具體任務(wù)飛書(shū)負(fù)責(zé)讓你隨時(shí)隨地下達(dá)指令。四個(gè)環(huán)節(jié)各司其職配合起來(lái)就是一個(gè)完整的家庭 AI 服務(wù)器方案。