💬 企业微信接入
👤 适合谁：使用企业微信办公的企业用户
⏱️ 阅读时长：约 5 分钟
💡 一句话：让 YingClaw 成为企业微信里的智能员工，随时在线，高效协作。
将 YingClaw 接入企业微信，通过 WebSocket 长连接实现企业内部消息的实时收发。
接入概览
YingClaw 通过企业微信的机器人 WebSocket 协议建立长连接，支持文本、图片、语音消息的收发，并具备心跳检测和自动重连能力。
| 场景 | 说明 |
|---|---|
| 💼 企业助手 | 员工在企业微信中直接对话 AI |
| 📋 业务查询 | 查询 CRM、订单、数据报表 |
| 📢 通知推送 | 系统告警、定时报告推送到企微群 |
配置步骤
1. 获取企业微信机器人凭证
在企业微信管理后台创建机器人应用，获取：
- Bot ID：机器人唯一标识
- Secret：机器人密钥
2. 在 YingClaw 中配置
登录 YingClaw Web 控制台，进入「通信频道」页面，打开企业微信开关：
| 参数 | 说明 |
|---|---|
bot_id | 企微机器人 Bot ID |
secret | 企微机器人 Secret |
websocket_url | WebSocket 连接地址，默认 wss://openws.work.weixin.qq.com |
allowed_users | 允许使用 Bot 的员工白名单，* 表示所有员工 |
3. 启动通道
保存配置后，YingClaw 自动建立 WebSocket 长连接。系统会：
- 定时发送心跳包保持连接
- 断线后自动重连
- 实时接收和回复消息
消息交互
私聊场景
员工直接向企微 Bot 发送消息，支持：
- 💬 智能问答和业务咨询
- 📊 销售数据查询（CRM 集成）
- 📝 文档生成和编辑
- ⏰ 日程管理和任务分配
群聊场景
将 Bot 添加到企业微信群后，群成员发送消息可被 Bot 感知，支持在群聊中推送通知和报告。
消息类型支持
| 类型 | 发送 | 接收 |
|---|---|---|
| 文本 | ✓ | ✓ |
| 图片 | ✓ | ✓ |
| 语音 | ✗ | ✓ |
白名单控制
channels:
wecom:
allowed_users:
- "ZhangSan" # 仅允许特定员工
# - "*" # 允许所有员工
注意事项
- WebSocket 连接需要网络可达
openws.work.weixin.qq.com - 语音消息仅支持接收，暂不支持发送
- 心跳机制自动维护连接，无需手动干预
- 建议使用独立的企业微信应用，与其他业务隔离