mirror of
https://github.com/lobehub/lobehub
synced 2026-04-21 17:47:27 +00:00
cded932f1a
* ✨ docs: add screenshots to Telegram channel guide * 📝 docs: Remove "feature in development" callout and developer mode requirement from channels documentation. * docs: Migrate Telegram channel images to local assets and update CDN cache. * docs: Add screenshots to channel setup guides for various platforms. * chore: Update documentation image paths from GitHub user attachments to local blog assets. --------- Co-authored-by: Rdmclin2 <rdmclin2@gmail.com>
90 lines
3.4 KiB
Text
90 lines
3.4 KiB
Text
---
|
||
title: 将 LobeHub 连接到微信
|
||
description: 了解如何通过 iLink Bot API 将微信机器人连接到您的 LobeHub 代理，使您的 AI 助手能够在微信私聊和群聊中与用户互动。
|
||
tags:
|
||
- 微信
|
||
- 消息渠道
|
||
- 机器人设置
|
||
- 集成
|
||
---
|
||
|
||
# 将 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 秒的自然延迟。这是预期行为。
|
||
- **一段时间后连接断开：** 微信会话会定期过期。再次点击 "扫码连接" 重新认证。
|