渠道接入
渠道(Channel)是 SkyalyticClaw 与外部即时通讯平台的连接通道,让你可以通过各种聊天工具使用 AI 助手。
支持的渠道
| 渠道 | 连接方式 | 说明 |
|---|---|---|
| Telegram | Polling / Webhook | 支持 Bot API |
| Discord | WebSocket | 支持频道和 DM |
| Slack | Socket Mode / HTTP | 企业级协作平台 |
| 钉钉 | Stream 模式 | 无需公网 IP |
| 飞书 | WebSocket / Webhook | 支持 @机器人 |
| 企业微信 | WebSocket 长连接 | 企业内部通讯 |
| WebSocket + Intents | 支持官方 Bot 和 OneBot | |
| 微信 | iLink 扫码登录 | 个人微信接入 |
| Web Chat | HTTP / WebSocket | 内置 Web 界面 |
渠道中心
通过 渠道中心 管理所有渠道连接:
- 点击左侧导航栏的 渠道中心
- 查看已配置的渠道列表及状态
- 添加新渠道或编辑现有渠道
- 启用或禁用渠道
配置渠道
Telegram
- 通过 @BotFather 创建 Bot 并获取 Token
- 在渠道中心选择 Telegram
- 填写 Bot Token
- 选择模式:Polling(推荐)或 Webhook
Discord
- 在 Discord Developer Portal 创建应用
- 获取 Bot Token
- 将 Bot 邀请到服务器
- 填写 Bot Token
Slack
- 在 Slack API 创建应用
- 配置 Bot Token 和 App-Level Token
- 选择模式:Socket Mode(推荐)或 HTTP
钉钉
- 在钉钉开放平台创建机器人
- 获取 Client ID 和 Client Secret
- 选择 Stream 模式(推荐,无需公网 IP)
提示
钉钉 Stream 模式不需要公网 IP 和回调地址,适合内网部署。
飞书
- 在飞书开放平台创建应用
- 开启机器人能力
- 获取 App ID 和 App Secret
- 选择 WebSocket(推荐)或 Webhook 模式
企业微信
- 在企业微信管理后台创建应用
- 获取 Corp ID、Agent ID 和 Secret
- 填写配置
QQ
- 在 QQ 开放平台创建机器人
- 获取 App ID 和 Token
- 选择官方 Bot 或 OneBot 模式
微信(iLink)
- 在渠道中心选择 微信
- 扫描二维码登录
- 登录成功后即可通过微信与 AI 对话
注意
微信 iLink 渠道使用扫码登录方式,需要定期重新扫码以保持连接。
消息处理
渠道管理器实现了三重消息去重机制:
- ID 去重:基于消息唯一 ID
- Hash 去重:基于消息内容哈希
- 时间窗口去重:防止短时间内重复处理
渠道与代理绑定
每个渠道可以绑定特定的代理:
- 绑定后,该渠道的所有消息都由指定代理处理
- 不同渠道可以绑定不同代理,实现场景化配置
- 未绑定代理的渠道使用默认代理
