3.14 在 IM 里和同事对话

IM 通道让你不打开工作台，也能在飞书、Telegram 或 Slack 里和主助手、指定同事对话；在已绑定的 IM 群里 @同事派活；收到审批卡片时直接批准或拒绝。会话、群消息和审批都走 Teloa 本身的服务，工作台里看到的是同一份记录。

启用 IM 通道

IM 通道是随 Teloa 发行的可选官方扩展，默认不启用；未启用时，设置 → IM 通道 只显示一张引导卡。

1. 点引导卡上的「前往市场「扩展」启用」，或打开 市场 → 扩展，在「官方扩展」区找到「IM 通道」，点「启用」并确认。也可以在对话里请助手启用，批准确认卡即可。
2. 状态变为「已启用 · 重启后生效」后，重启 Teloa。重启后状态为「已启用」，设置页出现渠道表单。

停用也在 市场 → 扩展 操作，重启 Teloa 后生效。停用不会删除任何东西：已保存的渠道、凭据与绑定都会保留，重新启用即可恢复；要清除，请先在设置页移除渠道再停用。从旧版本升级时，若之前配过至少一个渠道，首次启动会自动启用，无需再操作；没配过的保持未启用。

准备

• Teloa 运行在 Node.js 22 或更高版本上，本机需要能访问所选 IM 平台。
• 在平台上自建一个机器人（Telegram bot、Slack 内部 App 或飞书企业自建应用），拿到它的凭据。
• 一个渠道只绑定一位本人账号。IM 里其他人发的消息不会被当成指令执行。

各平台需要的凭据：

渠道	凭据	平台侧要求
Telegram	Bot Token	用 BotFather 创建机器人
Slack	Bot Token（xoxb-）与 App Token（xapp-）	开启 Socket Mode；授予 connections:write、chat:write、app_mentions:read、im:history、channels:history
飞书	App ID、App Secret，Encrypt Key 可选	事件订阅用长连接；开通 im:message、im:message.group_at_msg 与卡片回调

添加渠道并绑定

1. 打开 设置 → IM 通道，在「添加渠道」选择渠道类型，填入凭据后保存。页面只显示「凭据已保存」，不会再显示凭据内容。
2. 打开该渠道的开关。状态变为「已连接」后，点「生成配对码」。
3. 在 IM 里私聊机器人，发送 /pair 配对码。配对码 10 分钟内有效、只能用一次，在群里发送无效。
4. 机器人回复「已绑定」后，刷新设置页，「已绑定的账号」里会出现你的账号。可在这里把默认对话对象从「主助手」改成某位同事。

首次保存飞书渠道时，Teloa 会下载并核对固定版本的飞书开发包，可能要等一分钟左右。

渠道凭据只能在设置页保存。在环境变量里设置 SLACK_BOT_TOKEN、FEISHU_APP_SECRET 等不会生效，_FILE 形式同样不生效；启动器会把这类变量从宿主环境剔除，并在启动日志里提示一次（只列变量名）。

私聊与命令

私聊里直接发文字，就会进入与默认对象的会话；回复完成后发回同一私聊。可用命令：

命令	作用
/new	新开一个会话
/status	查看当前对话对象
/stop	停止当前回复
/同事 名字（/colleague）	切换到某位同事；/同事 助理 切回助理
/任务（/tasks）	查看最近任务
/需要你（/attention）	查看待你处理的事项
/help	命令说明

密钥、付款、账号与安全设置只能在工作台完成，IM 里会收到引导链接。

在群里派活

在设置页的「群绑定」把 IM 群绑定到 Teloa 的某个协作群。之后在该 IM 群里 @机器人 或 @同事名，你的这条消息会连同之前最多 10 条他人发言（作为资料，不作为指令）一起发到协作群，由同事接手；同事的回复会发回原 IM 群。未 @ 的发言只在内存里暂存，不写入记录。

审批

同事执行需要授权的操作时，工作台和你的 IM 私聊会同时出现审批卡片，先处理的一方生效；在工作台先处理时，IM 卡片随即改为「已在网页处理」并撤下按钮。只有绑定者本人能在 IM 里处理；卡片 30 分钟无人处理会过期，请回到工作台处理。IM 只能批准或拒绝本次调用，不能改动授权规则。

已知限制

• 在 IM 里先处理了审批后，工作台上同一张卡片会停留到本轮结束，再点它不会产生效果。
• Teloa 重启后，重启前发出的 IM 审批卡片会过期，点击只会提示「已处理或已过期」。
• 同一台电脑上只允许一个 Teloa 连接同一组 IM 渠道；另一个会显示「连接出错 · 另一台 Teloa 已连接该渠道」。
• 暂不支持在 IM 里收发文件、流式显示回复或把话题关联到任务。

部署时的网络与数据位置说明见运行配置与数据位置。