🚀 Telegram-O.o GO!

用户	管理员

✨ 功能特性

• ✉️ 全能消息转发: 支持转发所有类型的消息，包括文本、图片、视频、贴纸、文件等。
• ↩️ 便捷回复功能: 只需对机器人转发的消息使用 "回复" 功能，即可将你的回复（任何类型）发送给原始用户。
• 💾 持久化会话: 机器人重启或服务器宕机后，依然可以回复之前的旧消息，不会丢失对话上下文。
• 🔐 安全可靠: 敏感信息（Bot Token 和 Owner ID）通过外部配置文件管理，不暴露在代码中。
• 🎨 美观的 UI: 经过精心设计的消息格式，信息清晰，重点突出，交互友好。
• ⚙️ 管理功能: 为机器人添加验证功能，回答问题错误超3次永久拉黑或者手动拉黑。
• 🚀 部署简单: 提供了详细的部署指南，支持多种后台运行方式。

---

🔧 部署指南

请遵循以下步骤在你的 VPS上部署此机器人。

1. 准备工作

在开始之前，请确保你已经拥有：

• 一台可以访问 Telegram API 的 VPS。
• 在 VPS 上安装了 Python 3.8+。
• 一个 Telegram 账号。

2. 获取 Telegram 必要凭证

你需要从 Telegram 获取两样东西：

• Bot Token (机器人令牌)

  • 在 Telegram 上搜索 BotFather 并开始对话。
  • 发送 /newbot 命令。
  • 按照提示为你的机器人设置一个名字和用户名（用户名必须以 bot 结尾）。
  • ​BotFather 会给你一串 Token，形如 123456:ABC-DEF1234ghIkl-zyx57W2v1u123456789。请妥善保管它。

• Owner ID (你的用户ID)

• 在 Telegram 上搜索 userinfobot 并开始对话。

• 它会立刻返回你的个人信息，其中的 Id: 就是你的 Owner ID。这是一个纯数字。

3. 部署步骤

第 1 步：下载.py文件并安装依赖

连接到你的 VPS 终端，执行以下命令。

1. 下载本项目

下载.py项目到你喜欢的目录。（一定要记得住，后面要用。）

2. 进入项目目录

cd到你的项目目录 cd /文件目录

3.创建并激活 Python 虚拟环境

apt install python3.13-venv

python3 -m venv venv

source venv/bin/activate

4. 安装所需的库

pip install python-telegram-bot --upgrade

第 2 步：配置机器人

1. 在项目目录里插件一个命名为 config.ini 的文件。

2. 编辑 config.ini 文件，填入你在准备工作中获取到的凭证。

   [Telegram]

   BOT_TOKEN = 123456:ABC-DEF1234ghIkl-zyx57W2v1u123456789

   OWNER_ID = 123456789

第 3 步：启动机器人

你可以先在前台启动来测试机器人是否配置正确。 运行命令:

python3 项目.py

此时，你的机器人应该已经在线。同时你的管理员账号也会收到一条"机器人已启动"的通知。

第 4 步：让机器人在后台永久运行 (生产环境)

为了让机器人在你关闭 SSH 连接后依然能 7x24 小时运行，你需要使用进程管理器：

1.创建一个sudo nano /etc/systemd/system/telegram_forwarder.service服务

2.将下面的配置粘贴到文件中（注意格式）。你需要修改 WorkingDirectory 和 ExecStart 中的路径，使其指向你自己的项目.py路径和python解释器路径。

[Unit]

Description=Telegram Forwarder Bot

After=network.target

[Service]

User=root

#你的项目文件所在的绝对路径

WorkingDirectory=/项目路径

#你的python解释器的绝对路径 (可以用 which python3 命令查看)

ExecStart=/项目路径/python3 /项目路径/forwarder_bot_v版本号.py

Restart=always

RestartSec=10

[Install]

WantedBy=multi-user.target

• 你可以通过 pwd 命令查看当前目录的绝对路径。

• 你可以通过 which python3 命令查看python3的绝对路径。

3.常用控制指令（如更新代码请直接覆盖旧代码并按一下顺序重启机器人）

#停止服务

sudo systemctl stop telegram_forwarder

#重新加载systemd配置

sudo systemctl daemon-reload

#启动你的机器人服务

sudo systemctl start telegram_forwarder

#设置开机自启

sudo systemctl enable telegram_forwarder

5.检查服务状态：

sudo systemctl status telegram_forwarder

如果看到 active (running) 的绿色字样，说明你的机器人已经作为系统服务成功运行了！现在，你就拥有了一个稳定、可靠、能转发各类消息的个人Telegram机器人了。

---

部署完成！

📚 使用说明

升级方法：停止服务—>删除旧的.py文件—>导入新的.py文件—>重新加载systemd配置—>启动你的机器人服务

普通用户

• 找到你的机器人。
• 直接发送任何类型的消息（文本、图片、文件等）。
• 消息将被自动转发给机器人主人，并收到确认回执。

机器人主人 (Owner)

• ​接收消息: 用户消息会被自动转发给你，并附带用户信息。 ​

• ​回复消息: 在 Telegram 中，对机器人转发的任意一条消息使用“回复”功能，你的回复内容将被自动发送给原始用户。 ​

  • 命令:
  • /start: 查看欢迎信息。
  • /help: 获取帮助。
  • /clear: 清除所有消息的回复记录。这不会删除聊天记录，只会让机器人“忘记”如何回复旧消息。