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