Docs / Guide / Channels
渠道平台
把 Muse 接进你每天用的聊天工具:微信、QQ、飞书、Telegram、钉钉五端接入,让助手直接在聊天里收发消息。
五端概览
在「设置 → 工具与连接 → 渠道」中配置。每个平台都有专属的配置表单(扫码登录、连接测试、图文教程),填好后打开开关即可开始收发消息。
- 微信:扫码登录,支持文本、图片与语音消息
- QQ:WebSocket 长连接接收,支持私聊与群聊(@机器人)
- 飞书:长连接事件通道,无需公网地址
- Telegram:长轮询接收,无需公网地址
- 钉钉:Stream 模式长连接
除微信外,其余平台的接收通道都基于长连接实现,手机不需要公网 IP、不需要内网穿透,也不依赖电脑中转。
微信
选择微信渠道后点击「扫码登录」,用微信扫描弹出的二维码完成登录。登录状态会在设置页实时显示,掉线后可重新扫码。
- 收到图片时自动下载、解密并压缩入库,AI 能直接看到图片内容
- 收到语音时自动转写成文字再交给模型
- 回复支持文本与图片(由模型产出的图片会作为图片消息发出)
在 QQ 开放平台创建机器人并填入 AppID / AppSecret,Muse 会通过 WebSocket 长连接接收消息。支持私聊与群聊:群里需要 @机器人 才会响应。
- 被动回复遵循官方消息 ID 机制,稳定性高
- 连接状态、心跳与重连全部自动处理
飞书
使用飞书开放平台的自建应用,填入 App ID / App Secret 并开启长连接。Muse 通过事件通道接收消息,无需配置回调地址。
- 支持单聊与群聊(群里 @机器人 触发)
- 事件分片、心跳与确认帧自动处理
Telegram 与钉钉
Telegram:填入 BotFather 提供的 Bot Token 即可,长轮询接收消息,无需公网地址。支持私聊与群组。
钉钉:使用企业内部应用,填入 Client ID / Client Secret,通过 Stream 模式接收消息,同样不需要公网回调。
渠道即对话
每个联系人(或群)都拥有独立的对话上下文,和主应用里的会话是同一套记忆与摘要机制:
- 多轮上下文自动携带,长聊不丢线索
- 历史变长后滚动摘要自动压缩,节省 Token 也不丢关键信息
- 在「渠道对话」页面可以展开查看每个联系人的最近消息
- 觉得上下文跑偏时,可以「重启上下文」清空该对话的历史与摘要
媒体与视觉
渠道消息里的媒体会经过统一处理链:
- 图片:下载 → 解密 → 压缩 → 入库,随消息一起交给模型
- 如果当前模型不支持视觉,自动走视觉桥:用你配置的视觉模型生成结构化描述再注入
- 语音:服务端识别转写为文字后进入对话
助手绑定
每个渠道可以指定使用哪个助手与模型——例如把「工作助手」绑到钉钉,把「私人助手」绑到微信,各平台人格、记忆与模型完全独立。