ChatGPT-Telegram-Bot

环境要求

• Telegram 机器人 BOT_TOKEN（需向 @BotFather 申请）
• OpenAI 兼容格式的 API_KEY 与 BASE_URL 接口地址
• Docker 环境（本地 Docker 部署方式）或 Python >= 3.10（源码部署方式）
• 容器内服务监听 8080 端口，需映射到宿主机端口

安装与启动步骤

1. 1准备 Telegram 令牌

   在 Telegram 中向 @BotFather 申请机器人，拿到 BOT_TOKEN；同时准备好 OpenAI 兼容接口的 API_KEY 和 BASE_URL。

2. 2Docker 启动容器

   用预构建镜像拉起机器人，把容器 8080 端口映射到宿主机 80，并挂载 user_configs 目录持久化配置。

   docker run -p 80:8080 --name chatbot -dit -e BOT_TOKEN=your_telegram_bot_token -e API_KEY=sk-xxxxxxxx -e BASE_URL=https://api.openai.com/v1 -v ./user_configs:/home/user_configs yym68686/chatgpt:latest

   复制

3. 3或用 Compose 部署

   在目录下新建 docker-compose.yml，填入环境变量；CUSTOM_MODELS 可自定义模型分组，不填则用默认模型列表。

   version: "3.5"
   services:
     chatgptbot:
       container_name: chatgptbot
       image: yym68686/chatgpt:latest
       environment:
         - BOT_TOKEN=your_telegram_bot_token
         - API_KEY=sk-xxxxxxxx
         - BASE_URL=https://api.openai.com/v1
         - CUSTOM_MODELS=-all;GPT:gpt-5,gpt-3.5-turbo;Claude:claude-3-opus,claude-3-sonnet
       volumes:
         - ./user_configs:/home/user_configs
       ports:
         - 80:8080

   复制

4. 4后台运行 Compose

   先拉取最新镜像再后台启动服务，适合需要反复更新镜像的场景。

   docker-compose pull
   docker-compose up -d

   复制

5. 5克隆源码仓库

   源码方式部署的第一步，必须带 --recurse-submodules 拉取子模块，否则运行会缺依赖。

   git clone --recurse-submodules --depth 1 -b main --quiet https://github.com/yym68686/ChatGPT-Telegram-Bot.git

   复制

6. 6安装依赖

   进入仓库目录后安装 Python 依赖，需 Python 3.10 及以上版本。

   pip install -r requirements.txt

   复制

7. 7配置环境变量

   运行仓库自带脚本生成环境变量配置，按提示填入 BOT_TOKEN、API_KEY、BASE_URL。

   ./configure_env.sh

   复制

8. 8启动机器人

   直接用 Python 运行主程序启动机器人，保持进程常驻即可在 Telegram 中对话。

   python bot.py

   复制

关键配置

如何确认成功

访问宿主机映射端口或云平台分配的域名能看到服务响应，并在 Telegram 中向自己的机器人发一条消息能收到回复。

常见问题

注意事项

• 只支持 OpenAI 格式接口；Anthropic、Gemini、Vertex AI、Azure、AWS、XAI、Cohere、Groq、Cloudflare、OpenRouter 等需先用 uni-api 集成。
• 源码部署要求 Python >= 3.10，克隆时漏掉 --recurse-submodules 会缺少子模块，运行报错。
• 容器内服务端口为 8080，本地映射示例为 80:8080，Koyeb/Replit 等平台请将暴露端口设为 8080。
• 挂载 ./user_configs:/home/user_configs 可持久化用户配置，删除容器不丢数据。