🎉 企业微信 MCP

应用消息 + 群机器人 + 社群运营自动化 v1.1

✅ 已完成

核心功能

基础功能

💬
应用消息
发送文本消息给企业微信用户
🤖
群机器人
通过 Webhook 发送群聊消息
👥
成员管理
获取部门成员和部门列表
🔑
Token 管理
自动获取和刷新访问令牌

社群运营功能 新增

👤
客户管理
获取外部联系人列表和详情
🏷️
客户标签
精细化标签管理
💬
客户群运营
群管理、群发消息
📢
群发助手
批量发送消息给客户/群
🎉
欢迎语
入群自动欢迎语
📱
渠道活码
联系我二维码 + 渠道统计

📊 运行状态

🟢
MCP Server
🟢
MCP Hub
Skill 包
8767
服务端口
19
API 接口
v1.1
版本号

🚀 快速开始

# 1. 安装 Skill
plasmid skill install wecom-skill
# 2. 发送应用消息
plasmid skill run wecom-skill send-app-message --userid "zhangsan" --text "您好,这是测试消息"
# 3. 获取客户列表
plasmid skill run wecom-skill list-external-contacts --userid "zhangsan"
# 4. 客户群发消息
plasmid skill run wecom-skill add-group-msg-task \ --sender '["zhangsan"]' \ --external_userid '["woXXX1","woXXX2"]' \ --text "活动通知:本周末 AI 技术分享会,欢迎参加!"
# 5. 创建渠道活码
plasmid skill run wecom-skill add-contact-way \ --type 1 \ --scene 1 \ --user '["zhangsan"]' \ --remark "公众号引流"

📡 API 接口列表

基础 API 4 个

发送应用消息 POST /sendAppMessage

向企业微信用户发送应用消息

发送群机器人消息 POST /sendWebhook

通过 Webhook 发送群聊消息

获取成员列表 POST /getUserList

查询部门成员详细信息

获取部门列表 POST /getDepartmentList

查询企业部门结构

社群运营 API 15 个

获取客户列表 POST /getExternalContactList

获取配置的外部联系人列表

获取客户详情 POST /getExternalContactInfo

获取客户详细信息和跟进状态

获取客户标签 POST /getExternalContactTags

获取企业配置的客户标签列表

编辑客户标签 POST /editExternalContactTags

为客户添加或移除标签

获取客户群列表 POST /getGroupChatList

获取企业创建的客户群列表

获取客户群详情 POST /getGroupChatInfo

获取客户群详细信息和成员列表

发送客户群消息 POST /sendGroupChatMessage

向指定客户群发送消息

创建客户群发任务 POST /addGroupMsgTask

创建向客户批量发送消息的任务

创建客户群群发任务 POST /addGroupChatMsgTask

创建向客户群批量发送消息的任务

获取欢迎语素材 POST /getWelcomeCode

获取入群欢迎语素材列表

添加欢迎语素材 POST /addWelcomeCode

创建新的入群欢迎语

创建联系我二维码 POST /addContactWay

创建渠道活码,支持多人接待

获取联系我配置 POST /getContactWay

获取渠道活码配置信息

更新联系我配置 POST /updateContactWay

更新渠道活码配置

删除联系我配置 POST /deleteContactWay

删除渠道活码配置

📁 项目结构

~/.openclaw/development/ ├── mcp/ │ └── wecom-mcp/ # 企业微信 MCP Server (v1.1) │ ├── src/ │ │ ├── index.ts # 主入口 + 19 个 API 接口 │ │ ├── wecom-service.ts # 企业微信 API 封装(19 个方法) │ │ └── logger.ts │ ├── README.md │ └── 社群运营使用示例.md # 详细使用文档 └── skills/ └── wecom-skill/ # 配套 Skill (v1.1) ├── skill.json # 19 个命令定义 ├── index.ts # 19 个方法实现 └── README.md

⚙️ 配置说明

⚠️ 需要配置企业微信参数

编辑配置文件:~/.openclaw/development/mcp/wecom-mcp/.env

需要填写:WECOM_CORP_IDWECOM_AGENT_IDWECOM_SECRET

获取配置步骤:

  1. 登录 企业微信管理后台
  2. 「我的企业」→「企业信息」→ 获取 CorpID
  3. 「应用管理」→ 创建应用 → 获取 AgentID 和 Secret
  4. 编辑 .env 文件,填入配置
  5. 重启服务:cd wecom-mcp && npm restart

🎯 社群运营功能配置

需要企业微信管理员在后台开通「客户联系」功能:

  1. 管理后台 → 客户联系 → 配置使用范围
  2. 配置可调用 API 的成员
  3. 配置客户标签、欢迎语等素材

📖 文档链接