💡 快速上手指引 & 交流群

📖 点击查看完整接入指引文档 — 包含配置步骤、产品介绍、常见问题解答等。

💬 扫码加入企业微信交流群：

2026.3.22 版本 OpenClaw 兼容说明

如果你的 OpenClaw 是 2026.3.22 及以上的版本，请升级插件到 2026.3.24 及以上版本。

如果你的 OpenClaw 是 2026.3.22 以下的版本，请保持插件版本在 2026.3.20 版本。

你可以使用以下命令快速安装： npx -y @wecom/wecom-openclaw-cli install --force

WeCom channel plugin for OpenClaw — by the Tencent WeCom team.

A bot plugin powered by WeCom AI Bot WebSocket persistent connections. Supports direct messages & group chats, streaming replies, and proactive messaging.

---

📖 WeCom AI Bot Official Documentation

• 🔗 WebSocket persistent connection for stable communication
• 💬 Supports both direct messages (DM) and group chat
• 📤 Proactive messaging to specific users or groups
• 🖼️ Receives and processes image and file messages with automatic downloading
• ⏳ Streaming replies with "thinking" placeholder messages
• 📝 Markdown formatting support for replies
• 🔒 Built-in access control: DM Policy (pairing / open / allowlist / disabled) and Group Policy (open / allowlist / disabled)
• ⚡ Auto heartbeat keep-alive and reconnection (up to 100 reconnect attempts)
• 🧙 Interactive CLI setup wizard

---

• OpenClaw >= 2026.2.13

Use the CLI tool to automatically install the plugin and complete bot configuration in one step:

# Automatically install the channel plugin and quickly complete configuration; also works for updates
npx -y @wecom/wecom-openclaw-cli install

More Options

# If installation fails, try force install
npx -y @wecom/wecom-openclaw-cli install --force

# Use --help to learn more about the tool
npx -y @wecom/wecom-openclaw-cli --help

openclaw plugins install @wecom/wecom-openclaw-plugin

openclaw channels add

Follow the prompts to enter your WeCom bot's Bot ID and Secret.

openclaw config set channels.wecom.botId <YOUR_BOT_ID>
openclaw config set channels.wecom.secret <YOUR_BOT_SECRET>
openclaw config set channels.wecom.enabled true
openclaw gateway restart

Config Path	Description	Options	Default
channels.wecom.botId	WeCom bot ID	—	—
channels.wecom.secret	WeCom bot secret	—	—
channels.wecom.enabled	Enable the channel	true / false	false
channels.wecom.websocketUrl	WebSocket endpoint	—	wss://openws.work.weixin.qq.com
channels.wecom.dmPolicy	DM access policy	pairing / open / allowlist / disabled	open
channels.wecom.allowFrom	DM allowlist (user IDs)	—	[]
channels.wecom.groupPolicy	Group chat access policy	open / allowlist / disabled	open
channels.wecom.groupAllowFrom	Group allowlist (group IDs)	—	[]
channels.wecom.sendThinkingMessage	Send "thinking" placeholder	true / false	true

---

Default: dmPolicy: "open" — all users can send direct messages without approval.

openclaw pairing list wecom            # View pending pairing requests
openclaw pairing approve wecom <CODE>  # Approve a pairing request

Configure allowed user IDs via channels.wecom.allowFrom:

{
  "channels": {
    "wecom": {
      "dmPolicy": "allowlist",
      "allowFrom": ["user_id_1", "user_id_2"]
    }
  }
}

Set dmPolicy: "open" to allow all users to send direct messages without approval.

Set dmPolicy: "disabled" to completely block all direct messages.

• "open" — Allow messages from all groups (default)
• "allowlist" — Only allow groups listed in groupAllowFrom
• "disabled" — Disable all group messages

{
  "channels": {
    "wecom": {
      "groupPolicy": "open"
    }
  }
}

{
  "channels": {
    "wecom": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["group_id_1", "group_id_2"]
    }
  }
}

In addition to the group allowlist, you can restrict which members within a group are allowed to interact with the bot. Only messages from users listed in groups.<chatId>.allowFrom will be processed; messages from other members will be silently ignored. This is a sender-level allowlist that applies to all messages.

{
  "channels": {
    "wecom": {
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["group_id_1"],
      "groups": {
        "group_id_1": {
          "allowFrom": ["user_id_1", "user_id_2"]
        }
      }
    }
  }
}

---

openclaw plugins update wecom-openclaw-plugin

---

MIT