1. 為什么要在 Mac mini 上折騰 OpenClaw 加飛書這套組合先說結(jié)論Mac mini 跑 OpenClaw再通過飛書機(jī)器人遠(yuǎn)程調(diào)用是目前我試過的「家庭 AI 服務(wù)器」方案里性價(jià)比最高的一種。OpenClaw 是一個(gè)完全開源、本地部署的 AI 智能體平臺(tái)它和網(wǎng)頁版對(duì)話工具最大的區(qū)別在于——它能直接操作你的 macOS 系統(tǒng)讀寫文件、執(zhí)行腳本、控制瀏覽器、生成文檔相當(dāng)于給你的電腦裝了一個(gè)能動(dòng)手的 AI 管家。而 Mac mini 功耗低、性能夠、可以 7×24 小時(shí)掛著不關(guān)機(jī)天生就是跑這類常駐服務(wù)的料。但光部署上去還不夠。你總不能每次想用 AI 都跑到 Mac mini 面前打開瀏覽器。所以我們需要把它接入飛書——這樣你在手機(jī)上發(fā)一條消息家里的 Mac mini 就會(huì)立刻幫你處理任務(wù)。再配合 cpolar 內(nèi)網(wǎng)穿透OpenClaw 生成的網(wǎng)頁、搭建的本地服務(wù)還能一鍵暴露到公網(wǎng)朋友點(diǎn)開鏈接就能直接體驗(yàn)。這套流程涉及幾個(gè)關(guān)鍵環(huán)節(jié)Node.js 環(huán)境準(zhǔn)備、OpenClaw 安裝與模型配置、飛書應(yīng)用創(chuàng)建與事件訂閱、cpolar 內(nèi)網(wǎng)穿透。其中模型調(diào)用憑據(jù)的管理我建議用 TaoToken 統(tǒng)一 Key 通道來處理后面會(huì)詳細(xì)講怎么配。整篇教程按「能跟著做」的標(biāo)準(zhǔn)來寫每個(gè)命令、每段配置都會(huì)給全遇到容易踩坑的地方我會(huì)單獨(dú)標(biāo)出來。適合誰看有一臺(tái) Mac miniM 系列芯片都行、想讓 AI 幫自己干活的開發(fā)者或技術(shù)愛好者、想搭一個(gè)私人 AI 助手但不想把數(shù)據(jù)傳到第三方平臺(tái)的人。如果你之前沒接觸過 OpenClaw也沒關(guān)系跟著步驟走就行。2. TaoToken 統(tǒng)一 Key 前置準(zhǔn)備與模型通道配置在開始裝 OpenClaw 之前先把模型調(diào)用的憑據(jù)問題解決掉。OpenClaw 本身不提供模型它需要你接入一個(gè) AI 大模型的 API。你可以直接去各家平臺(tái)注冊(cè)拿 Key但問題是不同平臺(tái)的 Key 格式不一樣、額度分散、切換模型時(shí)要改配置。我實(shí)測(cè)下來用 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ǎ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 管理頁面在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。創(chuàng)建好 Key 之后復(fù)制下來后面配置 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ù)你想用的模型來填。比如你想用 Claude 系列就填對(duì)應(yīng)的模型標(biāo)識(shí)想用 GPT 系列換一個(gè) Model ID 就行不用改 Base URL 和 Key。如果你后面要長期跑編碼類任務(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)場填 Base URL 和 Key。提前把 TaoToken 的 Key 準(zhǔn)備好到時(shí)候直接粘貼就行不用中途去注冊(cè)。另外提醒一點(diǎn)TaoToken 是統(tǒng)一的 API 通道不是讓你繞過什么限制它只是幫你把多個(gè)模型的調(diào)用憑據(jù)統(tǒng)一管理起來。你該有的賬號(hào)注冊(cè)、額度充值流程一樣不少只是省去了在多個(gè)平臺(tái)之間來回切換的麻煩。3. Mac mini 環(huán)境準(zhǔn)備與 OpenClaw 可復(fù)制配置片段這一章是整篇教程的核心操作部分我會(huì)把每一步的命令和配置文件都寫全。你可以在 Mac mini 上打開終端Command 空格輸入「終端」回車跟著一步步執(zhí)行。3.1 Homebrew 與 Node.js 安裝先檢查 Homebrew 是否已安裝brew -v如果顯示版本號(hào)就跳過安裝。如果沒有執(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 版本沒有硬性要求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然后填寫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)寫法[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 飛書插件安裝在配置向?qū)У?Select channel 頁面選擇 Feishu/飛書然后選 Download from npm。下載完成后會(huì)提示輸入 App Secret說明插件裝好了。先別急著填下一步我們?nèi)ワw書開放平臺(tái)創(chuàng)建應(yīng)用拿憑據(jù)。4. 飛書機(jī)器人創(chuàng)建與事件訂閱驗(yàn)證請(qǐng)求4.1 創(chuàng)建企業(yè)自建應(yīng)用訪問飛書開放平臺(tái) https://open.feishu.cn/?langzh-CN 登錄后點(diǎn)擊「開發(fā)者后臺(tái)」然后點(diǎn)「創(chuàng)建企業(yè)自建應(yīng)用」。填寫應(yīng)用名稱、描述、圖標(biāo)點(diǎn)擊創(chuàng)建。進(jìn)入應(yīng)用詳情頁后點(diǎn)擊「添加應(yīng)用能力」找到「機(jī)器人」點(diǎn)添加。然后在「如何開始使用」部分點(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)開通」和「確認(rèn)」。4.3 獲取憑據(jù)并填入 OpenClaw在左側(cè)菜單「憑證與基礎(chǔ)信息」頁面復(fù)制 App Secret 和 App ID?；氐?Mac mini 終端把 App Secret 粘貼進(jìn)去回車再把 App ID 粘貼進(jìn)去回車。提示 client ready 就說明連接成功了。接著依次選擇 WebSocket (default)、Feishu - China、Allowlist。Group chat allowlist 直接回車跳過不讓機(jī)器人加群。4.4 完成剩余配置Search provider 選 Skip for nowConfigure skills now 選 NOEnable hooks 按需勾選我一般全選然后等待網(wǎng)關(guān)安裝完成。安裝完成后選 Open The Web UI瀏覽器會(huì)自動(dòng)打開 OpenClaw 頁面。你可以發(fā)一條測(cè)試消息你好你是誰你當(dāng)前運(yùn)行在什么操作系統(tǒng)上接入的是什么模型你能夠干什么請(qǐng)?jiān)敿?xì)回答。如果能看到正?；貜?fù)說明模型通道和 OpenClaw 本體都通了。4.5 飛書事件訂閱配置回到飛書開放平臺(tái)在左側(cè)「事件與回調(diào)」菜單里把訂閱方式改為「長連接」然后保存。注意如果 OpenClaw 網(wǎng)關(guān)沒啟動(dòng)或者渠道沒添加長連接會(huì)保存失敗。保存后點(diǎn)右下角「添加事件」搜索「接收消息」勾選后確認(rèn)。然后到「版本管理與發(fā)布」頁面點(diǎn)「創(chuàng)建版本」填寫版本號(hào)和更新說明保存后點(diǎn)「確認(rèn)發(fā)布」。4.6 授權(quán)機(jī)器人下載飛書客戶端并登錄在「開發(fā)小助手」里找到你剛發(fā)布的機(jī)器人點(diǎn)「打開應(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)成功提示后再在飛書里發(fā)消息測(cè)試機(jī)器人就能正?；貜?fù)了。5. 常見報(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ò)了或者過期了。檢查~/.openclaw/下的配置文件確認(rèn)apiKey字段和 TaoToken 控制臺(tái)里的一致。如果是 local proxy failed通常是 Base URL 寫錯(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ì)話頁面測(cè)試一下該模型是否能正常返回再回到 OpenClaw 里配置。5.3 OAuth 相關(guān)報(bào)錯(cuò)飛書側(cè)如果出現(xiàn) OAuth 報(bào)錯(cuò)檢查應(yīng)用權(quán)限是否全部開通、版本是否已發(fā)布、事件訂閱是否選了長連接。另外確認(rèn) OpenClaw 網(wǎng)關(guān)處于運(yùn)行狀態(tà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然后訪問 http://127.0.0.1:9200 登錄 cpolar Web UI。注冊(cè)賬號(hào)后在「隧道管理」里創(chuàng)建一個(gè) HTTP 隧道本地地址填你的服務(wù)端口比如 OpenClaw 生成的網(wǎng)頁跑在 8080就填 8080地區(qū)選 China Top。創(chuàng)建完成后在「狀態(tài)」→「在線隧道列表」里能看到公網(wǎng)地址。比如你的貪吃蛇小游戲跑在 8080穿透后訪問https://你的隧道地址/snake.html就能打開。如果需要固定域名去 cpolar 的預(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 幫你做很多事。比如在飛書里發(fā)一句「幫我截一張當(dāng)前屏幕的圖發(fā)給我」它就能調(diào)用系統(tǒng)工具截圖并通過飛書發(fā)回來。或者讓它「寫一個(gè)貪吃蛇小游戲放在桌面并運(yùn)行起來」它會(huì)生成 HTML 文件、啟動(dòng)本地服務(wù)你通過 cpolar 穿透后就能在手機(jī)上玩。我試過讓它做 PPT說「幫我做一個(gè)關(guān)于元旦節(jié)的 PPT10 頁左右做完截圖給我看」它會(huì)調(diào)用本地應(yīng)用生成文件并截圖反饋。如果 Mac mini 上沒裝辦公軟件它還會(huì)問你要不要裝一個(gè)。這些玩法的前提是模型通道穩(wěn)定。用 TaoToken 統(tǒng)一 Key 的好處在這里就體現(xiàn)出來了不管你后面想換 Claude 還是換其他模型只需要改 Model IDBase URL 和 Key 都不用動(dòng)。如果你要長期跑編碼任務(wù)或 Agent 工作流Coding Plan 會(huì)更劃算如果只是偶爾調(diào)試模型用模型對(duì)話頁面就夠了。接入文檔里有更詳細(xì)的參數(shù)說明和示例遇到配置問題可以先查文檔。API Keys 管理頁面可以隨時(shí)創(chuàng)建、刪除、查看 Key 的使用情況建議定期檢查一下額度消耗。整套流程走下來你得到的是一個(gè) 7×24 小時(shí)在線、能操作你 Mac mini 全部文件、可以通過飛書隨時(shí)隨地調(diào)用的私人 AI 助手。cpolar 負(fù)責(zé)把本地服務(wù)暴露到公網(wǎng)TaoToken 負(fù)責(zé)統(tǒng)一管理模型調(diào)用憑據(jù)OpenClaw 負(fù)責(zé)執(zhí)行具體任務(wù)飛書負(fù)責(zé)讓你隨時(shí)隨地下達(dá)指令。四個(gè)環(huán)節(jié)各司其職配合起來就是一個(gè)完整的家庭 AI 服務(wù)器方案。