7.3 企业微信接入
想象一下这个场景：
公司 IT 服务群里，员工问："打印机连不上了怎么办？"
@机器人 后，30 秒得到完整排查步骤和工单链接。
再也不用等 IT 同事上班了。
如果你的团队已经在用企微办公，把 OpenClaw 接入进去，能让 AI 助手直接服务内部同事。这一节，我们用20分钟完成企微接入。
准备工作
开始前，确认你有：
- 企业微信管理员权限（或让管理员协助）
- 一个企业微信群（用于接入机器人）
- OpenClaw 已安装并运行
- 约 20 分钟时间
⚠️ 注意：个人微信无法直接接入企业微信，需要企业认证
接入方式选择
企业微信接入有两种方案：
| 方式 | 适用场景 | 私聊 | 群聊 | 难度 |
|---|---|---|---|---|
| 群机器人 | 群聊问答、通知推送 | ❌ | ✅ | 简单 |
| 自建应用 | 完整功能、私聊+群聊 | ✅ | ✅ | 较复杂 |
本节介绍群机器人方案，5 分钟就能跑通。自建应用方案请参考官方文档。
第一步：创建群机器人
- 打开企业微信，进入 客户端-工作台 ，点击 智能机器人-创建机器人，选择API模式创建
- 选择以 长连接 方式创建，并获取
Bot ID和Secret
第二步：配置 OpenClaw
2.1 安装插件
bash
openclaw plugins install @wecom/wecom-openclaw-plugin2.2 添加渠道
bash
openclaw channels add按提示输入：
| 提示 | 输入 |
|---|---|
| 选择渠道 | 企业微信(WeCom) |
| 企业机器人Bot ID | 前面保存的 Bot ID 值 |
| 企业机器人Secret | 前面保存的 Secret 值 |
| 配对方式 | 选择 Pairing |
完成后续配置，并可看到配置渠道成功。
在企业微信中，保存机器人，并跟他发消息。会收到一个配置密钥。
textOpenClaw: access not configured. 您的企业微信用户ID：XXXX Pairing code: XXXX Ask the bot owner to approve with: openclaw pairing approve openclaw-wecom XXXX
复制此信息 最后一行，并输入在终端中，完成配对。
第三步：启动 Gateway 并测试
3.1 启动 Gateway
bash
openclaw gateway3.2 发送测试消息
在群里 @机器人：
@AI助手 你好配置正确的话，机器人会立即回复。
机器人限制说明
根据企业微信官方文档，群机器人有以下限制：
| 限制项 | 说明 |
|---|---|
| 群聊限制 | 仅支持群聊，不支持私聊 |
| 触发方式 | 必须 @机器人才能触发 |
| 频率限制 | 每个机器人每分钟最多 20 条 |
| 消息长度 | 最长 2048 个字符 |
| 安全提醒 | 请勿将 Webhook 地址泄露到公开网络 |
📚 官方文档：https://open.work.weixin.qq.com/help2/pc/cat?doc_id=21657
自建应用方案（扩展）
如需私聊或主动推送功能，可使用自建应用方案。
功能对比
| 功能 | 群机器人 | 自建应用 |
|---|---|---|
| 私聊 | ❌ | ✅ |
| 群聊 | ✅ | ✅ |
| 主动推送 | ❌ | ✅ |
| 菜单交互 | ❌ | ✅ |
| 配置难度 | 简单 | 较复杂 |
配置要点
- 登录 企业微信管理后台
- 应用管理 → 创建应用 → 获取 AgentId 和 Secret
- 接收消息 → 配置回调 URL（需公网可访问）
- OpenClaw 中添加 WeCom App 渠道
⚠️ 自建应用需要公网回调地址，本地部署需配合内网穿透（如 ngrok）
消息格式
企微支持 Markdown，机器人回复自动转换：
@AI助手 帮我写个周报 机器人： ## 本周工作总结 - 完成 A 项目需求评审 - 修复 B 功能 3 个 bug - 编写 C 模块技术文档 **下周计划**： 1. 启动 D 功能开发 2. 配合测试进行回归
故障排查
机器人不响应
| 检查项 | 操作 |
|---|---|
| Webhook Key | 确认从 URL 正确提取（不含 key= 前缀） |
| Gateway | openclaw gateway status 查看运行状态 |
| @提及 | 必须在群里 @机器人名称 |
| 日志 | openclaw logs --follow 查看实时日志 |
消息发送失败
| 错误 | 原因 | 解决 |
|---|---|---|
| 频率限制 | 每分钟超过 20 条 | 等待 1 分钟后重试 |
| 长度超限 | 超过 2048 字符 | 精简消息内容 |
| 无效 key | Webhook Key 错误或失效 | 检查 Key 或重置机器人 |
私聊支持
群机器人不支持私聊。如需私聊：
- 使用自建应用方案
- 引导用户到群聊中使用
应用场景示例
IT 服务台
员工：@IT助手 打印机连不上了 机器人：请按以下步骤排查： 1. 检查打印机电源 2. 确认网络连接 3. 重启打印服务 如仍有问题，请提交工单：https://xxx
销售支持
销售：@销售助手 查客户 A 的最新订单 机器人：【客户 A 订单信息】 最新订单：#20240308001 金额：￥50,000 状态：待发货
HR 问答
员工：@HR助手 今年年假还剩几天？ 机器人：您今年的年假情况： 总天数：10 天 已使用：3 天 剩余：7 天
这一节，你做了什么
| 步骤 | 成果 |
|---|---|
| 创建群机器人 | 获取 Webhook 地址和 Key |
| 配置 OpenClaw | 安装插件，添加 WeCom 渠道 |
| 启动 Gateway | 建立消息通道 |
| 测试验证 | 在群聊中 @机器人成功 |