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