导读:企业微信是国内企业最常用的沟通工具。通过OpenClaw接入企业微信,你可以打造一个24小时在线的AI助手——自动回复客户咨询、推送日报周报、处理审批流程。本教程从零开始,手把手教你实现。
🎯 能做什么?
- 💬 群聊AI助手 - 在群里@机器人即可获得AI回复
- 📨 私聊自动回复 - 1对1智能客服
- 📊 定时推送 - 每日/每周自动发送日报、周报
- 📋 审批通知 - 审批流自动提醒和汇总
- 🔔 告警通知 - 系统异常自动通知相关人
- 📝 会议纪要 - 自动生成会议摘要并分发
📋 前置准备
1 企业微信管理员账号(需要创建应用的权限)
2 已安装并运行OpenClaw
3 一个公网可访问的服务器(用于Webhook回调)
4 域名和SSL证书(推荐,企业微信要求HTTPS)
2 已安装并运行OpenClaw
3 一个公网可访问的服务器(用于Webhook回调)
4 域名和SSL证书(推荐,企业微信要求HTTPS)
🚀 第一步:创建企业微信应用
1.1 创建自建应用
- 登录 企业微信管理后台
- 进入 应用管理 → 自建 → 创建应用
- 填写应用名称(如"AI助手")、上传Logo、选择可见范围
- 创建完成后,记录 AgentId 和 Secret
1.2 获取关键凭证
# 你需要收集以下信息:
CorpID: ww1234567890abcdef # 企业ID(我的企业 → 企业信息)
AgentId: 1000002 # 应用ID(应用管理 → 应用详情)
Secret: aBcDeFgHiJkLmNoPqRsT # 应用Secret
Token: your_verify_token # 回调验证Token(接收消息 → API设置)
EncodingAESKey: xxxxxxxxxxxxxxxx # 回调加密密钥
1.3 配置消息回调
在应用的"接收消息"设置中,配置回调URL:
# 回调URL格式
https://your-domain.com/webhook/wecom
# 企业微信会发送一个验证请求,OpenClaw会自动处理
🔧 第二步:配置OpenClaw
2.1 安装企业微信插件
# OpenClaw内置了企业微信支持,无需额外安装
# 确认插件已加载
openclaw plugins list | grep wecom
2.2 编辑配置文件
# ~/.openclaw/config.yaml
channels:
wecom:
enabled: true
corpId: "ww1234567890abcdef"
agentId: "1000002"
secret: "aBcDeFgHiJkLmNoPqRsT"
token: "your_verify_token"
encodingAESKey: "xxxxxxxxxxxxxxxx"
# 可选:消息加密模式
encryptMode: "compatible" # compatible | secure
# 可选:自动回复设置
autoReply:
enabled: true
triggerMode: "mention" # mention=仅@时回复 | all=所有消息
welcomeMessage: "你好!我是AI助手,有什么可以帮你的?"
2.3 配置Agent
# ~/.openclaw/config.yaml
agents:
wecom-assistant:
model: "gpt-4o-mini" # 或你偏好的模型
systemPrompt: |
你是一个企业内部的AI助手。
角色:专业、高效、友好
能力:回答工作问题、整理信息、提供建议
规则:
- 回答简洁明了,适合企业场景
- 涉及敏感信息时提醒用户注意保密
- 不确定的问题坦诚说明
temperature: 0.7
maxTokens: 2048
💬 第三步:群聊机器人
3.1 群Webhook机器人
最简单的方式——在群设置中添加Webhook机器人:
# 群Webhook URL格式
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxxxxxxx
# 通过OpenClaw发送消息到群
# 使用wecom_mcp工具或直接curl
3.2 配置群聊自动回复
# 在config.yaml中添加群聊配置
channels:
wecom:
groupChat:
enabled: true
# 指定哪些群启用AI回复
allowedGroups:
- "oc_xxxxxxxxxxxxx" # 群ID
# 触发方式
triggerMode: "mention" # @机器人时回复
# 是否显示"正在输入"状态
showTyping: true
3.3 群消息处理流程
# OpenClaw处理群消息的流程:
1. 收到群消息 → 检查是否@机器人
2. 提取消息内容 → 去除@标记
3. 调用AI模型生成回复
4. 回复到群聊(引用原消息)
# 可以在SOUL.md中定义群聊行为
## 群聊规则
- 被@时才回复,不主动插嘴
- 回答简洁,控制在200字以内
- 涉及多人讨论时,只回应@自己的部分
📨 第四步:消息推送
4.1 主动推送消息
# 通过OpenClaw API发送消息
# 1. 发送文本消息
curl -X POST https://your-domain.com/api/wecom/send \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to": "@all",
"msgtype": "text",
"text": {"content": "今日AI日报已生成,请查收。"}
}'
# 2. 发送Markdown消息(更丰富的格式)
curl -X POST https://your-domain.com/api/wecom/send \
-d '{
"to": "@all",
"msgtype": "markdown",
"markdown": {
"content": "# 今日要点\n> 1. AI模型更新\n> 2. 产品发布"
}
}'
4.2 定时推送配置
# 使用OpenClaw Cron定时推送
# 添加每日早报任务
openclaw cron add \
--name "daily-wechat-report" \
--schedule "0 9 * * *" \
--task "生成今日AI行业早报,通过企业微信推送给团队" \
--channel wecom \
--target "@all"
📋 第五步:审批流集成
5.1 监听审批事件
# 配置审批事件回调
# 在企业微信后台 → 应用管理 → 审批 → 设置回调
# OpenClaw会自动处理以下事件:
# - 审批申请(open_approval)
# - 审批状态变更(approval_state_change)
# - 审批评论(approval_comment)
5.2 自动化审批处理
# 在Agent中配置审批处理逻辑
agents:
approval-bot:
systemPrompt: |
你是一个审批助手。当收到审批通知时:
1. 解析审批内容
2. 根据规则判断是否通过
3. 将结果推送给相关人
规则:
- 金额<1000元:自动通过
- 金额1000-10000元:推送给部门主管
- 金额>10000元:推送给财务总监
🔔 第六步:告警通知
6.1 配置告警规则
# 监控系统异常时自动通知
# 示例:监控服务器CPU使用率
openclaw cron add \
--name "server-alert" \
--schedule "*/5 * * * *" \
--task "检查服务器状态,如果CPU>90%或内存>85%,通过企业微信紧急通知运维群" \
--channel wecom \
--target "oc_alert_group_id"
6.2 告警消息模板
# 严重告警(红色)
🔴 **严重告警**
服务器: web-prod-01
CPU使用率: 95%
时间: 2026-06-04 01:00
建议: 立即检查服务状态
# 警告(黄色)
🟡 **警告通知**
数据库连接池使用率: 80%
时间: 2026-06-04 01:00
建议: 关注连接池扩容
🏗️ 完整配置示例
# ~/.openclaw/config.yaml - 企业微信完整配置
name: wecom-ai-assistant
agents:
default:
model: "gpt-4o-mini"
systemPrompt: |
你是企业内部AI助手,名叫"小智"。
性格:专业、高效、友好
能力:回答工作问题、整理信息、日程提醒
规则:简洁回答,不确定时坦诚说明
channels:
wecom:
enabled: true
corpId: "ww1234567890abcdef"
agentId: "1000002"
secret: "aBcDeFgHiJkLmNoPqRsT"
token: "your_verify_token"
encodingAESKey: "xxxxxxxxxxxxxxxx"
autoReply:
enabled: true
triggerMode: "mention"
welcomeMessage: "你好!我是小智,有什么可以帮你的?"
groupChat:
enabled: true
allowedGroups:
- "oc_team_group"
- "oc_tech_group"
triggerMode: "mention"
# 敏感词过滤
sensitiveWords:
- "密码"
- "token"
- "密钥"
sensitiveAction: "warn" # warn | block | ignore
📈 最佳实践
- 🔒 安全第一:不要在群聊中讨论敏感信息,使用私聊处理机密内容
- 📝 日志记录:启用消息日志,便于审计和问题排查
- ⚡ 性能优化:群聊只在被@时回复,避免频繁调用AI
- 🎯 角色明确:为不同场景配置不同的Agent(客服、日报、告警)
- 🔄 渐进式上线:先在测试群验证,再推广到全公司
- 📊 使用统计:定期查看使用数据,优化AI回复质量
🆘 常见问题
Q: 回调验证失败?
A: 检查Token和EncodingAESKey是否与企业微信后台一致。确认回调URL可以公网访问且使用HTTPS。
A: 检查Token和EncodingAESKey是否与企业微信后台一致。确认回调URL可以公网访问且使用HTTPS。
Q: 群消息收不到?
A: 确认机器人已被添加到群中,且群ID在allowedGroups配置中。检查triggerMode是否为"mention"(需要@机器人才回复)。
A: 确认机器人已被添加到群中,且群ID在allowedGroups配置中。检查triggerMode是否为"mention"(需要@机器人才回复)。
Q: 推送消息失败?
A: 检查access_token是否过期(2小时有效期),OpenClaw会自动刷新。确认应用可见范围包含目标用户/部门。
A: 检查access_token是否过期(2小时有效期),OpenClaw会自动刷新。确认应用可见范围包含目标用户/部门。