WecomTeam/wecom-openclaw-plugin

WeCom OpenClaw Plugin – Quick Overview

What it is – A first‑party channel plugin that lets the OpenClaw AI‑agent framework talk to WeCom (Tencent’s Enterprise WeChat). It adds two ways of communicating with WeCom users:

Mode	How it connects	Typical use
Bot	WebSocket long‑polling or HTTP webhook (JSON)	Fast, streaming replies, easy setup.
Agent	HTTP webhook callbacks (XML, AES‑256‑CBC encrypted)	Enterprise‑grade, API‑driven messaging.

The plugin also ships a wecom‑cli command‑line tool that exposes dozens of WeCom business APIs (messaging, email, docs, spreadsheets, calendars, meetings, file storage, contacts, etc.) as “skills” the AI can call.

---

Key Features (as described in the README)

• Dual‑mode operation – Bot and Agent can run side‑by‑side; the system prefers Bot for outbound messages and falls back to Agent if the WebSocket is down.
• Message types – Handles plain text, markdown, images, videos, voice, files, and mixed “图文混排” messages. Voice messages are auto‑transcribed.
• Proactive messaging – The bot can push messages to specific users, groups, departments or tags without waiting for a user prompt.
• Streaming replies – While the LLM is thinking, a placeholder “thinking” message can be sent (Bot mode only).
• Access control – Fine‑grained policies for direct messages (pairing, open, allow‑list, disabled) and group chats, plus per‑account command authorisation.
• Multi‑account support – Run several WeCom accounts in one OpenClaw gateway, each with its own bot/agent config.
• Dynamic agents – Optional per‑user or per‑group isolated agents for session isolation.
• Media handling – Automatic download of incoming media, size limits (10 MB for images/video, 2 MB for voice) with auto‑downgrade to file when limits are exceeded.
• Built‑in business skills – wecom‑cli provides commands for:
  • Messaging, email, document & spreadsheet CRUD
  • Smart sheets & smart documents management
  • Todo, calendar, meeting scheduling, minutes & transcripts
  • WeDrive file search/upload/download
  • Contact lookup
• CLI wizard – openclaw channels add or @wecom/wecom-openclaw-cli install walks you through bot ID/secret entry and configuration.
• Robust networking – Heartbeat, reconnection logic, anti‑kick protection, optional egress proxy.

---

Getting Started (from the README)

1. Prerequisite – OpenClaw ≥ 2026.3.28.
2. Install – One‑liner:

   npx -y @wecom/wecom-openclaw-cli install   # or add --force if needed
   

3. Configure – Either run openclaw channels add (interactive) or set the needed keys directly, e.g.:

   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
   

4. Enable business tools – Add the plugin ID to tools.alsoAllow and restart the gateway.
5. Choose a mode – Bot (default) via WebSocket, or Agent by configuring CorpID/Secret, AgentId, Token, and EncodingAESKey and registering the callback URL in the WeCom admin console.

---

Who Might Use This?

• Enterprises that already run OpenClaw‑based AI assistants and want them to appear inside WeCom chats.
• Developers building internal bots that need to send proactive notifications, handle rich media, or invoke WeCom’s document, calendar, and meeting APIs.
• Ops teams that want scheduled (cron) broadcasts to departments or tags via the Agent channel.

---

Limitations & Gotchas (as per the docs)

• Bot mode requires a Bot ID and Secret; Agent mode needs a full corporate app (CorpID/Secret) and XML‑encrypted callbacks.
• Media larger than the listed limits will be sent as a file or rejected.
• When using Agent‑only accounts, you must have the Agent configured before saving the callback URL in the WeCom console (WeCom validates the URL immediately).
• The plugin version must match the OpenClaw version (e.g., OpenClaw 2026.3.22 → plugin 2026.3.20; newer OpenClaw → plugin 2026.3.24+).

---

TL;DR

The WeCom OpenClaw Plugin is a production‑ready bridge that lets OpenClaw AI agents communicate with Tencent’s Enterprise WeChat, supporting rich media, proactive messages, and a full suite of WeCom business APIs via a convenient CLI. It can run in Bot (WebSocket) or Agent (encrypted XML webhook) mode, works with multiple accounts, and includes safety features like access policies and automatic fallback between modes.