WecomTeam/wecom-openclaw-plugin

OpenClaw 的官方企业微信插件，由企业微信团队开发和维护。它将你的 OpenClaw Agent 无缝对接到企业微信工作流，集成文档、智能表格、日历能力。

WeCom OpenClaw 插件 – 快速概覽

這是什麼 – 一個官方第一方頻道插件，讓 OpenClaw AI 代理框架能與 WeCom（騰訊企業微信）對接。此插件提供兩種與 WeCom 用戶通訊的方式：

模式	連接方式	常見用途
Bot	WebSocket 長輪詢或 HTTP webhook（JSON）	快速、串流回應，設定簡單。
Agent	HTTP webhook 回調（XML，AES-256-CBC 加密）	企業級，API 驅動的訊息傳遞。

此插件還附帶一個 wecom-cli 命令列工具，將數十種 WeCom 商務 API（訊息、電子郵件、文件、試算表、日曆、會議、檔案儲存、聯絡人等）轉換為 AI 可呼叫的「技能」。

主要功能（如 README 所述）

雙模式運作 – Bot 與 Agent 可並行運行；系統會優先使用 Bot 發送出站訊息，若 WebSocket 中斷則自動降級至 Agent。
訊息類型 – 支援純文字、Markdown、圖片、影片、語音、檔案，以及混合「图文混排」訊息。語音訊息會自動轉錄。
主動發送訊息 – Bot 可主動向特定使用者、群組、部門或標籤推送訊息，無需等待使用者提問。
串流回應 – 在 LLM 思考期間，可發送 placeholder「思考中」訊息（僅 Bot 模式支援）。
存取控制 – 支援細粒度的直接訊息政策（配對、開放、白名單、停用）與群組聊天控制，並支援每帳號指令授權。
多帳戶支援 – 可在一個 OpenClaw 網關中運行多個 WeCom 帳戶，每個帳戶可獨立設定 Bot/Agent 參數。
動態代理 – 可選每使用者或每群組的獨立代理，以確保會話隔離。
媒體處理 – 自動下載進來的媒體，設定大小限制（圖片/影片 10 MB，語音 2 MB），超過限制時自動降級為檔案傳送。
內建商務技能 – wecom-cli 提供下列指令：
- 訊息、電子郵件、文件與試算表的增刪改查（CRUD）
- 智能試算表與智能文件管理
- 待辦事項、日曆、會議排程、會議記錄與轉錄
- WeDrive 檔案搜尋/上傳/下載
- 連絡人查詢
CLI 向導 – openclaw channels add 或 @wecom/wecom-openclaw-cli install 會引導您輸入 Bot ID/Secret 及完成設定。
穩健的網路連線 – 心跳機制、自動重連邏輯、防踢保護，以及可選的出口代理。

快速上手（來自 README）

先決條件 – OpenClaw ≥ 2026.3.28。

安裝 – 一行指令：

npx -y @wecom/wecom-openclaw-cli install   # 如需強制安裝可加上 --force

設定 – 可執行 openclaw channels add（互動式）或直接設定必要參數，例如：

openclaw config set channels.wecom.botId <BOT_ID>
openclaw config set channels.wecom.secret <BOT_SECRET>
openclaw config set channels.wecom.enabled true
openclaw gateway restart

啟用商務工具 – 將插件 ID 加入 tools.alsoAllow，並重新啟動網關。
選擇模式 – 使用 Bot（預設，透過 WebSocket）或透過設定 CorpID/Secret、AgentId、Token 與 EncodingAESKey，並在 WeCom 管理後台註冊回調 URL 來啟用 Agent 模式。

哪些人可能會使用它？

企業：已運行基於 OpenClaw 的 AI 助手，希望它們能出現在 WeCom 聊天中。
開發者：開發內部機器人，需要主動發送通知、處理豐富媒體，或調用 WeCom 的文件、日曆與會議 API。
運維團隊：希望透過 Agent 通道以排程（cron）方式向部門或標籤廣播訊息。

局限與注意事項（依文件所述）

Bot 模式需要 Bot ID 與 Secret；Agent 模式則需完整的企業應用（CorpID/Secret）與 XML 加密回調。
超過限制的媒體將以檔案形式傳送或被拒絕。
使用僅 Agent 帳戶時，必須在 WeCom 控制台儲存回調 URL 前先完成 Agent 設定（WeCom 會立即驗證 URL）。
插件版本必須與 OpenClaw 版本匹配（例如 OpenClaw 2026.3.22 → 插件 2026.3.20；較新的 OpenClaw → 插件 2026.3.24+）。

簡要總結

WeCom OpenClaw 插件 是一個可投入生產環境的橋樑，讓 OpenClaw AI 代理能與騰訊企業微信通訊，支援豐富媒體、主動訊息與完整的 WeCom 商務 API 套件，並透過方便的 CLI 工具實現。它可運行於 Bot（WebSocket）或 Agent（加密 XML webhook）模式，支援多帳戶，並包含存取政策與模式間自動降級等安全機制。