Telegram 机器人

在 Telegram 上使用 Starnion，您可以随时随地通过智能手机访问您的 AI 助手。您可以同时使用网页界面和 Telegram，对话历史统一保存在同一个账户下。

概述

通过 Telegram 频道，您可以：

  • 在智能手机上使用 Telegram 应用与 Starnion 进行对话
  • 发送图片、语音消息和文档文件
  • 在群聊中 @ 机器人来使用它
  • 使用与网页界面相同的技能和记忆功能

第一步：创建 Telegram 机器人

Telegram 机器人通过 BotFather 创建。

  1. 在 Telegram 上搜索 @BotFather 并开始对话。
  2. 发送 /start。
  3. 发送 /newbot。
  4. 输入机器人名称（例如：My Starnion）。
  5. 输入机器人用户名，必须以 bot 结尾（例如：my_starnion_bot）。
  6. BotFather 将发放一个 Token。
BotFather: Done! Congratulations on your new bot. You will find it at t.me/my_starnion_bot.
Use this token to access the HTTP API:
1234567890:ABCDefGHIjklMNOpqrsTUVwxyz1234567890

复制发放的 Token，下一步会用到。

安全提示： Token 相当于密码，请勿公开分享。

第二步：在 Starnion 中注册机器人

  1. 登录 Starnion 网页界面。
  2. 点击左侧菜单中的 设置。
  3. 选择 频道 标签页。
  4. 在 Telegram 部分，将复制的 Token 粘贴到 机器人 Token 字段中。
  5. 点击 保存。
  6. 开启 启用机器人 开关。

保存成功后，状态将显示为 运行中。

注意： 一个机器人 Token 只能注册到一个账户。如果输入已注册到其他账户的 Token，将会报错。

第三步：关联您的 Telegram 账户（配对）

仅注册机器人并不能将 Telegram 关联到您的 Starnion 账户。您必须完成配对，以关联”此 Telegram 账户是我的 Starnion 账户”。

配对方法

  1. 在 Telegram 上搜索您的机器人（@my_starnion_bot）并开始对话。
  2. 发送任意消息（例如：你好）。
  3. 如果机器人的 私聊策略 设置为 pairing，机器人将回复”配对请求已发送。”
  4. 进入 Starnion 网页界面 > 设置 > 频道 > Telegram，查看配对请求列表。
  5. 确认您的 Telegram 账户名称，点击批准。
  6. 现在您可以在 Telegram 上正常与机器人对话了。

配对策略

您可以在频道设置中配置私聊策略和群组策略。

私聊策略（私信）

策略 行为
allow 任何向机器人发送私信的用户都会立即收到回复。
pairing 只有已配对的账户才会收到回复。未配对的用户可以发送配对请求。
deny 忽略所有私信。

群组策略（群聊）

策略 行为
allow 回复群组中的所有消息。
mention 只有在 @ 机器人时（@bot_name）才回复。
deny 忽略所有群组消息。

推荐设置： 个人使用时，将私聊策略设为 pairing，群组策略设为 mention，既保证安全性又便于使用。

使用机器人

基本对话

配对完成后，像使用普通聊天应用一样对话即可。

我：今天天气怎么样？
机器人：首尔当前天气：晴，22°C。...

我：午餐花了12,000韩元
机器人：已记录午餐消费12,000韩元。本月餐饮总支出：87,500韩元

我：帮我找一个Python教程
机器人：我在网上搜索了Python教程...

发送图片

您发送的图片将被自动分析。

（发送收据照片）
机器人：我分析了这张收据。
    超市总计：35,600韩元
    商品：牛奶 2,800韩元，面包 4,500韩元，...
    是否自动记录到您的消费追踪器中？

语音消息

当您发送 Telegram 语音消息（语音备忘录）时，系统会将其转录为文字并进行处理。

（语音消息："今晚和朋友吃了烤五花肉，每人20,000韩元"）
机器人：语音消息已识别。
    已记录晚餐（烤五花肉）消费20,000韩元。

文档文件

发送 PDF、Word、文本文件等，机器人将分析内容或将其保存到知识库。

（发送PDF文件）
机器人：已处理文档"contract_2024.pdf"。
    共15页，主要内容：租赁协议...
    已保存以供搜索。

多设备同时使用

Starnion 支持同时使用网页界面和 Telegram。两个频道连接到同一个 AI 智能体，因此在一个频道中记录的内容可以在另一个频道中检索。

[在网页界面]
我：阅读目标：本月读3本书

[在Telegram中]
我：我的阅读目标是什么？
机器人：您的目标是本月读3本书。目前已完成1本。

在群聊中使用

您可以将机器人邀请到群组中，通过 @ 提及来使用它。

  1. 在群聊中，选择添加成员 > 搜索机器人用户名并邀请它。
  2. 如果群组策略为 mention，使用 @bot_name 消息 格式来 @ 它。
我：@my_starnion_bot 我们团队午餐总计150,000韩元，5个人各付多少？
机器人：每人30,000韩元。

我：@my_starnion_bot 纽约现在几点？
机器人：纽约（EST）当前时间为凌晨2:15。

注意事项

  • 一个 Token = 一个账户： 单个机器人 Token 只能关联一个 Starnion 账户。
  • 机器人 Token 安全： 如果您的 Token 泄露，请立即在 BotFather 中使用 /revoke 命令重新生成，并在 Starnion 设置中更新新 Token。
  • 服务器重启： Starnion 网关重启时，已启用的机器人将自动恢复。

故障排除

机器人不响应

  1. 检查 设置 > 频道 > Telegram 下的状态是否显示为运行中。
  2. 如果状态显示为已配置，则机器人已禁用，请开启启用机器人开关。
  3. 即使状态为运行中仍无响应：
    • 检查私聊策略是否设置为 deny。
    • 如果需要配对，请完成配对流程。

409 冲突错误

当两个服务器同时使用相同的机器人 Token 运行时会出现此错误。

  • 不要同时运行 Docker 和本地开发环境。
  • 在启动新服务器之前，请完全关闭旧服务器。
  • Starnion 使用 PostgreSQL 咨询锁来防止冲突。

配对不起作用

  • 确认机器人处于活跃状态。
  • 如果私聊策略为 deny，配对请求将被完全阻止。请将其更改为 pairing 或 allow。
  • 确认您已批准网页界面中配对请求列表中显示的请求。

常见问题

Q：我可以不使用 Telegram 机器人来使用 Starnion 吗？ 可以，您只需使用网页界面即可使用所有功能。Telegram 是一个可选的额外频道。

Q：多人可以使用同一个 Telegram 机器人吗？ 不可以。每个用户必须创建自己独立的机器人。但是，群聊中多个已配对的用户可以通过 @ 提及共享一个机器人。

Q：更改机器人 Token 会发生什么？ 现有机器人将自动停止，并使用新 Token 重新启动。之前已配对的账户信息将保留。

Q：对话内容存储在 Telegram 的服务器上吗？ Telegram 消息经过 Telegram 服务器传输，但 Starnion 中的对话处理和存储在您自己的自托管服务器上进行。

Copyright © 2025 StarNion. All rights reserved.  |  v0.1.1