@tencent-weixin/openclaw-weixin）讓 OpenClaw 能以官方合規通道接入微信單聊，不再依賴灰色第三方橋接。團隊若在版本矩陣、用戶端灰度與 Gateway 宿主上踩雷，常見表現是掃碼登入成功、Control UI 顯示頻道已連線，卻在真實對話裡收不到 Agent 回覆，或升級 OpenClaw 小版本後外掛 ABI 不匹配導致靜默丟包。本文提供可抄表路徑：一鍵 openclaw-weixin-cli 安裝、1.0.x/2.0.x 與 OpenClaw 2026.3.x 的對照釘版、微信 8.0.70+ 用戶端要求，以及把7×24 Gateway 落在雲端 Mac 而本機僅作控制台的三分法分工。
微信 ClawBot 接入最常見的五條誤判簽名
騰訊微信 ClawBot 在 2026 年的接入面同時涵蓋 macOS Gateway 宿主、OpenClaw 核心版本與微信用戶端灰度三條線。維運若把「掃碼成功」當成「生產可用」，就會忽略單聊-only 限制、檔案僅入不出與24 小時無互動後主動訊息可能被平台丟棄等產品邊界。更隱蔽的是外掛版本與 OpenClaw 核心漂移：1.0.x 面向 >=2026.3.0 且 <2026.3.22，2.0.x 面向 >=2026.3.22——跨線升級卻不 gateway restart，doctor 有時仍綠燈。建議變更單先勾選下列簽名編號，再決定是回退外掛、換副號，還是把 Gateway 遷到不睡眠的雲端 Mac。
把第三方 iPad 協議橋當成與官方 ClawBot 等價：非官方橋接面臨封號與協議變更風險；官方外掛走合規 API，能力邊界（單聊、檔案方向、敏感詞）不同，不能沿用舊 Runbook。
未核對微信用戶端版本就掃碼：iOS 需 8.0.70 及以上全量；Android 8.0.69+ 仍處灰度，低版本用戶端會導致登入態異常或訊息不同步。
OpenClaw 升級後未同步 openclaw-weixin 大版本：2026.3.22 是分界線，仍釘在 1.0.x 時可能出現 channels 假連線；應查 openclaw --version 並對照矩陣換 2.0.x。
在群聊或企業場景期待 ClawBot 回覆：目前僅支援單聊；向群組 @ 機器人無回應屬於產品限制，不是 Gateway 故障。
用主號承載生產 Agent 並傳輸金鑰片段：資料經境內伺服器、敏感詞過濾；合規要求使用副號，且勿在微信內傳送 API Key、內網位址或客戶隱私。
給簽名貼標籤後再動模型路由與頻道策略。若 Gateway 從未在雲主機驗收，請先對照 OpenClaw 雲端 Mac 安裝與 Lobster 工作流 完成 install.sh 與守護；若已連線卻不回覆，應並行閱讀 頻道已連線但不回覆 把行程層與策略層拆開，避免在微信側反覆掃碼掩蓋 Gateway 埠號或 pairing 問題。
第三方橋接、官方 ClawBot 與「雲端 Mac Gateway」三分法決策矩陣
2026 年社群裡仍可見多種微信接入方案，但生產選型應把合規性、能力邊界與 7×24 可達性放在同一表格裡比較。官方 ClawBot 適合需要騰訊背書、接受單聊與內容審核的團隊；第三方橋接可能在群聊或檔案外發上有額外能力，卻伴隨協議與帳號風險；無論選哪條訊息路徑，Gateway 控制面仍建議落在不睡眠的雲端 Mac，筆電僅作掃碼與 Control UI。下表粗粒度對齊常見組合，細節以騰訊與 OpenClaw 當期文件為準。
| 維度 | 第三方協議橋 | 官方 openclaw-weixin | 雲端 Mac Gateway + 官方外掛 |
|---|---|---|---|
| 合規與帳號風險 | 高，易觸發風控 | 騰訊官方外掛，需副號 | 同官方，宿主更穩 |
| 會話形態 | 視橋接而定，常含群聊 | 僅單聊 | 僅單聊，7×24 在線 |
| 檔案能力 | 視實作，雙向常見 | 僅入站接收，不可外發 | 同官方限制 |
| 安裝入口 | 各專案異構 | npx @tencent-weixin/openclaw-weixin-cli | 雲端 Mac 上 CLI + LaunchAgent |
| 版本耦合 | 與 OpenClaw 弱相關 | 1.0.x / 2.0.x 矩陣 | 需與 Master 同步釘版 |
| 2026 建議場景 | 不建議生產 | 合規單聊助手 | 跨區團隊、自動化負責人 |
訊息走官方 ClawBot，控制面走雲端 Mac loopback；不要在筆電睡眠上賭微信 7×24。
選定官方外掛後，文件應寫明：哪台雲端 Mac 跑 Gateway、微信副號由誰保管、OpenClaw 與 openclaw-weixin 的釘版版本。實驗期可在本機 Mac 臨時起 Gateway 做掃碼冒煙，但不要與雲端 Mac Master 同時接同一頻道憑證，否則會出現雙消費與靜默丟訊息。Windows 開發機若僅作 Node，分裂拓撲見 Windows/WSL2 與雲端 Mac Gateway 分工；全平台 Gateway 排錯見站內部署手冊。
openclaw-weixin-cli 一鍵安裝、手動外掛鏈與版本相容矩陣
建議入口是騰訊提供的 CLI 包裝器，會在已安裝 OpenClaw 的宿主上拉取匹配版本的 @tencent-weixin/openclaw-weixin 並完成 config 寫入。若你需要在 CI 或變更視窗裡逐步執行，也可走手動外掛鏈：install → enable → channels login → gateway restart。安裝前請確認 OpenClaw 已 >=2026.3.0，並依核心版本選擇外掛大版本：1.0.x 對應 OpenClaw >=2026.3.0 且 <2026.3.22；2.0.x 對應 >=2026.3.22。微信側請準備 iOS 8.0.70+ 或 Android 8.0.69+（灰度）用戶端，用副號掃碼。
npx -y @tencent-weixin/openclaw-weixin-cli@latest install openclaw plugins install "@tencent-weixin/openclaw-weixin" openclaw config enable channels.openclaw-weixin openclaw channels login --channel openclaw-weixin openclaw gateway restart openclaw channels probe --channel openclaw-weixin openclaw doctor
CLI 的 @latest 會嘗試解析目前 OpenClaw 版本並安裝相容外掛；若你已在變更單裡釘版 OpenClaw 到某一 2026.3.x 建置，建議在安裝後記錄 openclaw plugins list 輸出，把 openclaw-weixin 版本寫進 wiki。掃碼登入應在與 Gateway 同機或經安全隧道可達 Control UI 的環境完成；登入成功後用真實副號向 Bot 傳送文字，確認 inbound 進入 Agent 且 outbound 在單聊內可見。若 probe 失敗，先 openclaw gateway status 與 openclaw logs，再核對外掛大版本是否跨線。
提示：產品限制備忘——僅單聊；檔案僅可接收不可外發；會話24 小時無互動後平台可能不再投遞主動訊息。資料經境內伺服器處理並過濾敏感詞，請勿傳輸金鑰或客戶隱私。
六步 Runbook：從版本釘版到微信單聊冒煙
凍結版本三元組：記錄 OpenClaw 版本、openclaw-weixin 1.0.x 或 2.0.x、微信用戶端版本（iOS 8.0.70+ / Android 8.0.69+ 灰度）與副號歸屬。
雲端 Mac 部署 Gateway Master：依 Lobster 安裝文完成 install.sh、onboard、LaunchAgent；確認 loopback 18789 與 gateway status 正常。
安裝官方外掛：優先 npx -y @tencent-weixin/openclaw-weixin-cli@latest install；變更視窗可改用手動 plugins install 鏈並存檔輸出。
channels login 掃碼：在 Gateway 宿主或安全可達 Control UI 下執行 openclaw channels login --channel openclaw-weixin，用副號完成授權。
restart 與 probe：openclaw gateway restart 後跑 channels probe 與 doctor；若有 Windows Node，確認 remote 指向 Master 而非本機重複 Gateway。
單聊冒煙：副號向 Bot 發文字與入站檔案（驗證僅接收）；確認 Agent 回覆不含外發檔案；休眠筆電一次，驗證頻道仍僅依賴雲端 Mac 在線。
六步完成後，把「單聊-only」「檔案不可 outbound」「24h 靜默丟主動訊息」三條產品邊界寫進值班手冊，避免一線把群聊無回應或外發檔案失敗誤判為 Gateway 當機。若需對接其他 IM，Telegram、Discord 等仍走 OpenClaw 原生頻道，與微信 ClawBot 並行時務必分離 token 與 config 段，防止 config merge 時鍵名衝突。
三條值班硬閾值與六區雲端 Mac Gateway 選型
版本對齊紅線：OpenClaw 跨 2026.3.22 升級後 24 小時內，openclaw-weixin 仍停留在 1.0.x 且出現 probe 間歇失敗，應視為 ABI 不匹配，先升級外掛到 2.0.x 並 restart，再談模型路由變更。
用戶端灰度下限：iOS 低於 8.0.70 或 Android 未命中 8.0.69+ 灰度時，禁止將副號接入生產；工單需附用戶端「關於微信」截圖與掃碼時間戳。
Gateway 分裂驗收：Master 恢復後 10 分鐘內至少 3 次 channels probe；宿主機重啟一次後微信單聊仍可在 60 秒內收到 Agent 回覆，且不依賴開發筆電在線。
注意：閾值為值班溝通口徑，不構成騰訊或 OpenClaw 廠商 SLA。敏感詞攔截與 24 小時會話策略以微信平台當期規則為準。
把微信 ClawBot Gateway 綁在個人 Mac 或 Windows 筆電上，會重新引入睡眠、系統更新重啟與網路漫遊導致的 webhook 中斷；純 Linux VPS 雖可跑 OpenClaw，卻在 macOS 工具鏈與部分頻道外掛鄰近性上不如裸金屬雲端 Mac。以雲端 Mac 為 Master 承載 openclaw-weixin 與 7×24 守護，本機僅掃碼與 Control UI，能在合規單聊、loopback 紀律與可預測換租視窗之間取得平衡。對要穩定微信 Agent、又不願賭消費級硬體在線率的團隊，MESHLAUNCH 的 Mac Mini 雲端租用通常是更優解：建議目標城區日租先完整跑通六步與一次宿主機重啟，再鎖月租。容量與下單見 租用價格 與 雲端說明中心。
OpenClaw >=2026.3.0 且 <2026.3.22 用 1.0.x；>=2026.3.22 用 2.0.x。升級後執行 gateway restart 與 channels probe。雲端 Mac 首裝見 Lobster 安裝指南；下單見 價格頁。
不建議。生產 webhook 應落在雲端 Mac Master，Windows 僅 Node 或控制台。分裂拓撲與 WSL2 排錯見 Windows/WSL2 分工 Runbook。
目前僅單聊；檔案僅入站；資料經境內伺服器並過濾敏感詞。請用副號，勿傳輸金鑰。租雲端 Mac 跑 7×24 Gateway 見 租用價格。