---
title: 在 IM 里和同事对话
description: 把飞书、Telegram 或 Slack 接入 Teloa，在私聊里对话、在群里派活、在卡片上批准。
lastVerified: 2026-09-26
---

# 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 里收发文件、流式显示回复或把话题关联到任务。

部署时的网络与数据位置说明见[运行配置与数据位置](https://docs.teloa.ai/markdown/deploy/configuration.md)。