LightVela

配置通道 - 企业微信

摘要

企业认证客户可在企业微信内部群中使用已接入的智能机器人,通过 @ 机器人对话。添加入口和可用范围以企业微信客户端及组织权限为准;私聊可用后,仍需单独验证目标群中的回复。

企业微信群与个人微信群不同:企业微信支持上述群聊 @ 对话,个人微信通道当前仍仅支持一对一。将机器人加入企业微信群,不代表它自动获得入群前的历史记录或群内全部消息;需要整理的历史讨论应在对话中补充提供。


企业微信通道采用扫码接入方式,适合在企业办公场景中使用 Hermes Agent。

本页覆盖

  • 在 LightVela 生成企业微信接入二维码

  • 使用手机企业微信扫码授权

  • 在企业微信私聊或内部群聊中与 Hermes Agent 进行对话


操作步骤

1. 进入管理台

登录 LightVela,进入管理台,选择目标 Bot 后打开「通道」。

2. 选择企业微信通道

在「通道」页面找到 企业微信 卡片,点击 + 连接。

当前通道页面的连接卡片

3. 扫码授权

页面弹出二维码。

4. 使用手机企业微信扫码

  1. 打开手机企业微信

  2. 点击右上角「+」→「扫一扫」

  3. 对准电脑屏幕上的二维码扫描

  1. 按手机提示完成授权

5. 与创建的机器人对话

扫码成功后:

  • 弹窗自动关闭,可进入创建的机器人页面

  • 企业微信自动添加机器人账号

进入该机器人的聊天界面,发送测试消息:

你好

几秒内收到 Hermes Agent 回复。

6. 在企业微信内部群聊中使用

企业认证客户可使用以下群聊流程。

  1. 将上一步已连接的智能机器人添加到目标企业微信内部群。可添加范围和操作入口以企业微信客户端及组织权限为准。
  2. 在群聊的 @ 列表中选择该机器人,发送「你好」作为测试消息。
  3. 确认机器人在同一个群内回复。私聊能回复,只能证明私聊链路可用;群聊需单独验证。

群聊时,通过 @ 机器人提出问题或提供需要整理的内容。若要总结历史讨论,请将相关文本或文件发给机器人,再说明需要提取哪些待办或提醒。


用管理台测试已连接通道

企业微信卡片显示 已连接 后,可点击 测试,再到企业微信确认收到来自 LightVela 的测试消息。页面提示“测试消息已发送”只表示发送命令被接受;还应在企业微信向机器人发送“你好”,确认 Agent 能回复。

如果测试消息未到达,检查当前 Bot 和通道连接,必要时重新连接后再试;能收到测试消息却没有回复时,检查模型与积分,并查看诊断中心。


成功状态

  • 在 企业微信 卡片确认显示 已连接,再从该平台发送测试消息。

  • 企业微信联系人中可查找到对应机器人

  • 发送消息后能收到 Hermes Agent 回复

  • 使用群聊时,在目标企业微信内部群 @ 机器人后能收到回复


支持的消息类型

接入成功后,企业微信机器人除了能够接收、回复基础文本信息外,还支持更多消息类型,详情如下:

企业微信机器人支持的消息类型是否支持
接收文本信息✅ 已支持
接收图片、视频✅ 已支持
接收文件✅ 已支持
接收语音消息✅ 已支持
回复文本信息✅ 已支持
回复图片、视频✅ 已支持
回复文件✅ 已支持
主动发送消息(如定时发送提醒)✅ 已支持
企业微信内部群聊 @ 对话✅ 企业认证客户可用

常见问题

现象可能原因处理方式
扫码后企业微信提示"无效二维码"二维码已过期关闭弹窗,重新点击「连接」
扫码完成后电脑端无响应网络延迟或授权未完成刷新管理台页面确认状态;若未接入成功则重新操作
企业微信中找不到机器人联系人消息被折叠至"服务通知"在企业微信顶部搜索"LightVela"或 Hermes Agent 名称
发送消息后无回复模型未配置或体验积分耗尽检查「管理 → 模型」中的主模型及检测结果
私聊能回复,群内无回复机器人未加入目标群、未正确 @,或群权限受限确认已添加到企业微信内部群,从 @ 列表选择机器人后重试;仍无回复时检查通道状态与诊断中心
群内找不到或无法添加机器人群类型或组织权限限制核对是否为企业微信内部群,以及当前账号是否有权添加该机器人;必要时联系企业管理员
如何解除绑定—在 企业微信 卡片点击 断开,阅读提示并确认。
连接另一个 Bot 时看不到原企业微信通道通道显示在实际拥有连接的 Bot 下切回原 Bot 核对连接;多 Bot 的连接与切换规则见管理与切换 Bot

通道说明

  • 消息类型:支持文本、图片、视频、文件、语音等多种类型,详见上方「支持的消息类型」

  • 群聊支持:支持企业微信内部群聊;将已连接的机器人加入群后,通过 @ 机器人发起对话。个人微信通道的限制见配置通道 - 微信。

  • 上下文范围:机器人根据通过通道实际收到的消息处理任务。加入群聊不等于自动获取入群前的历史记录,也不能据此假设所有未 @ 的消息都会被读取。整理历史讨论时,请补充相关文本或文件。

  • 连接中断:长时间无响应可能为授权被撤销,回管理台重新连接即可


下一步

最后更新于 2026-11-15