渠道
在 Telegram、微信、飞书和 Slack 里和 agent 对话
通过渠道，你可以在常用的聊天应用里和 agent 对话。打开 Agents，选择一个 agent，然后选择 管理 和 渠道。
每个 bot 或应用都属于你自己，并且只服务一个 agent。一个 agent 在每个平台上可以连接一个账号。TokenFlux 只为这个 agent 保存 token 和密钥。这些凭证保存后不会再显示，也不会传进沙箱。
| 平台 | 连接方式 | 支持的聊天 |
|---|---|---|
| Telegram | 在 Telegram 里创建 bot，或粘贴 bot token | 私聊、群聊和话题 |
| 微信 | 用微信扫描二维码 | 只支持私聊 |
| 飞书 | 扫描二维码，或填写 App ID 和 App Secret | 私聊、群聊和话题 |
| Slack | 粘贴应用级 token 和 bot token | 私信和频道 |
聊天如何工作
先绑定聊天。 没有绑定的聊天不能使用 agent。要绑定聊天，在渠道页面选择 生成链接 或 生成绑定码，然后按页面上的说明操作。链接或绑定码只能使用一次，10 分钟后过期。
一个聊天对应一个会话。 每个已绑定的聊天和 agent 有自己的会话。聊天里的第一条消息会创建这个会话，会话会显示在网页版的 会话 列表里。发送 /new 后，下一条消息会开始一个新会话。重新绑定这个聊天，也会开始一个新会话。
群聊权限。 默认只有绑定聊天的人能让 agent 运行任务，agent 会忽略其他人。绑定整个群的人可以在群里发送 /members on，允许所有群成员使用 agent；发送 /members off 后，恢复为只有绑定人可以使用。不能在话题里修改群聊权限。
开启 /members on 后，每个任务都由所有者付费。任何群成员都会获得 agent 的完整控制权，包括工作区、API
key、自动化和记忆。只应在为这个团队专门设置的 TokenFlux 账号上启用。/members off
只阻止其他人的新请求，不会撤销已经执行的操作。已经接受的任务仍会继续运行。
在群聊里，agent 读取提到它或回复它的消息。话题跟随只适用于飞书和 Slack。
在平台允许时，顶层消息提到 bot 后开启的话题默认开启跟随。此后，有使用权限的人发送消息，即使没有提到 bot，也可能启动付费任务。
在话题里发送 /follow off 后，消息需要再次提到 bot。要重新开启跟随，请发送 @bot /follow on。关闭跟随时，单独发送 /follow on 会被忽略。
跟随不会改变谁可以使用 agent。已经接受的任务仍会继续运行。Telegram 不支持 /follow。
回复。 任务运行时，聊天里会显示 agent 正在工作。回复按各平台自己的方式流式显示：
- Telegram：私聊里显示草稿，群聊里显示一条持续编辑的消息。最终回答作为新消息发送。
- 飞书：一张随回复内容逐步填充的卡片，完成后卡片就是最终回答。
- Slack：一条流式消息，完成后这条消息就是最终回答。
- 微信：先显示“正在输入”，然后发送最终回答。
较长的回答会拆成多条消息。在 Telegram 和微信里，特别长的回答会被截短，并提示到网页版查看完整结果。
引导任务。 聊天里的任务运行时，新发送的消息会引导这个任务。
只支持文字。 聊天应用只把文字发给 agent。聊天里的图片和文件不会被读取。要发送图片，请使用网页版。
启动、停止、替换和断开。 停止 会保留账号和已绑定的聊天，但在你重新启动之前，agent 会忽略所有消息。替换账号或断开账号，会解绑这个账号的所有聊天。解绑 只移除一个聊天。删除 agent 会断开它的所有渠道。
聊天命令
在已绑定的聊天里发送这些命令。在 Slack 里，需要先提到 bot，例如 @bot /new，因为 Slack 会自己处理以 / 开头的消息。
| 命令 | 作用 |
|---|---|
/new | 下一条消息开始一个新会话。 |
/stop | 停止这个聊天的会话里的任务。网页版里启动的任务继续运行。 |
/compact | 压缩这个会话的上下文。这个操作可能消耗模型 token。 |
/model [ID] | 列出可用模型，或设置这个会话的模型。 |
/thinking [level] | 查看或设置这个会话的思考强度。 |
/session | 查看这个会话的用量。 |
/members [on|off] | 绑定整个群的人在群里设置谁可以使用 agent。 |
/follow [on|off] | 只适用于飞书和 Slack 话题。关闭后，请发送 @bot /follow on 重新开启。 |
/help | 列出所有命令。 |
模型和思考强度的修改从下一条消息开始生效。
Telegram
创建 bot。 如果渠道页面显示 创建 bot，请在你使用 Telegram 的设备上打开链接。在 Telegram 里选择 Create bot 并确认。Telegram 会创建一个属于你的 bot，TokenFlux 会连接这个 bot，并自动绑定你的私聊。这个私聊无需粘贴 token 或生成绑定链接。给 bot 发一条消息即可开始。
使用 bot token。 如果要使用已有的 bot，选择 已有 bot？使用 token 连接。如果页面没有 创建 bot，会直接显示 token 表单。
- 在 Telegram 里打开 @BotFather。
- 发送
/newbot并设置名称。BotFather 会回复一个 token。 - 粘贴 token，然后选择 连接并启动。
这个 bot 不能设置 webhook，也不能同时服务另一个 agent。
绑定聊天。 使用 token 连接时，选择 生成链接。打开链接或扫描二维码，然后在 Telegram 里点击 Start 绑定私聊。自动创建 bot 时已经绑定私聊，无需再次绑定。要绑定群聊，选择 把 @bot 拉进群，然后选择群聊。
- 在开启话题的群里，每个新话题都有自己的会话。
- 普通群升级为超级群后，群的 ID 会改变。请重新绑定。
- 断开 bot 不会在 Telegram 里删除这个 bot。
微信
- 选择 显示二维码。
- 用手机上的微信扫描二维码，不要用相机扫描，然后确认。
- 你的私聊已经绑定。给 bot 发一条消息即可开始。
微信要求你先给 bot 发一条消息，bot 才能给你发消息。在此之前，聊天会显示 暂时收不到消息。要绑定另一个微信聊天，选择 生成绑定码，然后把 link CODE 发给 bot。出错后要重新连接，选择 重新扫码。
飞书
扫描二维码。
- 选择 显示二维码。
- 用手机上的飞书扫描二维码。创建一个新应用，或选择你已有的应用。
- 应用连接后，会在私聊里向你打招呼。在私聊里回复即可开始。
填写 App ID 和 App Secret。 选择 改为手动填写 App ID 和 App Secret。
- 在飞书开放平台创建企业自建应用，并添加机器人能力。
- 开通基本聊天所需的租户权限：
im:chat、im:message、im:message.group_at_msg:readonly、im:message.p2p_msg:readonly和cardkit:card:write。这些权限用于读取聊天信息、发送消息、接收私聊和群聊中提到 bot 的消息，以及创建或更新流式回复卡片。 - 如果需要话题跟随，再开通
im:message.group_msg。这个权限用于读取话题历史，以及接收未提到 bot 的话题回复。这个权限需要租户管理员批准。基本聊天不需要这个权限。 - 将事件接收方式设为长连接，并订阅
im.message.receive_v1。 - 粘贴 App ID 和 App Secret，然后选择 连接并启动。
绑定聊天。 选择 生成绑定码。在私聊里把 link CODE 发给 bot，或在群聊里提到 bot 并发送 link CODE。在群聊里，agent 回答提到它或回复它的消息。在已开启跟随的话题里，有使用权限的人无需提到 agent 也能让它回复。
Slack
Slack 通过你在自己工作区里创建的 Socket Mode 应用连接。
- 在 api.slack.com/apps 从头创建一个应用（from scratch）。
- 开启 Socket Mode，并创建一个带
connections:write权限的应用级 token（xapp-）。 - 添加这些 bot token 权限：
chat:write、reactions:write、users:read、channels:read、groups:read、im:read、channels:history、groups:history和im:history。 - 订阅 bot 事件
message.channels、message.groups和message.im，然后安装应用。 - 粘贴应用级 token 和 bot token（
xoxb-），然后选择 连接并启动。
绑定聊天。 选择 生成绑定码。在私信里把 link CODE 发给 bot，或者在 bot 所在的频道里发送这段文字。绑定一个频道会绑定整个频道。在频道里，每条提到 bot 的顶层消息都会开启一个话题串，这个话题串有自己的会话。