企业微信接入 AI 智能体：OpenClaw WeCom 插件使用教程

本文介绍如何通过 OpenClaw 的企业微信插件，快速将 AI 智能体接入企业微信，实现单聊、群聊、流式回复等功能。

前言

企业微信作为企业内部沟通的主流工具，如何让 AI 智能体接入企业微信，为员工提供智能问答、文档处理等服务？OpenClaw 提供了一套开箱即用的解决方案——WeCom OpenClaw Plugin。

什么是 OpenClaw？

OpenClaw 是一个多渠道 AI 智能体网关，支持 WhatsApp、Telegram、Discord、iMessage 等多种聊天渠道。通过插件机制，可以轻松扩展更多渠道，企业微信插件就是其中之一。

插件核心功能

• 🔗WebSocket 长连接：稳定的企业微信通信
• 💬单聊 + 群聊：同时支持私聊和群聊场景
• 📤主动消息：可主动向用户或群组发送消息
• 🖼️多媒体支持：接收并处理图片、文件消息
• ⏳流式回复：支持“思考中”占位消息
• 📝Markdown 支持：回复支持 Markdown 格式化
• 🔒访问控制：支持配对审批、白名单等多种安全策略

一、环境准备

1.1 安装要求

• OpenClaw >= 2026.2.13
• Node.js 环境

1.2 安装 OpenClaw

npm install -g openclaw@latest

1.3 初始化配置

openclaw onboard --install-daemon

二、创建企业微信智能机器人

2.1 进入机器人管理

打开企业微信 → 工作台 → 智能机器人应用

2.2 创建机器人

选择「API 模式」创建机器人，记录下以下信息：

• Bot ID：机器人唯一标识
• Secret：机器人密钥

📖 企业微信智能机器人官方文档

三、安装企业微信插件

3.1 安装插件

openclaw plugins install @wecom/wecom-openclaw-plugin

3.2 配置方式一：交互式向导

openclaw channels add

按照提示输入 Bot ID 和 Secret。

3.3 配置方式二：命令行快速配置

# 设置机器人 ID 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

四、配置参数详解

五、访问控制配置

5.1 单聊访问控制

方式一：配对审批模式

用户首次发消息时需要审批：

# 查看待审批请求 openclaw pairing list wecom # 批准请求 openclaw pairing approve wecom <CODE>

方式二：白名单模式

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

方式三：完全开放

{ "channels": { "wecom": { "dmPolicy": "open" } } }

5.2 群聊访问控制

开放所有群聊

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

仅允许特定群聊

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

群内特定成员白名单

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

六、启动网关

openclaw gateway --port 18789

启动后，打开浏览器访问 http://127.0.0.1:18789/ 即可进入控制面板。

七、使用效果

配置完成后，在企业微信中：

1. 单聊：直接给机器人发消息，AI 会流式回复
2. 群聊：在群里 @机器人，AI 会响应

支持的功能：

• ✅ 文本消息收发
• ✅ 图片消息接收
• ✅ 文件消息接收
• ✅ Markdown 格式回复
• ✅ 流式“思考中”提示

八、进阶：文档与智能表格能力

企业微信插件还支持文档操作能力，可以让 AI 帮你：

• 📄 创建和编辑企业微信文档
• 📊 操作智能表格（添加字段、记录等）
• 🔗 通过 MCP 协议无缝集成

详细文档操作教程请参考插件 README。

九、更新插件

openclaw plugins update wecom-openclaw-plugin

十、常见问题

Q1: 提示 "daemon not running"

启动守护进程：

openclaw gateway start

Q2: 收不到消息

检查配置是否正确：

openclaw config get channels.wecom.botId openclaw config get channels.wecom.secret openclaw config get channels.wecom.enabled

Q3: 如何获取用户 ID 或群 ID？

可以通过 Gateway 日志查看，或使用 openclaw pairing list wecom 命令。

总结

OpenClaw 企业微信插件提供了简单易用的方式，将 AI 智能体接入企业微信。通过简单的配置，即可实现单聊、群聊、访问控制等功能，适合企业内部智能化场景。

参考链接

• OpenClaw 官方文档
• OpenClaw GitHub
• 企业微信智能机器人文档