> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# 即时通讯

> 你在 Telegram、iMessage、KakaoTalk、Slack、WhatsApp、LINE 等应用上的聊天集中在一处，只在你同意后才发送。

即时通讯把你自己的聊天带进 Archetype：在一个页面上阅读和回复，有发给你的消息时收到通知，并让智能体读取它们。它默认开启，在侧边栏中显示为**即时通讯**，并带有未读数。开启和关闭插件，见[插件](https://docs.archetype.ing/zh/extend/plugins.md)。

## 连接账号

打开“即时通讯 → 添加账号”，选择一个网络。

| 网络 | 登录方式 |
| - | - |
| Telegram | 用二维码登录 |
| iMessage | 读取这台 Mac 上的“信息” |
| KakaoTalk | 你自己的账号 |
| Slack | 你自己工作区的私信和频道 |
| WhatsApp | 通过关联设备登录 |
| LINE | 你自己的账号 |
| Matrix 桥接 | Matrix 主服务器的桥接所连接的网络 |

KakaoTalk、LINE 和 WhatsApp 需要一个组件，即时通讯会在第一次使用时下载。一张卡片会说明它是什么、由谁制作、许可证和大小，并带有**连接**按钮；你按下之前，什么都不会下载。之后可以在**账号**中找到它，并用**从这台电脑删除**删除。

通过 Matrix 桥接，即时通讯还可以连接 Signal、Instagram、Facebook Messenger、Google Messages、LinkedIn、X 和 Bluesky。桥接在 Apple 芯片的 Mac 和 Linux 上运行，不支持 Intel Mac 和 Windows。

每个账号都会显示是否已连接。断开的账号会自动重试；**重新连接**会立即重试，或打开该网络的登录页面。

即时通讯在其他插件所用的沙盒之外运行，因为它要运行各个网络自己的辅助程序（iMessage 通过 AppleScript，KakaoTalk 的工具）。

## 页面

* 阅读和回复你的聊天。
* **草稿**和**总结**会请文件夹的模型来做。
* **速览**：自你上次阅读以来聊天中说了什么，以及哪些地方提到你或先向你提出请求，每一处都可以直接跳转。**全部速览**对未读最多的十个聊天执行同样的操作。

在页面的聊天中，打开的聊天会作为标签附上，还有一个**回复指导**标签，可以请它帮你想怎么回复。

## 智能体能做什么

| 工具 | 作用 | 是否询问你 |
| - | - | - |
| `list_messenger_chats` | 列出聊天 | 否 |
| `read_messenger_chat` | 读取一个聊天 | 否 |
| `search_messenger` | 搜索消息 | 否 |
| `catch_up_messenger` | 速览一个或全部聊天；不会标记为已读 | 否 |
| `send_messenger_message` | 发送消息 | 每次都问 |

发送前，你会看到聊天和网络、账号、确切的文字，以及它回复的那条消息。发送每次都会询问，即使在 `yolo` 模式下也是如此；没有人回答时，会被拒绝。见[批准](https://docs.archetype.ing/zh/use/approvals.md)。只有在账号登录后才有这些工具，它们会说明哪些账号无法读取。

## 通知

| 通知 | 时间 |
| - | - |
| **新消息** | 重要聊天中有别人发来的消息：一对一聊天中的每条消息，群组或频道中只有提及你的消息，已静音或已归档的聊天不通知。简短的“好”或“谢谢”不通知。每个聊天五分钟内最多通知一次 |
| **需要登录** | 某个网络结束了账号的会话。在重新连接之前只通知一次 |

在[配置](https://docs.archetype.ing/zh/reference/config.md)的 `notifications.chats` 下，按聊天的 id 或标题设置级别：`"all"`、`"mentions"` 或 `"off"`。

## 事件

**`message.received`**：未静音、未归档、非只读的聊天中有别人发来的新消息，与通知级别无关。它带有聊天、网络、是否为群组、消息的一行内容以及是否提及你。[触发器](https://docs.archetype.ing/zh/use/automations.md)可以由它唤醒。

## 设置

在“管理 → 插件 → 即时通讯”中：

| 设置 | 默认值 | 作用 |
| - | - | - |
| **保护连接尝试** | 关 | 在这台电脑上保留登录尝试记录，重启后依然有效。被拒绝的账号会停止自动重试；密码或验证码错误会结束这次登录，并等待一段时间后再试。KakaoTalk 账号 24 小时内最多自动登录三次；**重新连接**会再登录一次 |

## 配合使用

联系人通过即时通讯读取你的聊天，用于时间线和上次联系的时间。即时通讯不提供配置文件。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.