配置通道 - 企业微信
摘要
企业认证客户可在企业微信内部群中使用已接入的智能机器人,通过 @ 机器人对话。添加入口和可用范围以企业微信客户端及组织权限为准;私聊可用后,仍需单独验证目标群中的回复。
企业微信群与个人微信群不同:企业微信支持上述群聊 @ 对话,个人微信通道当前仍仅支持一对一。将机器人加入企业微信群,不代表它自动获得入群前的历史记录或群内全部消息;需要整理的历史讨论应在对话中补充提供。
企业微信通道采用扫码接入方式,适合在企业办公场景中使用 Hermes Agent。
本页覆盖
-
在 LightVela 生成企业微信接入二维码
-
使用手机企业微信扫码授权
-
在企业微信私聊或内部群聊中与 Hermes Agent 进行对话
操作步骤
1. 进入管理台
登录 LightVela,进入管理台,选择目标 Bot 后打开「通道」。
2. 选择企业微信通道
在「通道」页面找到 企业微信 卡片,点击 + 连接。

3. 扫码授权
页面弹出二维码。
4. 使用手机企业微信扫码
-
打开手机企业微信
-
点击右上角「+」→「扫一扫」
-
对准电脑屏幕上的二维码扫描

- 按手机提示完成授权


5. 与创建的机器人对话
扫码成功后:
-
弹窗自动关闭,可进入创建的机器人页面
-
企业微信自动添加机器人账号
进入该机器人的聊天界面,发送测试消息:
你好几秒内收到 Hermes Agent 回复。

6. 在企业微信内部群聊中使用
企业认证客户可使用以下群聊流程。
- 将上一步已连接的智能机器人添加到目标企业微信内部群。可添加范围和操作入口以企业微信客户端及组织权限为准。
- 在群聊的 @ 列表中选择该机器人,发送「你好」作为测试消息。
- 确认机器人在同一个群内回复。私聊能回复,只能证明私聊链路可用;群聊需单独验证。
群聊时,通过 @ 机器人提出问题或提供需要整理的内容。若要总结历史讨论,请将相关文本或文件发给机器人,再说明需要提取哪些待办或提醒。
用管理台测试已连接通道
企业微信卡片显示 已连接 后,可点击 测试,再到企业微信确认收到来自 LightVela 的测试消息。页面提示“测试消息已发送”只表示发送命令被接受;还应在企业微信向机器人发送“你好”,确认 Agent 能回复。
如果测试消息未到达,检查当前 Bot 和通道连接,必要时重新连接后再试;能收到测试消息却没有回复时,检查模型与积分,并查看诊断中心。
成功状态
-
在 企业微信 卡片确认显示 已连接,再从该平台发送测试消息。
-
企业微信联系人中可查找到对应机器人
-
发送消息后能收到 Hermes Agent 回复
-
使用群聊时,在目标企业微信内部群 @ 机器人后能收到回复
支持的消息类型
接入成功后,企业微信机器人除了能够接收、回复基础文本信息外,还支持更多消息类型,详情如下:
| 企业微信机器人支持的消息类型 | 是否支持 |
|---|---|
| 接收文本信息 | ✅ 已支持 |
| 接收图片、视频 | ✅ 已支持 |
| 接收文件 | ✅ 已支持 |
| 接收语音消息 | ✅ 已支持 |
| 回复文本信息 | ✅ 已支持 |
| 回复图片、视频 | ✅ 已支持 |
| 回复文件 | ✅ 已支持 |
| 主动发送消息(如定时发送提醒) | ✅ 已支持 |
| 企业微信内部群聊 @ 对话 | ✅ 企业认证客户可用 |
常见问题
| 现象 | 可能原因 | 处理方式 |
|---|---|---|
| 扫码后企业微信提示"无效二维码" | 二维码已过期 | 关闭弹窗,重新点击「连接」 |
| 扫码完成后电脑端无响应 | 网络延迟或授权未完成 | 刷新管理台页面确认状态;若未接入成功则重新操作 |
| 企业微信中找不到机器人联系人 | 消息被折叠至"服务通知" | 在企业微信顶部搜索"LightVela"或 Hermes Agent 名称 |
| 发送消息后无回复 | 模型未配置或体验积分耗尽 | 检查「管理 → 模型」中的主模型及检测结果 |
| 私聊能回复,群内无回复 | 机器人未加入目标群、未正确 @,或群权限受限 | 确认已添加到企业微信内部群,从 @ 列表选择机器人后重试;仍无回复时检查通道状态与诊断中心 |
| 群内找不到或无法添加机器人 | 群类型或组织权限限制 | 核对是否为企业微信内部群,以及当前账号是否有权添加该机器人;必要时联系企业管理员 |
| 如何解除绑定 | — | 在 企业微信 卡片点击 断开,阅读提示并确认。 |
| 连接另一个 Bot 时看不到原企业微信通道 | 通道显示在实际拥有连接的 Bot 下 | 切回原 Bot 核对连接;多 Bot 的连接与切换规则见管理与切换 Bot |
通道说明
-
消息类型:支持文本、图片、视频、文件、语音等多种类型,详见上方「支持的消息类型」
-
群聊支持:支持企业微信内部群聊;将已连接的机器人加入群后,通过 @ 机器人发起对话。个人微信通道的限制见配置通道 - 微信。
-
上下文范围:机器人根据通过通道实际收到的消息处理任务。加入群聊不等于自动获取入群前的历史记录,也不能据此假设所有未 @ 的消息都会被读取。整理历史讨论时,请补充相关文本或文件。
-
连接中断:长时间无响应可能为授权被撤销,回管理台重新连接即可
下一步
最后更新于 2026-11-15