1. 為什么要在 WSL 里跑 OpenClaw 并接飛書(shū)OpenClaw曾用名 Clawdbot、MoltBot是一個(gè)可以部署在自己電腦上的開(kāi)源個(gè)人 AI 助手平臺(tái)它能通過(guò)飛書(shū)、Telegram 等聊天工具跟你交互幫你處理郵件、整理文件、寫代碼。很多人第一次接觸它卡住的地方不是安裝本身而是兩件事一是 Windows 上直接跑不太順二是模型 API Key 分散在 Anthropic、OpenAI、Google 各家配置起來(lái)東一個(gè)西一個(gè)。這篇教程聚焦 Windows WSL 環(huán)境下 OpenClaw 的安裝與飛書(shū)接入全流程重點(diǎn)解決多工具 API Key 分散管理的問(wèn)題。我會(huì)給出可復(fù)制的 config.toml 骨架和 TaoToken 統(tǒng)一 Key 配置片段再配上飛書(shū)機(jī)器人回調(diào)驗(yàn)證、WSL 內(nèi)服務(wù)連通性檢查的具體命令。適合誰(shuí)看手上有 Windows 電腦、想搭一個(gè)飛書(shū)里能直接對(duì)話的私人 AI 助手、又不想被各家 Key 管理折騰的人。整套鏈路從 WSL2 裝好到飛書(shū)里收到機(jī)器人回復(fù)一次跑通。先說(shuō)清楚一個(gè)前提飛書(shū)機(jī)器人功能需要企業(yè)版賬戶個(gè)人賬戶無(wú)法創(chuàng)建自建應(yīng)用。如果你只有個(gè)人飛書(shū)號(hào)這一步會(huì)卡住建議先確認(rèn)賬戶類型。2. TaoToken 前置把分散的 Key 收攏成一個(gè)OpenClaw 支持 Claude、GPT、Gemini 等多種模型默認(rèn)配置下你要分別填 Anthropic API Key、OpenAI API Key、Google AI API Key。三個(gè)平臺(tái)三套計(jì)費(fèi)、三套額度、三個(gè)后臺(tái)用久了很容易亂。我試過(guò)把 Key 寫進(jìn)配置文件后忘了哪個(gè)對(duì)應(yīng)哪個(gè)排查問(wèn)題時(shí)特別費(fèi)勁。TaoToken 的思路是提供一個(gè)統(tǒng)一的 API 入口你只需要一個(gè) Key就能在 OpenClaw 里調(diào)用多家模型。它的 API 地址是https://taotoken.net/api兼容 OpenAI 風(fēng)格的接口調(diào)用方式所以 OpenClaw 里凡是支持自定義 base URL 的模型提供商配置都能指向它。具體怎么接在 OpenClaw 的模型配置里把 provider 的 base URL 改成 TaoToken 的 API 地址然后把 apiKey 填成你在 TaoToken 控制臺(tái)生成的 Key。這樣 OpenClaw 發(fā)出的請(qǐng)求會(huì)先到 TaoToken再由它路由到對(duì)應(yīng)的模型。你不需要在 OpenClaw 里存三家的 Key只存一個(gè)。生成 Key 的入口在控制臺(tái)的 API Keys 頁(yè)面登錄后新建一個(gè)即可。建議給這個(gè) Key 起個(gè)能認(rèn)出來(lái)的名字比如openclaw-wsl方便以后區(qū)分用途。如果你還想先驗(yàn)證模型通不通可以到模型對(duì)話頁(yè)面直接發(fā)一條消息測(cè)試確認(rèn) Key 有效再往 OpenClaw 里配。需要提醒的是TaoToken 是統(tǒng)一的 API 接入服務(wù)不是讓你繞過(guò)任何東西它的定位就是幫你把多模型調(diào)用收斂到一個(gè) Key 上減少配置和維護(hù)成本。3. 可復(fù)制配置WSL 安裝 OpenClaw 飛書(shū)3.1 WSL2 與 Node.js 22 準(zhǔn)備以管理員身份打開(kāi) PowerShell執(zhí)行wsl --install裝完重啟電腦Ubuntu 會(huì)自動(dòng)啟動(dòng)并要求設(shè)置用戶名和密碼。進(jìn)入 Ubuntu 后先更新系統(tǒng)sudo apt update sudo apt upgrade -y接著裝 Node.js 22用 nvm 管理版本更省心curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash source ~/.bashrc nvm install 22 node --version npm --versionnode --version應(yīng)顯示 v22.x.x。WSL2 里要跑后臺(tái)服務(wù)還得開(kāi) systemd。編輯/etc/wsl.confsudo nano /etc/wsl.conf寫入[boot] systemdtrue保存后在 PowerShell 里重啟 WSLwsl --shutdown wsl3.2 安裝 OpenClaw一鍵安裝curl -fsSL https://openclaw.ai/install.sh | bash如果失敗改用手動(dòng)安裝npm install -g openclawlatest遇到權(quán)限問(wèn)題就配置 npm 全局目錄mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc npm install -g openclawlatest驗(yàn)證openclaw --version3.3 初始配置與 TaoToken 統(tǒng)一 Key運(yùn)行配置向?qū)penclaw onboard --install-daemon向?qū)Ю?Gateway 模式選 Local通信渠道先跳過(guò)飛書(shū)稍后配后臺(tái)服務(wù)選 Yes 安裝 systemd 服務(wù)。模型認(rèn)證這一步是關(guān)鍵選擇支持自定義 base URL 的提供商把 base URL 填成https://taotoken.net/apiapiKey 填 TaoToken 控制臺(tái)生成的 Key。配置向?qū)芡旰缶庉媬/.openclaw/openclaw.json確認(rèn)模型部分指向 TaoToken。下面是一個(gè) config.toml 骨架供你對(duì)照填寫OpenClaw 同時(shí)支持 json 與 toml 配置按你實(shí)際使用的文件格式調(diào)整[agents.defaults.model] primary anthropic/claude-sonnet-4-0 [agents.defaults.model.providers.taotoken] baseUrl https://taotoken.net/api apiKey sk-你的TaoTokenKey如果你用的是 json 配置對(duì)應(yīng)片段是{ agents: { defaults: { model: { primary: anthropic/claude-sonnet-4-0, providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey } } } } } }這樣 OpenClaw 調(diào)用模型時(shí)統(tǒng)一走 TaoToken不再需要分別維護(hù) Anthropic、OpenAI、Google 的 Key。3.4 飛書(shū)應(yīng)用創(chuàng)建與權(quán)限進(jìn)入飛書(shū)開(kāi)發(fā)者后臺(tái)https://open.feishu.cn/app?langzh-CN創(chuàng)建企業(yè)自建應(yīng)用名字隨意比如「clawbot機(jī)器人」。創(chuàng)建后在「添加應(yīng)用能力」里選「機(jī)器人」并添加。在「憑證與基礎(chǔ)信息」頁(yè)面記下 App ID格式cli_xxxxxxxxx和 App Secret。進(jìn)入「權(quán)限管理」開(kāi)啟必需權(quán)限權(quán)限標(biāo)識(shí)說(shuō)明contact:user.base:readonly獲取用戶基本信息im:message發(fā)送和接收消息im:message.p2p_msg:readonly讀取私聊消息im:message.group_at_msg:readonly接收群聊 機(jī)器人 消息im:message:send_as_bot以機(jī)器人身份發(fā)送消息im:resource上傳和下載圖片/文件進(jìn)入「事件與回調(diào)」訂閱方式選「長(zhǎng)連接」不要選 Webhook添加事件im.message.receive_v1。長(zhǎng)連接模式無(wú)需暴露端口或配 SSL 證書(shū)適合本地部署。最后到「版本管理與發(fā)布」創(chuàng)建版本并發(fā)布到測(cè)試版本。3.5 安裝飛書(shū)插件并配置openclaw plugins install m1heng-clawd/feishu openclaw plugins list設(shè)置憑證并啟用渠道openclaw config set channels.feishu.appId cli_xxxxxxxxx openclaw config set channels.feishu.appSecret your_app_secret openclaw config set channels.feishu.enabled true完整配置參考~/.openclaw/openclaw.json里的channels.feishu部分{ channels: { feishu: { enabled: true, appId: cli_xxxxxxxxx, appSecret: your_app_secret, domain: feishu, connectionMode: websocket, dmPolicy: pairing, groupPolicy: allowlist, requireMention: true, mediaMaxMb: 30, renderMode: auto } } }配置項(xiàng)說(shuō)明配置項(xiàng)說(shuō)明可選值domain服務(wù)區(qū)域feishu中國(guó)/ lark國(guó)際connectionMode連接模式websocket推薦/ webhookdmPolicy私聊策略pairing / open / allowlistgroupPolicy群聊策略open / allowlist / disabledrequireMention群聊是否需要 機(jī)器人true / falserenderMode回復(fù)渲染模式auto / raw / card改完重啟 Gatewayopenclaw gateway restart4. 驗(yàn)證請(qǐng)求與成功結(jié)果4.1 WSL 內(nèi)服務(wù)連通性檢查先確認(rèn) Gateway 起來(lái)了openclaw health openclaw status openclaw doctor如果服務(wù)沒(méi)自動(dòng)啟動(dòng)openclaw gateway start想邊跑邊看日志用openclaw gateway --port 18789 --verbose訪問(wèn)http://127.0.0.1:18789/能打開(kāi) Web 控制臺(tái)說(shuō)明本地服務(wù)正常。4.2 驗(yàn)證 TaoToken Key 是否生效在 WSL 里直接測(cè)一下 API 連通性curl -s https://taotoken.net/api/v1/models \ -H Authorization: Bearer sk-你的TaoTokenKey能返回模型列表就說(shuō)明 Key 有效。如果這一步報(bào) 401先回控制臺(tái)確認(rèn) Key 沒(méi)被刪或沒(méi)寫錯(cuò)。4.3 飛書(shū)渠道狀態(tài)與配對(duì)openclaw channels status openclaw channels status --probe在飛書(shū)里搜索你的機(jī)器人名稱發(fā)一條「你好」。如果dmPolicy設(shè)的是pairing首次會(huì)收到配對(duì)碼然后openclaw pairing list feishu openclaw pairing approve feishu code批準(zhǔn)后再發(fā)消息機(jī)器人就會(huì)回復(fù)。群聊測(cè)試則把機(jī)器人拉進(jìn)群它并發(fā)送消息?？吹交貜?fù)即整條鏈路跑通。5. 本篇常見(jiàn)錯(cuò)排查5.1 Gateway 無(wú)法啟動(dòng)lsof -i :18789 openclaw gateway --verbose openclaw doctor --fix端口被占用就換端口或殺掉占用進(jìn)程。5.2 飛書(shū)消息無(wú)響應(yīng)openclaw channels status --probe openclaw logs --follow | grep -i feishu openclaw pairing list feishu重點(diǎn)看事件訂閱是不是選了長(zhǎng)連接、im.message.receive_v1有沒(méi)有加、應(yīng)用版本有沒(méi)有發(fā)布。5.3 API Key 配置問(wèn)題openclaw configure openclaw config set agents.defaults.model.primary anthropic/claude-sonnet-4-0如果模型調(diào)用報(bào)錯(cuò)先確認(rèn) base URL 是https://taotoken.net/api再確認(rèn) Key 沒(méi)寫錯(cuò)。5.4 插件加載錯(cuò)誤升級(jí)后出現(xiàn)Cannot find module clawdbot/plugin-sdkopenclaw plugins uninstall feishu openclaw plugins install m1heng-clawd/feishu5.5 WSL2 網(wǎng)絡(luò)問(wèn)題要從其他設(shè)備訪問(wèn) WSL 里的服務(wù)在 PowerShell管理員里做端口轉(zhuǎn)發(fā)$WslIp (wsl -- hostname -I).Trim().Split( )[0] netsh interface portproxy add v4tov4 listenport18789 listenaddress0.0.0.0 connectport18789 connectaddress$WslIp6. 接下來(lái)怎么走如果你卡在接入或排障環(huán)節(jié)先去 TaoToken 控制臺(tái)確認(rèn) API Keys 狀態(tài)再對(duì)照接入文檔檢查 base URL 和請(qǐng)求頭格式這兩處是最容易出問(wèn)題的地方。想先驗(yàn)證模型通不通直接到模型對(duì)話頁(yè)面發(fā)一條消息最快。如果你打算長(zhǎng)期在 OpenClaw 里跑編碼任務(wù)或 Agent 工作流Coding Plan 更適合額度和調(diào)用方式都按持續(xù)使用來(lái)設(shè)計(jì)。日常維護(hù)記住幾條命令就夠了openclaw status openclaw health openclaw logs --follow openclaw plugins update feishuWSL2 配了 systemd 后OpenClaw 服務(wù)會(huì)隨 WSL 啟動(dòng)自動(dòng)拉起用systemctl --user status openclaw-gateway確認(rèn)即可。飛書(shū)云文檔集成還需要額外加wiki:wiki:readonly和drive:drive:readonly權(quán)限并且要把機(jī)器人添加到知識(shí)庫(kù)空間——光有 API 權(quán)限不夠機(jī)器人沒(méi)有自己的「我的空間」只能訪問(wèn)被分享給它的文件。