消息通道
摘要
通道就是「你从哪儿跟它说话」。OpClaw 支持微信（个人号）、企业微信、飞书、钉钉、Mattermost，以及网页工作台与语音硬件；同一个伙伴可以同时挂多条，但同一个人、同一件事建议只走一条。本页逐条通道给出接入方式、能收到什么、以及几条容易踩的坑。
通道总览
| 通道 | 适合谁 | 接入方式 | 是否需要公网回调 |
|---|---|---|---|
| 微信（个人号） | 个人用户，最省事 | 扫码授权 | 否 |
| 企业微信 | 有企业微信组织的用户 | 在企业侧建应用/机器人，把凭据交给它 | 否（出站连接即可） |
| 飞书 | 用飞书办公的团队 | 开放平台建机器人 + 订阅事件 | 视部署方式而定 |
| 钉钉 | 用钉钉办公的团队 | 开放平台建机器人 + 事件回调 | 视部署方式而定 |
| Mattermost | 自建协作平台、要私有化 | 建机器人账号，提供地址与令牌 | 否（实例主动连服务器） |
| 网页工作台 | 任何人，开通即有 | 无需接入 | — |
| 语音硬件 | 想用说话代替打字 | 把设备登记到你的实例 | — |
微信（个人号）
最常见的个人入口。
- 怎么接：在对话里说「帮我把微信接上」，它会给出一个授权二维码链接；用手机微信打开并确认即可。
- 能收到什么：文字、图片、文件；你在微信里发给它的东西它会直接处理。
- 两点注意：
- 二维码有时效，拿到就尽快扫码。
- 授权凭据会保存在你的实例里，重启后仍然有效，不用重扫。
企业微信
- 怎么接：需要你在企业微信侧创建一个机器人/应用，把对应的标识与密钥交给它。
- 网络要求：只需实例能出网连到企业微信的开放平台，不需要公网回调地址——这对内网部署很关键。
- 会话形态：单聊与群聊是两种不同形态，路由规则不同；群聊里通常需要 @ 它才会响应。
飞书 / 钉钉
- 怎么接：在对应开放平台创建机器人应用，配置消息收发与事件订阅，把凭据交给它。
- 能力：文字、图片、文件、卡片类消息；具体到哪一项取决于你在平台上开通了哪些权限。
- 注意：这两条通道通常要求一个可被平台访问的回调地址。如果你的实例在内网，需要先解决可达性（例如反向代理或内网穿透），再接入。
Mattermost
- 适合：自建协作平台、要求数据落在自己环境里的场景。
- 怎么接：在 Mattermost 里建一个机器人账号，把服务器地址与令牌交给它；实例主动连过去，因此不需要公网回调。
- 群组消息的坑：Mattermost 的「群组消息」不在频道列表下，而在左栏的直接消息分组里；这类消息与普通频道消息的路由规则不同，群里说话同样需要 @ 它。
网页工作台与语音硬件
- 网页工作台：开通即有，不需要任何接入动作。适合第一次试用、以及在外面没有 IM 可用时应急。
- 语音硬件：把设备登记到你的实例后才能接入；未登记的设备会被拒绝。适合固定位置（车里、桌上）用说话代替打字。
通道与身份
通道决定两件事：会话归属与它会说多少。
| 问题 | 规则 |
|---|---|
| 会话怎么分 | 按「通道 + 你的账号」划分：在微信里聊到一半，换到 Mattermost 继续说，它不会自动接上刚才那段上下文 |
| 长期记忆会不会丢 | 不会。你的口径、习惯、资料存在实例里，与通道无关 |
| 它怎么判断你是谁 | 通道上的账号对应到一位「同事」档案：本人 / 同事 / 访客，决定它给多少信息、能不能下任务 |
| 未识别的人来找它 | 只回答一般性问题，不执行任务，也不透露你的资料 |
同一件事只走一条通道
同一时刻挂多条通道没问题，但同一个人、同一件事只用一条。两条通道同时绑到同一个处理逻辑时，同一条消息可能被回应两次；而且上下文分在两处，你自己也会绕晕。
需要在另一条通道接着聊时，明说一句就行：「接着刚才微信里那个任务继续」。
逐条能力对照
各通道在「群聊是否需要 @ 它」「能不能改自己发过的消息」「能不能显示"正在输入"」「能不能流式输出」「能不能收发文件」这些细节上的差异，见通道能力对照。
常见问题
接了新通道，旧通道要关吗？ 不用。想收拢的话说「先把 Mattermost 那条通道停掉」即可，随时能再打开。
换手机 / 换微信号怎么办？ 重新走一次扫码授权；管理员侧不需要做什么。
通道里它不回话？ 依次确认：这条通道是否处于启用状态 → 你在不在它的允许名单里 → 是不是群聊没 @ 它。三者都正常时，在工作台的「消息通路」视图里看这条消息有没有进来。