2026 WECHAT
CLAWBOT_
OFFICIAL_
BIND_RUNBOOK.
想在個人微信裡直接對話 OpenClaw，卻分不清「官方 ClawBot 外掛」和第三方橋接？2026 年 3 月起，騰訊在 npm 發布 @tencent-weixin/openclaw-weixin-cli，配合微信「設定 → 外掛」裡的 ClawBot，可用掃碼把 Gateway 綁到微信。本文給出前置驗收—一鍵／手動雙路徑—六步 Runbook—注意事項矩陣—深度案例—可引用數字，並與站內《多平台 Channel 接入》《企業微信自動化》《Gateway 未就緒排錯》區分場景；結論指向：微信側要手機在線 + 外掛灰度，伺服器端要Gateway 7×24——筆電休眠就斷鏈，遠端 Mac 對照節點更適合生產綁定。
1. ClawBot 是什麼：官方外掛 vs 第三方橋
ClawBot 是微信團隊為 OpenClaw 提供的官方外掛能力（2026 年 3 月 22 日前後灰度），透過騰訊維護的 npm 套件 @tencent-weixin/openclaw-weixin 與 CLI openclaw-weixin-cli 完成鑑權，而不是逆向 Web 協定。與既有「企業微信／釘釘／Telegram」Channel 不同：個人微信走 openclaw-weixin 通道，搜尋意圖是「掃碼綁定 + 單聊對話」，不是企微 CorpID。第三方橋接雖可能短期可用，但存在封號與協定變更風險；生產環境應優先官方路徑，並把 OpenClaw 跑在可持續在線的機器上（本機常開或遠端 Mac launchd）。
從架構上看，微信訊息會經騰訊伺服器中轉，你的 Gateway 則負責把對話轉給 Agent 與模型；兩端任一離線，使用者只會看到「已讀不回」。因此綁定 ClawBot 之前，應先確認 OpenClaw 版本、Node 執行環境與本機或遠端 Mac 的網路出口穩定——尤其在公司防火牆、家用頻寬波動或 VPN 切換時，長連線比單次 HTTP 更敏感。
2. 前置驗收清單（四道門檻）
① OpenClaw：建議 ≥ 2026.3.22（外掛體系與安全稽核與 ClawBot 同期演進），執行 openclaw --version 與 openclaw doctor。② Node.js：官方棧要求 Node 22+；npm 全域安裝時注意 PATH（見 Gateway 專稿）。③ 微信客戶端：iOS／Android ≥ 8.0.70，帳號建議實名且註冊時長 >3 個月以降低風控。④ 外掛灰度：微信「我 → 設定 → 外掛」中能看到 ClawBot 並開啟；若列表沒有，屬於區域／帳號灰度未覆蓋，勿強行用舊橋接冒充官方。⑤ Gateway：綁定前 openclaw gateway status 須為 healthy；否則先完成《安裝後 Gateway 未就緒》Runbook。
建議把上述五項寫進變更單的「綁定前檢查表」，並在遠端 Mac 對照節點與本機各跑一輪——避免「在家掃碼、在公司網路」造成端點漂移卻無法重現。
3. 決策矩陣：一鍵 CLI 還是手動外掛？
| 場景 | 推薦路徑 | 說明 |
|---|---|---|
| 首次綁定、本機可跑 npx | 騰訊一鍵 CLI | 自動裝外掛 + 出 QR Code，適合驗證 |
| 已有 Docker／遠端 Mac、需稽核每步 | 手動 plugins install | 便於寫入變更單與回滾 |
| npm 拉取逾時 | 切換 npmmirror + 重試 | 勿在未裝全外掛時反覆掃碼 |
| 升級 OpenClaw 後微信無回覆 | 查 plugins.entries 啟用 + gateway restart | 2026.3.22+ 外掛名與設定鍵變更 |
| 筆電合蓋就斷 | 遠端 Mac launchd 常駐後再掃碼 | 綁定的是「當時在線的 Gateway」 |
4. 六步落地 Runbook
Step 1 微信端開啟 ClawBot
更新微信至最新版 → 設定 → 外掛 → 開啟 ClawBot。若無入口，記錄微信版本與帳號地區，等待灰度；勿在同一帳號反覆嘗試非官方工具。
Step 2 確認 OpenClaw Gateway 在線
在將執行綁定的機器上：openclaw gateway status、curl -m 3 http://127.0.0.1:18789/health。遠端 Mac 用 SSH 登入後同樣檢查；生產建議 launchd 託管。
Step 3 安裝騰訊微信通道（二選一）
路徑 A（推薦驗證）：
路徑 B（手動）：
Step 4 掃碼綁定
終端機出現 QR Code 後，微信「掃一掃」確認。QR Code有效期短，過期需重新執行 Step 3 指令；避免截圖後隔數小時再掃。
Step 5 分層驗收「能收能發」
向 ClawBot 聯絡人發測試訊息；同時 openclaw channels status --probe 與 openclaw logs --follow 觀察 openclaw-weixin 通道。若只收不發，查 API Key、模型配額與 Gateway RPC 是否逾時（勿與微信層混修）。
Step 6 遠端 7×24 對照（可選但強烈建議）
在 MACGPU 或自建遠端 Mac 對照節點重複 Step 2–5，確認筆電休眠後微信仍可達。連續 30 分鐘 probe 全綠再切日常流量。
5. 注意事項矩陣（合規／帳號／功能）
| 類別 | 風險 | 建議 |
|---|---|---|
| 功能範圍 | 目前以單聊為主，群聊能力未全面開放 | 勿把客服群場景硬塞個人通道 |
| 帳號 | 主號綁定 Agent 具備檔案／命令能力 | 用小號綁定，限制 tools.exec 與工作目錄 |
| 內容合規 | 訊息經微信伺服器，敏感領域易觸發過濾 | 避免金融／crypto 等高風險自動回覆範本 |
| 升級 | OpenClaw 小版本可能改外掛載入順序 | 升級前後跑 doctor + channels probe |
| 在線性 | Gateway 離線則微信側「無回覆」 | 遠端 Mac + launchd，而非合蓋筆電 |
6. 常見問題分層排錯
| 現象 | 優先檢查層 | 典型修復 |
|---|---|---|
| 外掛列表沒有 ClawBot | 微信灰度／版本 | 升級客戶端、換已灰度帳號，勿用非官方橋 |
| 掃碼後無聯絡人 | Gateway／外掛狀態 | gateway restart --force --wait，確認 enabled |
| 收不到訊息 | 通道 + 本機防火牆 | plugins.entries、18789 埠、probe 全綠 |
| 只收不發 | 模型／API Key | 查配額與 RPC 逾時，勿先重裝微信外掛 |
| npx／npm 失敗 | 套件鏡像／Node | npmmirror、Node 22+、全域 PATH |
外掛列表沒有 ClawBot：灰度未覆蓋，只能等待或換已灰度帳號測試。掃碼後無聯絡人：Gateway 未重啟或外掛未 enabled。收不到訊息：openclaw config get plugins.entries.openclaw-weixin.enabled 應為 true；核對防火牆未攔 18789。npx 失敗：npm config set registry https://registry.npmmirror.com 後重試。升級後失效：先 openclaw doctor --fix 再 gateway restart --force --wait，勿在未備份時刪 ~/.openclaw。
若問題落在「模型有回覆但微信收不到」，應分開查：上游 LLM 日誌、Gateway RPC 延遲、openclaw-weixin 通道斷線——三者症狀相似，混修會浪費數小時。建議保留 openclaw logs --follow 與手機微信網路切換（Wi‑Fi／行動數據）的對照時間軸。跨地域遠端 Mac 節點還需確認出口頻寬與延遲是否導致長連線抖動，必要時在對照節點與本機各綁一次小號做 A／B 驗證。
7. 深度案例：「掃碼成功，下班路上微信全不回」
「開發者用 MacBook 在家掃碼綁定 ClawBot，白天在公司微信發訊息，Agent 整夜無回應；日誌顯示 Gateway 程序隨合蓋休眠，openclaw-weixin 長連線斷開。」
團隊誤判為「騰訊介面故障」，實際是本機 Gateway 無 7×24。遷移到遠端 Mac mini（launchd + openclaw gateway install --force）後重新掃碼，同一微信號恢復穩定；對照節點保留舊設定僅作 diff。教訓：ClawBot 綁定的是「那一時刻在線的 Gateway 端點」，換機／重裝需重新掃碼；生產應固定端點 IP／主機名並寫入維運手冊。
延伸做法：在遠端 Mac 上為 Gateway 設定健康檢查與告警（例如定時 curl /health、probe 失敗寫入工單），並限制 Agent 的 tools.exec 與工作目錄，避免小號被誤用為高權限維運入口。
8. 產業洞察：IM 官方通道與 Agent 常駐化
2026 年的趨勢是：大型 IM 廠商為開源 Agent 框架提供原生外掛 + 官方 CLI，降低封號不確定性，但把「在線性」壓力轉嫁給自建 Gateway。微信 13 億使用者的入口價值極高，卻要求伺服器端穩定常駐、可觀測、可回滾。Windows／Linux VPS 可跑 OpenClaw，但許多團隊的多模態 Skills、ClawHub 工具鏈與本機除錯仍依賴 macOS；Apple Silicon 遠端 Mac在 Metal、音視訊類 Skill 與 launchd 託管體驗上，常作為「微信 Channel 黃金對照環境」。若你希望先在對照節點完成掃碼、probe 與 30 分鐘穩定性驗證，再讓主號或業務號接入，可租用 MACGPU 遠端 Mac：與本機隔離、磁碟可快照、按工單回放日誌，避免「在家掃的碼、在公司用的網」端點漂移。
9. 可引用數字門檻
① 微信版本 < 8.0.70：先升級再談外掛。② OpenClaw < 2026.3.22：先升級並 doctor。③ 掃碼後 5 分鐘 內 probe 仍紅：禁止宣告上線。④ 單聊測試連續 3 輪 上下文不丟：才允許接 Skills 寫檔案。⑤ Gateway 變更後 30 分鐘 無斷連：遠端節點才可接生產微信號。
上述門檻可寫進上線檢查清單：維運在工單中貼上 openclaw --version、微信版本截圖、probe 結果與 30 分鐘穩定性摘要，方便事後稽核「當時綁定的是哪台 Gateway」。團隊若同時維護 Telegram／企微等多 Channel，應為微信 ClawBot 單獨保留一份 Runbook 附錄，避免共用「重啟 Gateway」步驟卻漏掉重新掃碼。
10. FAQ
問：ClawBot 和企業微信 OpenClaw 是一回事嗎？答：否，企微走企業應用與 CorpID；ClawBot 是個人微信官方外掛通道。問：必須用 Mac 嗎？答：OpenClaw 可跨平台；但遠端 Mac 常駐是 MACGPU 主推的驗收路徑。問：QR Code 過期怎麼辦？答：重新跑 npx install 或 channels login。問：能否群聊？答：以當前產品說明為準，預設按單聊規劃。問：MACGPU 做什麼？答：提供 7×24 對照節點，不替代你的微信帳號合規責任。