在中文 AI Agent 落地場景中，「微信接入 openclaw」是最高頻的搜索需求之一。OpenClaw 官方渠道體系原生支持微信生態的三條主要路徑：個人號（Personal WeChat，透過 Web / 協議層）、微信公眾號（Official Account）與企業微信（WeCom）。本章節整合官方文件與社群實踐，提供一份可直接落地的接入 SOP。
一、三種渠道對比與選型
| 渠道 | 適用場景 | 認證門檻 | 穩定性 |
|---|---|---|---|
| 個人微信 (Personal) | 個人助手、家庭群、極客實驗 | 無需申請，掃碼登入 | 低 · 有封號風險 |
| 微信公眾號 (Official Account) | 對外品牌、B2C 客服、內容分發 | 需認證主體（企業/個體戶） | 高 · 官方 API |
| 企業微信 (WeCom) | 內部團隊助手、B2B 客服、SCRM | 需註冊企業微信 + 應用 | 最高 · 官方原生支持自動化 |
二、企業微信 (WeCom) 接入 SOP
Step 1 · 準備企業微信自建應用
- ▸登入 work.weixin.qq.com 管理後台 → 應用管理 → 建立自建應用
- ▸記下 CorpID、AgentID、Secret 三個關鍵值
- ▸在「接收訊息」設定回調 URL、Token 與 EncodingAESKey
- ▸將 OpenClaw 部署伺服器的公網 IP 加入企業微信「可信 IP」白名單
Step 2 · 在 OpenClaw 啟用 WeCom Adapter
# openclaw/config/channels.yaml
channels:
wecom:
enabled: true
corp_id: "${WECOM_CORP_ID}"
agent_id: "${WECOM_AGENT_ID}"
secret: "${WECOM_SECRET}"
token: "${WECOM_TOKEN}"
encoding_aes_key: "${WECOM_AES_KEY}"
callback_path: "/webhook/wecom"
# 是否要求 @ 機器人才響應（群聊建議 true）
require_mention_in_groups: true
# 訊息簽名校驗（強烈建議開啟）
verify_signature: trueStep 3 · 反向代理與 HTTPS
企業微信要求回調地址必須是 HTTPS。使用 Nginx / Caddy 將 https://your-domain.com/webhook/wecom 反向代理到 OpenClaw 的 :8080。Caddy 範例：
your-domain.com {
reverse_proxy /webhook/wecom localhost:8080
reverse_proxy /* localhost:8080
}Step 4 · 回到管理後台完成驗證
- ▸點擊「接收訊息」設定頁的「保存」，企業微信會向回調 URL 發起 GET echostr 驗證
- ▸OpenClaw WeCom Adapter 內建校驗與解密，正常會直接回顯 echostr
- ▸驗證通過後，在應用內給機器人發訊息即可看到 OpenClaw 響應
三、微信公眾號接入
公眾號適合對外品牌與客服。訂閱號功能受限（每日 1 條群發，無客服 API），生產環境優先選「認證服務號」。核心參數與 WeCom 類似：AppID、AppSecret、Token、EncodingAESKey。
channels:
wechat_mp:
enabled: true
app_id: "${WECHAT_APP_ID}"
app_secret: "${WECHAT_APP_SECRET}"
token: "${WECHAT_TOKEN}"
encoding_aes_key: "${WECHAT_AES_KEY}"
callback_path: "/webhook/wechat"
# 客服訊息需服務號 + 認證
enable_customer_service: true四、個人微信接入（進階）
個人號沒有官方 API，社群方案通常基於 Web 協議或 iPad 協議實作。OpenClaw 透過可插拔的 wechat_personal Adapter 對接主流協議層（如 wechatpadpro、Gewechat 等）。建議使用專門的「小號」，並嚴格控制發訊息頻率。
- ▸首次啟動掃碼登入，登入態緩存於 workspace 的 .wechat_session
- ▸群聊預設 requireMention（需 @），私聊預設全量響應
- ▸建議每分鐘發訊息 ≤ 20 條、每小時新增好友 ≤ 5 個，避開風控
五、訊息路由與多渠道統一
同一個 OpenClaw 實例可以同時掛載 WeCom、公眾號與個人號。透過 Session 隔離，來自不同渠道的同一使用者（例如企業微信外部聯繫人 + 公眾號粉絲）可繫結到同一個記憶檔案，達成跨渠道連續對話。
六、常見問題 (FAQ)
Q1 · 回調驗證一直失敗？
檢查三件事：(1) 伺服器公網可達且 HTTPS 憑證有效；(2) Token / EncodingAESKey 與後台完全一致，無多餘空白；(3) 伺服器公網 IP 已加入企業微信可信 IP。
Q2 · 個人號掃碼掉線？
多半是被微信風控。降低發訊息頻率、避免異地登入、使用固定出口 IP，並優先讓機器人在「被動響應」模式運行。
Q3 · 公眾號回覆延遲？
5 秒內若無法返回結果，讓 Adapter 先回一句「正在處理…」，再透過客服訊息異步發送最終答案。OpenClaw 的 wechat_mp Adapter 內建此策略，可在 config 內開啟 async_reply。