🏢 OpenClaw 接入企业微信完全指南

群机器人 · 自动回复 · 消息推送 · 审批流集成

导读:企业微信是国内企业最常用的沟通工具。通过OpenClaw接入企业微信,你可以打造一个24小时在线的AI助手——自动回复客户咨询、推送日报周报、处理审批流程。本教程从零开始,手把手教你实现。

🎯 能做什么?

📋 前置准备

1 企业微信管理员账号(需要创建应用的权限)
2 已安装并运行OpenClaw
3 一个公网可访问的服务器(用于Webhook回调)
4 域名和SSL证书(推荐,企业微信要求HTTPS)

🚀 第一步:创建企业微信应用

1.1 创建自建应用

  1. 登录 企业微信管理后台
  2. 进入 应用管理自建创建应用
  3. 填写应用名称(如"AI助手")、上传Logo、选择可见范围
  4. 创建完成后,记录 AgentIdSecret

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

📈 最佳实践

🆘 常见问题

Q: 回调验证失败?
A: 检查Token和EncodingAESKey是否与企业微信后台一致。确认回调URL可以公网访问且使用HTTPS。
Q: 群消息收不到?
A: 确认机器人已被添加到群中,且群ID在allowedGroups配置中。检查triggerMode是否为"mention"(需要@机器人才回复)。
Q: 推送消息失败?
A: 检查access_token是否过期(2小时有效期),OpenClaw会自动刷新。确认应用可见范围包含目标用户/部门。