1. 企業(yè)微信機器人接 OpenClaw 到底難在哪企業(yè)微信智能機器人接入 OpenClaw核心要解決的是「消息怎么從企微到 OpenClaw、回復怎么從 OpenClaw 回到企微」這條鏈路。企業(yè)微信官方給了兩種通道回調 URL 模式和長連接Websocket模式。前者需要你有公網域名、備案、HTTPS 證書還要處理企微服務器的簽名校驗后者由 OpenClaw 主動向企微建立 Websocket 通道不需要公網入口內網機器、本地開發(fā)機都能跑通。這篇面向的是需要在企業(yè)微信側搭一條穩(wěn)定機器人通道的開發(fā)者尤其是手里只有一臺內網服務器、又不想折騰域名證書的人。我會把 config.toml 和 settings.json 的骨架直接給出來把 TaoToken 作為統(tǒng)一 Key/API 通道接進去最后用一條真實消息驗證長連接是否建立、消息是否回環(huán)。整套流程走完你應該能在企業(yè)微信里對著自己創(chuàng)建的機器人發(fā)消息并收到 OpenClaw 的回復。需要提前說清楚一點長連接模式省掉的是公網暴露面不是省掉鑒權。Bot ID 和 Secret 仍然是身份憑證泄露了別人就能冒充你的機器人。所以配置文件別提交到公開倉庫Secret 用環(huán)境變量注入更穩(wěn)妥。2. 前置準備TaoToken 統(tǒng)一 Key 與 OpenClaw 環(huán)境2.1 為什么這里要引入 TaoTokenOpenClaw 本身是消息編排層它要調用大模型才能產生回復。如果你在 OpenClaw 里直接寫某一家廠商的 base_url 和 key后面換模型、加備用通道都要改配置。TaoToken 提供的是 OpenAI 兼容的統(tǒng)一 API 通道base_url 固定、key 統(tǒng)一OpenClaw 側只認一個地址模型切換在服務端完成。對長連接場景來說這能減少一類排障變量消息通道和模型通道分開出問題時能快速定位是 Websocket 斷了還是模型調用失敗了。TaoToken 官網入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 注意這個地址后面不加任何查詢參數。你需要在控制臺創(chuàng)建一個 API Key后面寫進 OpenClaw 的模型配置里。2.2 環(huán)境與依賴檢查企業(yè)微信客戶端裝好并登錄版本盡量新舊版本的工作臺里可能找不到「智能機器人」入口。OpenClaw 這邊本地部署或云服務器部署都行確認進程能正常啟動、日志能輸出。如果跑在云服務器上安全組不需要為長連接額外開入站端口因為連接是 OpenClaw 主動發(fā)起的出站 Websocket只要服務器能訪問外網即可。Node 或 Python 運行時按 OpenClaw 的安裝說明準備配置文件目錄通常在~/.openclaw/或項目根目錄下的config/具體以你安裝時的輸出為準。下面給的路徑按~/.openclaw/寫你按實際位置替換。3. 可復制配置config.toml 與 settings.json 骨架3.1 創(chuàng)建企微機器人并拿到憑證打開企業(yè)微信客戶端進工作臺找到智能機器人應用點創(chuàng)建機器人。創(chuàng)建方式選 API 模式連接方式務必選長連接Websocket。創(chuàng)建完成后進入詳情頁記錄兩個字段Bot ID 和 Secret。這兩個值就是后面 config.toml 里要填的。注意Secret 只在創(chuàng)建時完整展示頁面刷新后可能不再明文顯示先復制到安全的地方。3.2 config.toml 渠道配置骨架OpenClaw 的渠道配置寫在 config.toml 里。下面這段可以直接抄把尖括號部分替換成你的真實值[channels.wecom] type wecom mode websocket bot_id YOUR_BOT_ID secret YOUR_BOT_SECRET reconnect_interval 5 heartbeat_interval 30 log_level info [model] provider openai-compatible base_url https://taotoken.net/api api_key YOUR_TAOTOKEN_API_KEY model gpt-4o-mini timeout 60幾個參數說明一下。mode必須是websocket寫成callback就走回調 URL 模式了。reconnect_interval是斷線重連間隔單位秒網絡抖動時靠它自動恢復。heartbeat_interval是心跳間隔企微側對空閑連接有超時策略心跳太稀會被判定掉線。base_url填 TaoToken 的 API 地址注意結尾不要帶斜杠也不要加 UTM 參數。3.3 settings.json 補充配置有些 OpenClaw 版本把運行時開關放在 settings.json 里和 config.toml 分工不同。下面這份是常見骨架{ channel: { wecom: { enabled: true, transport: websocket, auto_reconnect: true, max_retry: 10 } }, model: { endpoint: https://taotoken.net/api, stream: true }, logging: { level: info, file: ~/.openclaw/logs/wecom.log } }stream打開后模型回復是流式返回的企微側會看到消息逐步補全。如果你的 OpenClaw 版本不支持流式轉發(fā)到企微把它設成 false 更穩(wěn)。max_retry控制重連次數上限設太小會在網絡恢復前就放棄設太大又可能一直重試10 次是個折中值。3.4 用命令行添加渠道可選如果你不想手改配置文件OpenClaw 提供了交互式命令openclaw channels add執(zhí)行后按提示選渠道類型為「企業(yè)微信」依次輸入 Bot ID 和 Secret在[select ...]處選finish完成基礎配置。之后終端會問配對方式選Pairing。這條路徑和手改配置等價選一種即可不要兩邊都配否則可能出現重復渠道。4. 建立長連接與消息回環(huán)驗證4.1 啟動并觀察連接日志配置寫好后啟動 OpenClawopenclaw start --config ~/.openclaw/config.toml觀察日志里是否出現類似wecom websocket connected或channel wecom ready的行。如果只看到connecting沒有connected多半是 Bot ID 或 Secret 填錯了或者服務器出站被限制?？梢杂?curl 先確認能訪問 TaoToken 的 API 地址curl -s -o /dev/null -w %{http_code}\n https://taotoken.net/api返回 200 或 401 都說明網絡通401 只是沒帶 key不影響判斷連通性。4.2 觸發(fā)配對長連接建立后雙方還需要一次握手配對?；氐狡髽I(yè)微信找到你創(chuàng)建的機器人發(fā)一條任意消息比如「你好」。此時機器人會回復一條包含配置指引的消息最后一行是一串密鑰形如PAIRING:ABCD-EFGH-IJKL。復制這一整行回到 OpenClaw 終端粘貼并回車。終端顯示Successfully configured channel或類似提示就說明配對完成。4.3 驗證消息回環(huán)配對成功后再在企業(yè)微信里發(fā)一條消息。這次應該收到來自 OpenClaw 的智能回復。如果回復內容明顯是模型生成的說明整條鏈路通了企微 → Websocket → OpenClaw → TaoToken API → 模型 → 原路返回。你可以在日志里看到對應的請求記錄確認模型調用走的是https://taotoken.net/api。5. 本篇常見錯排查5.1 配對密鑰無效最常見的原因是復制不完整。企微回復是多行文本只有最后一行是密鑰前面是說明文字。粘貼時注意終端里不要帶多余空格或換行。如果反復失敗用openclaw channels list看渠道狀態(tài)必要時openclaw channels remove 渠道ID刪掉重加。5.2 長連接頻繁斷開先看日志里的斷開原因。如果是心跳超時把heartbeat_interval調小到 15 秒試試。如果是網絡層斷開檢查服務器出站是否穩(wěn)定reconnect_interval可以設成 3 秒加快恢復。企業(yè)微信側對同一 Bot 的連接數有限制別用同一個 Bot ID 在多臺機器上同時連。5.3 消息發(fā)出但無回復分兩步定位。先看 OpenClaw 日志有沒有收到消息事件沒有就是 Websocket 通道問題有收到但沒回復就是模型調用失敗。模型側重點查三處base_url是否寫成https://taotoken.net/api不帶斜杠、不帶參數、api_key是否有效、model名稱是否在 TaoToken 支持的列表里?？梢杂媚Ｐ蛯υ掜撁鎲为殰y一下 key 是否可用。5.4 想改配置或換模式改配置直接編輯 config.toml 后重啟 OpenClaw。想從長連接換成回調 URL 模式需要公網域名和 HTTPS 證書在企微后臺填回調地址OpenClaw 側把mode改成callback并配 URL 和 Token。內網環(huán)境不建議換長連接已經夠用。6. 后續(xù)接入與 Key 管理整套流程跑通后你手里其實有兩個需要長期維護的東西企微機器人的 Bot ID/Secret以及 TaoToken 的 API Key。前者決定消息通道能不能建起來后者決定模型能不能調通。建議把 Secret 和 API Key 都放進環(huán)境變量config.toml 里用占位符引用避免明文躺在磁盤上。如果你后面要接更多渠道比如把同一個 OpenClaw 同時掛到多個機器人上TaoToken 的統(tǒng)一 Key 優(yōu)勢會更明顯模型側只維護一份配置渠道側各自獨立。需要新建或輪換 Key 時到 API Keys 頁面操作即可。模型選型和連通性測試可以直接在模型對話頁面里試不用改 OpenClaw 配置。長期跑編碼類或 Agent 類任務、調用量比較大的場景可以看一下 Coding Plan 的額度方案比按次調用更可控。接入文檔里有完整的參數說明和示例遇到配置項拿不準的時候對著查一遍比反復重啟試錯快得多。