Telegram 新手教程

把正在工作的机器人放进私人群组

建立私人群组、开启 Topics,然后测试你现有的 Telegram 机器人。

这里不需要 bot token。

完成你的群组已经准备好现在应该看到上面的四项。General 里的机器人回复就是最后证明。

开始前

先检查三件事

本教程使用一个已经可以在 Telegram 私聊中工作的机器人。

你需要

  • Telegram 已安装,而且你已经登录。
  • 你的机器人会在私聊中回复。
  • 你知道机器人的完整 @username。

完成后你会看到

  • 一个名为 My Agent Group 的私人群组。
  • Topics 已开启,而且看得到 General 和 Ideas。
  • 你在 General 发送 hi 后,正确的机器人会回复。

Topic: Topic 是群组里面较小的聊天空间。它可以把一个主题放在自己的位置。

选择设备

选择一条路径

选择你现在使用的 Telegram 应用。下面的按钮会按照这个应用显示。

已选择设备iPhone使用 iPhone 或 iPad 上的 Telegram 应用。

阶段 1

建立私人群组

把你已经在私聊中使用的机器人加入群组。

  1. 点击右上角的 New Message(铅笔图标)。

    然后: 你会看到一个菜单。

    iPhone:New Message 中会看到 New Group。红色标记指出要点击的项目。
  2. 点击 New Group。

    然后: Telegram 会打开成员搜索页面。

  3. 点击 Search,然后输入机器人完整的 @username。

    然后: 你会看到匹配的机器人。

    iPhone:搜索结果显示匹配的机器人。图中的机器人名称来自原始截图。
  4. 点击正确的机器人。

    然后: 机器人会被选为群组成员。

  5. 点击 Next。

    然后: Telegram 会打开群组名称页面。

  6. 输入 My Agent Group。

    然后: 名称会出现在名称栏中。

    iPhone:群组名称页面的右上角有 Create。
  7. 点击 Create。

    然后: 新的群组会打开。

  8. 点击顶部的群组照片或名称。

    然后: 你会看到群组资料页面。

  9. 点击 Edit,再点击 Group Type。

    然后: 你会看到群组类型页面。

  10. 选择 Private,然后点击 Done。

    然后: 群组会保持私人状态,也不会有公开用户名或公开链接。

现在应该看到: 现在应该看到 My Agent Group、正确的机器人在成员列表中,以及 Group Type 是 Private。

阶段 2

开启 Topics,并建立 Ideas

Topic 是群组里面较小的聊天空间。General 是主要聊天空间。Ideas 会是同一个群组里的另一个聊天空间。

  1. 点击顶部的群组照片或名称。

    然后: 你会看到群组资料页面。

  2. 点击 Edit,再点击 Topics。

    然后: Topics 设置会打开。

  3. 开启 Enable Topics。

    然后: 如果你的版本有询问,Telegram 会显示 Topic 的显示方式。

  4. 如果 Telegram 询问显示方式,请选择 List。

    然后: 群组会回到 Topic 列表。

    如果你的版本没有询问,请继续下一步。

  5. 打开 Topic 菜单,然后点击 New Topic。

    然后: 你会看到 Topic 名称栏。

    iPhone:群组菜单显示 View as Topics、Topic 列表和 New Topic。
  6. 输入 Ideas,然后点击 Create。

    然后: Ideas Topic 会打开。

  7. 点击一次返回键,回到 Topic 列表。

    然后: General 和 Ideas 都会列出来。

现在应该看到: 现在应该看到 General 和 Ideas。General 是主要聊天空间。Ideas 是群组里面较小的聊天空间。

阶段 3

给予机器人群组访问权限

机器人私聊和群组的访问规则是分开的。

管理员是有额外群组控制权的成员。管理员机器人可以收到群组消息。这和 privacy mode(隐私模式)不同;隐私模式是 Telegram 用来限制普通机器人可以看到哪些消息的规则。Hermes 也可能决定要不要回复。请按照下面的小权限清单设置,不要一开始就关闭 privacy mode。

  1. 点击群组照片或名称,再点击 Edit。

    然后: 群组设置会打开。

  2. 点击 Administrators。

    然后: 管理员列表会打开。

  3. 点击 Add Admin,再选择正确的机器人 @username。

    然后: 机器人的权限页面会打开。

    iPhone:保持 Admin Rights 开启,然后在加入机器人前检查每个较小权限。
  4. 保持 Admin Rights 开启。

    然后: 机器人可以收到群组消息。

  5. 保持以下较小权限关闭:Change Group Info、Delete Messages、Ban Users、Invite Users via Link、Pin Messages、Manage Video Chats、Remain Anonymous,以及 Add New Admins。

    然后: 机器人有管理员访问权,但没有额外控制权。

  6. 点击 Add Bot as Admin,再点击 Done。

    然后: 机器人会出现在管理员列表中。

现在应该看到: 现在应该在 Administrators 中看到正确的机器人。管理员是有额外群组控制权的成员。管理员机器人可以看到群组消息,所以只在你信任的群组中这样设置。

阶段 4

在 General 测试机器人

先在 General 测试。等待最多一分钟,看机器人是否回复。

  1. 打开 General。

    然后: 主要群组聊天会打开。

  2. 点击消息输入框。

    然后: 键盘会打开。

  3. 输入 hi。

    然后: 消息输入框会出现 hi。

  4. 点击 Send。

    然后: 你的 hi 消息会出现在 General。

  5. 等待最多一分钟。

    然后: 正确的机器人会在你的消息下方回复。

现在应该看到: 现在应该在 General 看到 hi,以及正确机器人的回复。这就是完成条件。

机器人没有回复

帮助

机器人没有回复

按照这个顺序检查。找到问题后就停下来。

1. 检查机器人私聊

打开同一个机器人的私聊,然后发送 hi。

  1. 如果机器人在那里回复,请继续下面的检查。
  2. 如果机器人在那里也没有回复,请停止这条群组恢复路径并找 Sean 帮忙。需要时可以参考现有的安装教程。

你的主 agent 可能和群组里的机器人不是同一个。

2. 检查群组里的机器人

把完整的 @username 和你刚才私聊测试的机器人比较。

  1. 打开群组成员列表。
  2. 确认正确的机器人在成员列表中。
  3. 确认同一个机器人在 Administrators 中,并且可以访问消息。
  4. 如果群组已经存在,请打开 Group Info,使用 Add Members 加入正确的 @username。
Telegram Desktop:检查列出的权限,关闭额外权限,再点击 Save。

3. Telegram 不让你加入机器人时

BotFather 可以控制机器人能不能加入群组。

  1. 打开官方的 @BotFather 私聊。检查蓝色验证标记和 BotFather 名称。
  2. 发送 /setjoingroups。
  3. 选择你自己的机器人。
  4. BotFather 显示时,点击 Enable。
  5. 等待确认消息。
  6. 回到 My Agent Group,再试一次 Add Members。
BotFather:打开你所选择机器人的 Bot Settings。

4. 只有确认需要时才改变 privacy mode

只有主 agent 确认问题来自 privacy mode 时,才使用这条路径。

  1. 打开 @BotFather,发送 /setprivacy。
  2. 选择你自己的机器人。
  3. 点击 Disable,并等待确认。
  4. 把机器人从群组移除。
  5. 重新加入同一个机器人。
  6. 按照上面的权限清单,把机器人重新设为管理员。
  7. 再回到 General 测试 hi。
BotFather:Allow Groups? 控制能否加入群组。Group Privacy 是另一个例外设置。

Telegram 说明,改变 privacy mode 后,可能需要把机器人移除再重新加入。不要把它当成第一步或通用修复方法。

5. 请主 agent 检查 Hermes

Telegram 可能已经送出消息,但 Hermes 选择不回复。

  1. 告诉主 agent 普通 hi 有没有回复。
  2. 告诉主 agent 标记 @机器人 hi 有没有回复。
  3. 请它检查群组授权,以及群组机器人是否需要被标记。
  4. 不要把 bot token 贴到 Telegram。

gateway 是把 Hermes 连接到 Telegram 的运行服务。本页面不会叫你重启或更改它。如果需要终端操作,请找 Sean。

我找不到 Topics

Topics 是群组设置。

  1. 打开群组设置。
  2. 寻找 Topics。
  3. 如果你不是群主或管理员,请请群主开启。
  4. 如果仍然找不到,请更新 Telegram。

iPhone、Android 和 Telegram Desktop 的路径不同。只按照你选择的设备路径操作。

我找不到 Android 设置

Android 的群组设置在群组顶部和铅笔图标里面。

  1. 打开群组。
  2. 点击顶部的群组名称。
  3. 点击铅笔图标。
  4. 寻找 Topics 或 Administrators。

不要在 Android 使用 iPhone 或 Desktop 的菜单路径。

Hermes 要求我输入 group ID

本教程的主要路径不需要 group ID。

  1. 把群组名称、机器人 @username,以及 General 测试结果告诉主 agent。
  2. 询问它是否真的需要 group ID。
  3. 如果仍然需要,请找 Sean 帮你找正确的 ID。不要猜。

现在应该看到: 现在应该知道下一项安全检查是什么。需要帮助时,请使用主 agent 的私聊和下面可以复制的讯息。

机器人没有回复

和你的主 agent 一起检查

主 agent 就是你平时在 Telegram 私聊里使用的那个 agent。需要帮助时,打开你和它的私聊。它可能和群组里的机器人不是同一个。

DM: DM 的意思是私聊,也就是你和主 agent 之间的一对一聊天。

  1. 1

    打开你和主 agent 的私聊。

  2. 2

    在那里发送 hi。

  3. 3

    如果主 agent 回复,请继续。

  4. 4

    在群组的 General 输入 @,从 Telegram 建议中选择目标机器人,再加上 hi,然后发送。

  5. 5

    记录这个标记讯息有没有收到回复。

  6. 6

    回到主 agent 的私聊,发送下面的帮助讯息。

  7. 7

    一次只执行一个指示。每次完成后告诉主 agent 发生了什么。

  8. 8

    主 agent 叫你重测时,回到 General 再测试。

如果标记机器人后有回复,但普通 hi 没有回复,说明机器人在被标记时可以回复。把这个结果告诉主 agent,让它检查群组机器人的回复方式。

如果主 agent 在私聊中也没有回复,请停止这条恢复路径并找 Sean。不要把 token、登录验证码或密码贴到 Telegram。 打开现有安装教程

制作帮助讯息

填写这个表格。讯息会在你的浏览器中制作,不会在这里发送或保存。

不要在讯息或截图中放入 bot token、登录验证码或密码。

完成

你的群组已经准备好

把这个私人群组留给机器人工作。用 General 做快速测试,用 Ideas 记录新想法。

  • My Agent Group 是私人群组。
  • Topics 已开启。
  • General 和 Ideas 都看得到。
  • 正确的机器人回复了 General 里的 hi。

现在应该看到: 现在应该看到上面的四项。General 里的机器人回复就是最后证明。