npx -y @tencent-weixin/openclaw-weixin-cli@latest install、掃碼即可綁定，不必再押注 Wechaty 等灰色橋。本文對比官方外掛與社群方案的風險差異，列出微信 8.0.70 與 Gateway 就緒等前置條件，給出六步跟做與三條硬數據，說明單聊限制、24 小時互動規則與安全審核，並解釋為何合蓋筆電不適合做 ClawBot 宿主、KVMNODE 獨佔雲端 Mac + launchd 常駐更匹配生產口徑；與 OpenClaw 全天候穩定執行、雲端 Mac 安裝排錯、官方 install-daemon、診斷梯子 交叉閱讀。
2026 年微信 ClawBot 與社群橋接：官方外掛到底改變了什麼
OpenClaw 長期透過 Telegram、Discord、Slack 等海外頻道接入手機端；國內團隊若要用微信，過去只能依賴 Wechaty、iPad 協定或各類非官方 webhook。這些路徑的共同問題是協定隨時可能失效、帳號存在風控與封號不確定性、維護成本落在個人開發者身上。2026 年 3 月 22 日前後，騰訊在微信內上線「微信 ClawBot」官方外掛，並發布 npm 作用域 @tencent-weixin/openclaw-weixin-cli，把「掃碼綁定執行中的 OpenClaw Gateway」變成正規產品流程。
從產品語意上，ClawBot 不是微信內建的大語言模型，而是把你已經設定好的 OpenClaw Agent（人格、MEMORY、Skills、模型路由）接到微信聯絡人列表裡的一個會話視窗。訊息經微信用戶端進出，推理與工具呼叫仍在你的 Gateway 主機完成；騰訊側對內容做安全審核，但不等同於把對話託管到騰訊模型。這與「裝一個微信 AI 小程式」完全不同，排錯時要分清是微信通道斷了，還是 Gateway 或模型 API 斷了。
協定合規：官方外掛走微信外掛體系，避免社群橋常見的封號與協定突變。
安裝面極窄：終端機一條 npx 命令產生 QR Code，無需自建中間層服務。
能力繼承 OpenClaw：微信裡對話的是你的 Agent，不是固定廠商模型。
產品限制明確：目前以單聊為主，群聊與企業場景需走企微外掛等其它通道。
維運仍在你側：Gateway 離線、18789 不健康、launchd token 缺失時，微信側只會表現為發不出或延遲。
若你尚未在雲端主機上把 Gateway 裝成可觀測的常駐服務，請先完成 install-daemon 跟做，再開 ClawBot；否則掃碼成功後的首則訊息最容易卡在「Gateway 其實沒在聽」。對需要稽核與變更單的團隊，應在工單中標註外掛版本、CLI 套件版本與 Gateway 版本三者的對應關係，避免升級 OpenClaw 後微信通道仍指向舊路由表。
前置條件對照表：微信版本、OpenClaw 就緒與模型 Key
ClawBot 安裝失敗有一半來自微信用戶端版本未達標，另一半來自OpenClaw 執行個體未真正 ready。下面表格把值班時要對齊的欄位寫在一起，可直接貼進變更單。若團隊分散在多地，還應確認 Gateway 主機的出向頻寬與 npm registry 延遲，否則 npx 拉包超時會被誤判為微信外掛故障。
| 檢查項 | 要求 | 未滿足時的典型現象 |
|---|---|---|
| 微信版本 | iOS 8.0.70+ / Android 8.0.69+，設定→外掛可見 ClawBot | 外掛列表無入口，或掃碼頁提示版本過低 |
| OpenClaw Gateway | openclaw gateway status --deep 為 ready，18789 單一監聽 | 掃碼成功但訊息無回覆、或 CLI 報 RPC 逾時 |
| Node / CLI | 與 install.sh 或文件一致的 Node 22 口徑，which openclaw 在 SSH 與 launchd 一致 | install 腳本找不到 Gateway 或綁定到錯誤執行個體 |
| 模型 API | openclaw.json 中至少一條可用上游 Key | 微信能收發但回覆為空或 401，需查模型帳單而非微信 |
| 網路出向 | 主機可存取模型 API 與 npm registry | npx 拉包失敗或 QR Code 產生逾時 |
先讓 Gateway 在終端機裡健康，再開微信外掛；順序反了會把所有問題都記成「微信壞了」。
在 KVMNODE 獨佔雲端 Mac 上，還要確認狀態目錄不在 iCloud 或企業同步碟，否則 Gateway 間歇性寫庫失敗會讓 ClawBot 表現為隨機掉線。憑證與 token 問題請對照 launchd token 與 診斷梯子 L2，不要先重裝微信。若模型 Key 放在環境變數而非 openclaw.json，請確認 launchd plist 的 EnvironmentVariables 與互動式 SSH 一致，否則終端機測試通過、常駐 Gateway 仍無法推理。
六步跟做：從微信外掛到掃碼綁定與通道驗收
升級微信：我 → 設定 → 關於微信，確認版本達標後返回「外掛」。
開啟 ClawBot 外掛：設定 → 外掛 →「微信 ClawBot」→ 查看詳情頁中的安裝說明。
在 Gateway 主機執行：npx -y @tencent-weixin/openclaw-weixin-cli@latest install（與 OpenClaw 同一台機器或 SSH 工作階段）。
微信掃一掃終端機 QR Code，在手機上確認綁定；QR Code 有效期短，過期需重新執行上一步。
在微信「微信 ClawBot」會話發測試句，對照 Gateway 日誌與 openclaw channels probe（若已設定 channels 探針）。
重啟 Gateway 後再發一則：確認 launchd 拉起後通道仍在線，把版本號、綁定時間與首則訊息時間戳記寫入變更單。
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH" openclaw gateway status --deep npx -y @tencent-weixin/openclaw-weixin-cli@latest install openclaw gateway restart openclaw channels probe 2>/dev/null || true
綁定命令必須在正在執行 Gateway 的那台主機上執行。若 OpenClaw 在 KVMNODE 新加坡節點而你在本地筆電終端機跑 npx，QR Code 會指向錯誤執行個體。遠端團隊應 SSH 到雲端 Mac 再安裝，或在本機用 ssh user@host 'npx ...' 顯式指定工作階段。驗收週請保留 Gateway 日誌片段與微信側首則訊息截圖的時間對齊，方便事後區分是通道延遲還是模型推理慢。
單聊、多 Agent 與企業微信：產品形態怎麼選才不亂
官方文件與社群實測均指出：目前 ClawBot 面向單聊，不支援把同一個外掛綁進微信群做多人 @。外掛入站會走 OpenClaw 的 resolveAgentRoute，按 channel + accountId + peer 匹配路由，因此「每個微信帳號 + 每個聊天對象」有獨立會話上下文，但不建議在同一微信對話裡頻繁切換 Agent 角色，容易把狀態機打亂。
| 玩法 | 適用 | 注意 |
|---|---|---|
| 單微信號 + 主 Agent 內部調度 | 大多數人日常助理 | 微信裡只看到一個視窗，背後 Skills 分流任務 |
| 多微信號各綁一 Agent | 內容 / 維運角色硬隔離 | 外掛支援多帳號在線，需分別掃碼 |
| 企業微信 OpenClaw 外掛 | 組織內機器人、文件協作 | 與個人 ClawBot 並行，不互相替代 |
企業場景若需要群機器人、應用訊息或文件 API，應走企業微信側官方 OpenClaw 外掛（騰訊文件已單獨維護），不要把個人 ClawBot 當成企微替代。個人微信適合「隨時問自己的 Agent」；企微適合「團隊流程與審批」。兩套通道可以同時掛在同一 Gateway 上，但路由表要在 openclaw.json 裡寫清楚，避免 peer 規則重疊。若 MEMORY 含敏感業務資料，應在 openclaw.json 限制哪些 Skills 可在微信 channel 觸發，避免工具輸出經微信審核失敗。
注意事項、排錯順序與雲端 Mac 常駐選型
QR Code 過期：終端機 QR Code 幾分鐘內失效，逾時重新 npx，不要反覆用同一張截圖掃。24 小時互動規則：部分主動推送在長時間未對話時可能被丟棄，適合「你問我答」而非無人值守群發行銷。內容安全審核：微信側會對訊息做合規檢測，觸發規則時表現為傳送失敗或提示，需在 OpenClaw 側調整提示詞或工具輸出，而非重綁外掛。Gateway 睡眠：筆電合蓋後 ClawBot 會斷；這與 Telegram 頻道掉線機理相同，只是使用者感知更強，因為微信是日活入口。
官方 CLI 套件名：@tencent-weixin/openclaw-weixin-cli，與社群 npm 仿冒包區分。
預設探針埠：Gateway 仍常用 18789 做本地健康檢查，與 安裝排錯清單 一致。
微信版本門檻：8.0.70（iOS）/ 8.0.69（Android）為 2026 年 3 月文件常見寫法，升級後再開外掛。
排錯順序建議：gateway status --deep → 模型 API 探活 → 重新 npx install 掃碼 → 查 Gateway 日誌 → 再動微信重裝。若 channels 401 或 split brain，先讀 CLI 與 Gateway 對齊，避免在微信裡反覆解綁重綁。值班時應把「微信傳送失敗」與「Gateway 無回應」拆成兩條工單欄位，減少跨團隊來回。
| 宿主 | ClawBot 體驗 | 維運結論 |
|---|---|---|
| 合蓋筆電 | 睡眠即斷線，掃碼成功也維持不久 | 僅適合個人試驗 |
| 家用 NAS / 弱配 VPS | 能跑但 Node 與磁碟 IO 易抖 | 需自建監控，非 Apple 生態 |
| KVMNODE 獨佔雲端 Mac | launchd 守護 + 近區 Git/模型出網可選 | 7×24 微信入口的生產預設 |
當同一台雲端 Mac 還要跑 iOS CI 與多 Skills 並行時，16GB 統一記憶體在尖峰週可能讓 Gateway 與 xcodebuild 爭搶記憶體，表現為微信回覆變慢而非通道斷開；此時應參考站內同池隔離文升 M4 Pro 或拆池，而不是反覆掃碼。對需要可稽核、可換區、且 ClawBot 與 Gateway 同機的團隊，KVMNODE Mac Mini 雲端租用通常是更優解：獨佔主機、六區節點、按天至月租，與 18789、launchd、模型 Key 共用同一套 Runbook。檔位見 定價頁，操作見 幫助中心，下單見 訂購入口。