# Telegram 机器人

> 在私聊里和角色一对一聊天，把角色带进群组，用内联方式分享它们，或者打开 Mini App。

Source: https://reverie.im/zh/docs/integrations/telegram-bot
Language: zh

Reverie 机器人把角色带进 Telegram——可以是和机器人的私聊、一个群组，或者一个它当管理员的频道。它还能在 Telegram 里以 Mini App 的形式直接打开 Reverie，在那里你可以用 Telegram Stars 买积分。

## 装起来 \[#set-it-up]

### 关联你的账号 \[#link-your-account]

和角色聊天的每个人都需要一个关联了自己 Telegram 账号的 Reverie 账号——免费账号就够了。一个 Telegram 账号只能对应一个 Reverie 账号。

* **从网站。** 在应用里进入 **Labs → Discord 与 Telegram 机器人**，在 Telegram 卡片上按 **在 Telegram 中关联**。Telegram 会打开和机器人的对话；点击“开始”，你就关联到了当前登录的账号。页面会自己更新。
* **从 Telegram。** 打开机器人并发送 `/start`。**使用 Telegram 继续** 会通过 Mini App 创建一个免费的 Reverie 账号，不需要邮箱。**我已有账号** 会发来一个一次性链接，**10 分钟**内有效，用它把你的 Telegram 连到一个已有的账号上；`/link` 随时都能发同样的链接。

### 挑一个角色 \[#pick-a-character]

发送 `/chat` 看看能和谁聊——先是你在这里已经在聊的角色，然后是推荐——或者在 `/chat` 后面加上名字来搜索。点一个就可以开始写了。

### 把角色带进群组 \[#bring-characters-into-a-group]

可选。把机器人加进一个群组——Telegram 卡片上的 **添加机器人到群组** 就能做到——然后在那里发送 `/add <name>`。机器人会搜索，并把最多八个匹配结果做成按钮；点一个就加进来。只有群管理员能添加角色。

## 你的私聊 \[#your-private-chat]

你和机器人的私聊是你自己的对话，费用记在你自己的账号上。每条消息都会得到回复——不需要提及。

* **一次一个角色。** `/chat` 换成别人，`/chats` 列出你在这里聊过的角色。每个角色都保留自己的对话，所以换回来时能接着上次聊。
* `/remove` 结束当前对话——它会保存下来，可以从 `/chats` 找回——`/reset` 在请你确认后清空它。
* **18+ 角色** 跟随你账号的 18+ 设置：设置关着时，它们会被隐藏，也不能在这里聊天。
* 你最近的对话也会出现在集成面板的 **私聊** 下，**在网页上继续** 可以在浏览器里接着聊，**在 Telegram 中聊** 可以回到这里。

## 命令 \[#commands]

输入框旁边的菜单按钮会列出在当前位置能用的命令——私聊和群组各有自己的列表，并使用你的 Telegram 语言。

| 命令                  | 参数       | 在哪里         | 作用                                         |
| ------------------- | -------- | ----------- | ------------------------------------------ |
| `/start`            | —        | 私聊          | 帮你注册或关联，然后给出可选的角色。在群组里等同于 `/help`          |
| `/help`             | —        | 都可以         | 列出所有命令                                     |
| `/chat`             | 名字（可选）   | 私聊          | 选择或切换你正在聊的角色                               |
| `/chats`            | —        | 私聊          | 你聊过的角色，可以在它们之间切换                           |
| `/link`             | —        | 私聊          | 一个一次性链接，用来把你的 Telegram 连到已有的 Reverie 账号    |
| `/add`              | 搜索词（可选）  | 群组，管理员      | 搜索角色，并添加你点中的那个。在私聊里等同于 `/chat`             |
| `/remove`           | —        | 群组，管理员      | 把群里的角色列成按钮；移除你点中的那个。在私聊里则结束当前对话            |
| `/list`             | —        | 群组          | 本群的角色。在私聊里等同于 `/chats`                     |
| `/info`             | 角色名      | 都可以         | 角色详情。在私聊里，单独的 `/info` 介绍你正在聊的角色；在群组里必须带上名字 |
| `/settings`         | 一个子项（可选） | 都可以         | 打开设置菜单                                     |
| `/plugins`          | —        | 都可以         | 本对话里正在运行的插件，带有安装、移除或开关官方插件和你自己插件的按钮        |
| `/group`            | —        | 群组，管理员或付费方  | 谁能聊天、每位成员的每日上限、被屏蔽的成员和用量。在你的私聊里打开          |
| `/block`、`/unblock` | —        | 群组，管理员或付费方  | 作为对某位成员消息的回复发送：让对方不能再和角色聊天，或者恢复            |
| `/reset`            | —        | 都可以，群组里需管理员 | 清空本对话的历史                                   |
| `/regenerate`       | —        | 都可以         | 重掷上一条回复                                    |
| `/suggest`          | —        | 都可以         | 三条建议回复                                     |
| `/account`          | —        | 都可以         | 积分和订阅状态                                    |
| `/daily`            | —        | 私聊          | 领取每日签到                                     |
| `/notify`           | —        | 私聊          | 角色能否主动找你，以及哪些通知会发到这里                       |
| `/buy`              | —        | 私聊          | 用 Telegram Stars 购买订阅或积分包                  |
| `/app`              | —        | 都可以         | 打开 Reverie Mini App                        |
| `/paysupport`       | —        | 都可以         | 付款支持。已注册，但不在菜单里                            |

`/plugins` 列出本对话正在运行的提示词插件和工具插件；管理员或添加过角色的人会看到按钮，可以安装官方插件和自己的插件、移除它们，或将其开启和关闭。需要填写设置的插件无法从机器人安装。工具插件的结果会作为一张简短卡片发到对话里。

### 设置 \[#settings]

`/settings` 会打开一个内联菜单，你也可以用 `/settings model`、`language`、`mode`、`style`、`payment` 或 `limit` 直接跳到某一页。

| 菜单项                    | 作用范围              | 群组里仅限管理员 |
| ---------------------- | ----------------- | -------- |
| **Model (personal)**   | 你自己在本对话主角色上使用的模型  | 否        |
| **Language (chat)**    | 本对话的回复语言          | 是        |
| **Chat mode**          | 回复所有消息，还是只在被点到时回复 | 是        |
| **Chat style**         | 角色扮演文风，还是只有对白     | 是        |
| **Payment mode**       | 主人付费还是使用者付费       | 是        |
| **Daily credit limit** | 每个 UTC 日的积分上限     | 是        |

在私聊里，菜单提供 \*\*Model (personal)\*\*、**Reply language** 和 **Chat style**：私聊总是会回复，而且你为自己的消息付费。在群组里，菜单和报错消息过一会儿会自己删掉，好让对话保持干净。

## 群组和频道 \[#groups-and-channels]

在群组里，角色在被 **@提及** 或者你**回复**它的某条消息时作答——自动回复默认是关闭的，所以把角色加进一个热闹的群组，它也不会盖过所有人。用 `/settings mode` 打开它。如果机器人入群时说它只能看到提及它或回复它的消息，就把它设为群管理员：自动回复需要看到每一条消息。

在开启了话题的群组里，每条回复都会落在它所回答的那个话题里。整个群组在各个话题之间共用一套角色和一份历史。

机器人也可以在一个 Telegram **频道**里发言，只要它被设成了那里的管理员。

## 群组规则 \[#group-rules]

在群组里发送 `/group`。面板会在你和机器人的私聊里打开，这样群里的人不会看着你调整——如果你从没和机器人开始过私聊，它会先请你打开一个。群管理员可以用它，为群组角色付费的人也可以。面板显示今天和过去七天的用量、今天用得最多的成员，以及这些规则：

| 规则           | 选项                                                            |
| ------------ | ------------------------------------------------------------- |
| **谁能和角色聊天**  | **所有人**（默认）或 **仅管理员**                                         |
| **每位成员每日上限** | 每位成员每个 UTC 日最多能花掉多少付费方的积分，或 **不设上限**（默认）。只在付费方付费时生效           |
| **已屏蔽的成员**   | 在群组里用 `/block` 回复某位成员的消息，让对方不能再和角色聊天；用同样的方式发送 `/unblock` 可以撤销 |

管理员和付费账号永远不会被挡在外面，不论是屏蔽还是访问模式。被访问模式排除的成员会收到一次提示，说只有部分成员能和角色聊天；被屏蔽的成员则完全得不到回复。

## 分享角色 \[#sharing-a-character]

在任何 Telegram 对话里——哪怕机器人不在那里——输入机器人的 @用户名，后面跟上角色的名字，然后从列表里挑一个。它会发出一张卡片，卡片上的按钮会在机器人里打开和这个角色的一对一聊天。只提供不是 18+ 的公开角色。

## Mini App \[#the-mini-app]

`/app` 会在 Telegram 的浏览器里打开 Reverie，并用你的 Telegram 账号登录——完整的应用，带着你的角色清单、你的聊天和你的积分。

如果机器人回复说应用不可用，那就是 Mini App 没有开启——请改用浏览器打开 Reverie。

## 用 Telegram Stars 付款 \[#paying-with-telegram-stars]

`/buy` 把整个购买流程放在 Telegram 里完成。还没订阅时，你在套餐和积分包之间选；已经订阅时，会直接进入积分包，并且已经算上了订阅者加赠。选中之后会贴出一张原生的 Stars 账单，上面带一个 **Pay** 按钮。

`/buy` 只限私聊——群里的账单会向点它的那个人收钱。

## 谁来付费 \[#who-pays]

| 付费模式               | 记在谁头上                                   | 适用的上限                              |
| ------------------ | --------------------------------------- | ---------------------------------- |
| **Owner pays**（默认） | 群组的付费方：第一个把角色加进这个群组的 Reverie 账号，直到有别人接手 | 群组的每日积分上限，以及用 `/group` 设置的每位成员每日上限 |
| **User pays**      | 每个发送者自己的余额                              | 没有——每个成员受自己余额的约束                   |

消息的花费和网页应用里一样。每日计数在 **00:00 UTC** 重置。想把一个群组的账单转到自己的账号上，打开 `/group` 并按 **用我的账号付费**。在你的私聊里，你总是为自己的消息付费。

## 在 Telegram 里能用什么 \[#what-works-in-telegram]

* **图片。** 角色可以生成图片。
* **语音输出。** 角色可以发语音消息。
* **语音输入。** 语音条和音频文件会被转成文字，最大 **25 MB**。
* **记忆。** 当模型支持工具时，角色会保存和更新记忆，世界书里的设定也会带进它的上下文。
* **历史。** 对话变长时会自动生成摘要。

## 通知和签到 \[#notifications-and-check-ins]

`/notify` 管两件事。**角色主动找你** 是你账号的主动程度，和网站上是同一个设置：有订阅时，你在私聊里正在聊的角色可以主动给你写消息——见[主动消息](https://reverie.im/zh/docs/chatting/proactive-messages)。**同时发到这里** 决定你的哪些 Reverie 通知也会发到你的私聊；一开始只打开了 **账号与账单**——见[通知](https://reverie.im/zh/docs/account/notifications)。集成面板上也有同样的选项。

`/daily` 领取你的[每日签到](https://reverie.im/zh/docs/rewards/daily-check-in)，和网站上是同一个，并在 Mini App 里打开抽奖。

## 限制 \[#limits]

| 限制              | 数值        |
| --------------- | --------- |
| 每个对话的角色数        | 5         |
| 消息长度            | 4,096 个字符 |
| 语音输入大小          | 25 MB     |
| 每个对话排队的消息数      | 3         |
| `/add` 显示的搜索结果数 | 8         |

同一个人连着快速发出的消息会被合并成一轮。

## 解除关联 \[#unlinking]

在集成面板上用 **Unlink Account** 解除关联。

> 在 Telegram 里拉黑机器人不会解除账号关联。把机器人踢出群组只会让那个群里的角色停用。请在应用里用 **Unlink Account**。

## 相关 \[#related]

* [Discord 机器人](https://reverie.im/zh/docs/integrations/discord-bot) — 同样的角色，在服务器里
* [Reverie 实验室](https://reverie.im/zh/docs/integrations/labs) — 集成面板在哪儿
* [积分](https://reverie.im/zh/docs/billing/credits) — 一条消息要花多少
* [订阅](https://reverie.im/zh/docs/billing/subscriptions) — 一个套餐都包含什么