01. 三類痛點：把 ClawBot 當「又一個 Telegram」、主號綁定、Gateway 間歇離線

1）心智模型錯位：ClawBot 不是您在 openclaw.json 裡填一個 Bot Token 就結束的頻道。它依賴微信用戶端官方外掛，以及終端機內騰訊發佈的 @tencent-weixin/openclaw-weixin-cli 產生一次性 QR Code完成帳號級綁定。若仍按 Telegram/Discord 的 Allowlist 與 pairing 去改微信側設定，會浪費整晚排查「模型路由」——微信通道的合格訊號是掃碼成功 + Gateway 程序持續可達 + 微信聯絡人出現助手對話。

2）主號與合規風險：官方說明與社群實務都強調：訊息經騰訊基礎設施傳輸並可能觸發內容安全策略；敏感領域（金融、加密貨幣話術等）較易被過濾。用日常主微信号綁定 ClawBot，一旦策略調整或灰度結束，影響的是您的真實社交圖譜。Runbook 應預設專用小號，並把 OpenClaw 工作目錄、Skills 與檔案工具限制在最小權限沙箱，與多平台安裝指南中的隔離原則一致。

3）Gateway「看似在線、微信側無回」：ClawBot 要求執行 OpenClaw 的機器（或反向隧道後的等效入口）長期可達。筆電合蓋休眠、家用寬頻 NAT 漂移，或 Docker 容器未設 restart 策略，都會表現為「偶爾能回、過夜必斷」。這與 Teams 的 Dev Tunnel + webhook 3978 不同：微信側沒有「再配一條公網 URL」的第二次機會，核心是綁定工作階段與 Gateway 心跳同壽。

02. ClawBot vs Telegram/Discord：官方通道決策矩陣

下表協助您在 30 秒內判斷：該走 ClawBot，還是繼續用已成熟的 IM 頻道外掛。

維度	微信 ClawBot（官方）	Telegram / Discord（OpenClaw 頻道）	短租 macOS 證據建議
接入方式	微信「設定→功能→外掛」+ CLI QR Code 掃碼	Bot Token / OAuth + `channels.*` 設定	保存掃碼前後終端機 stdout（脫敏）
對話型態	僅單聊；不支援群聊（截至 2026 公開說明）	支援群組、Topic、Allowlist	以測試小號傳 3 則探測訊息並截圖時間戳
檔案能力	常見描述為可收不可發（檔案只進不出）	依頻道外掛與權限而定	驗收期勿依賴「微信回傳 PDF」
封號/合規	官方通道；內容審查；灰度政策可能變更	平台 ToS + 自建 Allowlist	Runbook 註明「非主號」與資料留存策略
用戶端版本	iOS 微信 ≥ 8.0.70；Android ≥ 8.0.69（灰度以騰訊為準）	與微信無關	綁定前截圖「關於微信」版本頁

若自動化場景強依賴群聊 @ 機器人、出站檔案，或跨租戶企業 IM，應優先 Teams 或 Telegram/Discord，而不是把 ClawBot 當萬用頻道。

03. 七步落地：Gateway 就緒 → 微信外掛 → CLI 掃碼 → 首則訊息 → doctor → 權限收口 → 證據歸檔

確認 OpenClaw 基線：依安裝指南跑通 Gateway；記錄 openclaw --version、實際載入的 openclaw.json 路徑、openclaw gateway status 與 openclaw doctor 輸出。Node 建議 22.19+ 或文件推薦的 24.x。
微信端開啟 ClawBot：更新微信至滿足版本門檻 →「我」→「設定」→「功能」→「外掛」→ 開啟 ClawBot。若列表不可見，先升級用戶端並重新啟動，勿在未核實版本前反覆掃碼。
在 Gateway 主機執行官方 CLI：於執行 OpenClaw 的同一台機器（或 SSH 工作階段）執行安裝綁定指令；終端機會出現 QR Code，須在數分鐘內以微信「掃一掃」完成確認。
掃碼綁定與首則驗收：綁定成功後，微信聯絡人應出現助手對話。傳送一則短指令（如詢問版本或 /model 類命令，以您設定的模型為準），對照 Gateway 日誌是否出現 inbound/outbound 事件。
doctor 與模型鑑權：若微信無回覆，先查 Gateway 是否存活、模型 API Key 是否有效，再查微信側是否被內容策略攔截；避免一上來就改頻道路由。
權限與目錄收口：將 Agent 工作區限制在專用目錄；停用不必要的 file_write 或高風險 Skills；ClawHub 第三方技能先在隔離環境試跑。
證據鏈與擦除：脫敏保存 CLI 輸出、Gateway 日誌片段、微信版本截圖；在按天租用機完成驗收後，解除綁定或銷毀執行個體，刪除示範 API Key。

# 在 Gateway 主機執行（騰訊官方 npm 作用域）
npx -y @tencent-weixin/openclaw-weixin-cli@latest install

# 綁定後驗收（範例）
openclaw gateway status
openclaw doctor 2>&1 | tee /tmp/clawbot-doctor.txt
# 微信端：向助手傳送探測訊息，並對照 Gateway 日誌時間戳

QR Code 過期：重新執行 npx 指令產生新碼，勿複用截圖。掃碼後仍無聯絡人：確認 CLI 與 Gateway 是否同一台可達主機，以及防火牆是否阻斷 Gateway 出站。磁碟剩餘低於 15 GB 時，並行安裝與重啟易失敗；頻寬預期見 SSH/VNC 與成本 FAQ。

04. 分診表：症狀 → 優先動作 → 常見誤操作

症狀	優先動作	常見誤操作
外掛列表沒有 ClawBot	升級微信；查灰度與地域說明；重新啟動用戶端	在舊版微信上反覆安裝第三方 OpenClaw 橋
掃碼失敗或過期	重新 `npx … install`；確認手機與主機時鐘同步	用相簿舊 QR Code 多次嘗試
能收訊息、回覆空白或極短	查內容審查與敏感詞；換模型供應商；看 Gateway OOM	立刻重裝微信主號
夜間必定斷線	查主機休眠、systemd/launchd 守護、公網可達性	只重啟微信不清 Gateway
想在群組 @ 助手	改用 Telegram/Discord/Teams；ClawBot 目前不支援群聊	尋找非官方群機器人橋（封號風險）

05. 三條可引用數據、誤區與 1～3 日按天租用 macOS 日程

數據 1：騰訊微信團隊透過 npm 作用域 @tencent-weixin 發佈 openclaw-weixin-cli，社群文件將 ClawBot 外掛公開時間錨定在 2026 年 3 月 量級，可作「官方通道」稽核依據（非第三方逆向）。
數據 2：公開安裝說明列出的用戶端門檻為 iOS 微信 ≥ 8.0.70、Android ≥ 8.0.69（灰度節奏以騰訊為準）；未滿足版本時，外掛入口可能完全不可見。
數據 3：在 M4 按天租用節點上，若已具備 OpenClaw 基線，「CLI 掃碼 + 首則雙向訊息 + doctor 歸檔」 常可壓縮到 2～4 小時 單一工作階段（團隊樣本）；比在主力筆電合蓋休眠後反覆重綁更省一整晚值班。

誤區 A：認為 ClawBot 支援企業微信群機器人。誤區 B：用主號綁定並授予 Agent 全碟檔案權限。誤區 C：未設 Gateway 守護程序就宣稱「已上正式環境」。

第 1 日：在租機或隔離機完成 OpenClaw 安裝與 doctor；傍晚開啟微信外掛並掃碼，保存日誌。第 2 日：壓測 20 輪對話、測試檔案只進不出邊界、記錄審查觸發樣本（勿用真實客戶資料）。第 3 日：撰寫正式切換 Runbook、解除綁定、擦除金鑰，決定是否保留 Telegram/Teams 作為群聊補充通道。

06. 家用 PC / 雲端主機 vs 按天租 Mac：掃碼綁定與 Control UI 證據鏈

把 Gateway 放在合蓋即睡的家用 Mac或無圖形介面的廉價 VPS上，ClawBot 驗收的隱性成本往往高於租機：您要在手機上掃碼，卻在另一台機器上看日誌，還要擔心休眠斷鏈。短租原生 macOS 可把 npx @tencent-weixin/...、openclaw gateway status、Control UI 與鑰匙圈中的唯讀金鑰放在同一證據鏈，再決定是否遷回主力機或雲端伺服器正式環境。

雖可用長期雲端主機 + systemd 跑通大部分步驟，那更適合已確定要 7×24 在線的階段；若仍在 1～3 日內驗證「微信是否值得作為個人助手入口」，按天租用 Mac 通常更划算：避免污染主力微信号與主力開發目錄。方案見 Mac mini M4 方案價格頁；連線與頻寬、記憶體門檻見 SSH/VNC FAQ。