将 LobeHub 连接到微信

通过将微信渠道连接到您的 LobeHub 代理，用户可以通过微信私聊和群聊与 AI 助手互动。

前置条件

• 一个拥有有效订阅的 LobeHub 账户
• 一个微信账户

第一步：打开渠道设置

在 LobeHub 中，导航到您的代理设置，然后选择 渠道 标签页。从平台列表中点击 微信。

第二步：扫码连接

<Steps> ### 点击 "扫码连接"

在微信渠道页面中，点击 扫码连接 按钮。将弹出一个显示二维码的对话框。

使用微信扫码

打开手机微信，点击右上角的 + 按钮，选择 扫一扫，扫描 LobeHub 中显示的二维码。

确认登录

扫码后，微信中会出现确认提示。点击 确认 授权连接。

连接完成

确认后，LobeHub 将自动保存凭证并连接机器人。您应该会在渠道设置中看到成功消息。 </Steps>

第三步：测试机器人

打开微信，找到您的机器人联系人，发送一条消息。机器人应通过您的 LobeHub 代理进行响应。

将机器人添加到群聊

要在微信群聊中使用机器人：

1. 将机器人添加到微信群聊中
2. @提及机器人或在群中发送消息以触发响应
3. 机器人将在群聊中回复

高级设置

设置	默认值	描述
字符限制	2000	每条消息的最大字符数（范围：100–2000）
消息合并窗口	2000 毫秒	等待更多消息再回复的时间
显示使用统计	关闭	在回复中显示 Token 用量 / 成本统计

工作原理

与基于 Webhook 的平台（Telegram、Slack）不同，微信使用 iLink Bot API 的 长轮询 机制：

1. 当您扫描二维码时，LobeHub 从微信 iLink API 获取 bot token
2. LobeHub 持续轮询 iLink API 获取新消息（约 35 秒间隔）
3. 当消息到达时，通过 LobeHub 代理进行处理
4. 代理的响应通过 iLink API 发送回微信

此轮询由后台定时任务管理，连接会自动维护。

功能限制

• 不支持消息编辑 — 微信不支持编辑已发送的消息。更新的回复将作为新消息发送。
• 不支持表情回应 — 微信 iLink Bot API 不支持表情回应功能。
• 仅支持文本 — 目前仅支持文本消息。图片和文件附件暂不可用。
• 消息长度限制 — 超过 2000 个字符的消息将被自动拆分为多条消息发送。
• 会话过期 — 机器人会话可能会过期，需要重新扫码认证。

故障排除

• 二维码已过期： 在弹窗中点击 刷新二维码 生成新的二维码。
• 机器人未响应： 会话可能已过期。前往微信渠道设置，重新扫码连接。
• 响应延迟： 长轮询在两次轮询之间有最多 35 秒的自然延迟。这是预期行为。
• 一段时间后连接断开： 微信会话会定期过期。再次点击 "扫码连接" 重新认证。