ChatGPT-Telegram-Workers

英文 | 中文

轻松在 Cloudflare Workers 上部署属于你自己的 Telegram ChatGPT 机器人。

关于

部署自定义 ChatGPT Telegram 机器人的最简单、最快捷的方式。使用 Cloudflare Workers，单文件直接复制粘贴即可，无需任何依赖，无需配置本地开发环境，也不需要域名，真正实现无服务器部署。

你可以自定义系统初始化信息，确保你调试出的独特个性不会丢失。

示例

特性

• 无服务器部署
• 多平台部署支持（Cloudflare Workers、Vercel、Docker...）
• 适配多种 AI 服务提供商（OpenAI、Azure OpenAI、Cloudflare AI、Cohere、Anthropic、Mistral、DeepSeek、Gemini、Groq...）
• 使用内联键盘切换模型
• 自定义命令（可实现快速切换模型、切换机器人预设）
• 支持多个 Telegram 机器人
• 流式输出
• 多语言支持
• 文本转图像生成
• 插件系统，可自定义插件。

文档

• 部署 Cloudflare Workers
• 本地（或 Docker）部署
• 部署其他平台
• 配置与命令
• 自动更新
• 变更日志

相关项目

• cloudflare-worker-adapter 一个简单的 Cloudflare Worker 适配器，使本项目能够独立于 Cloudflare Worker 运行。
• telegram-bot-api-types Telegram Bot API SDK，编译后无额外输出，文档齐全，支持所有 API。

贡献者

本项目得以存在，离不开所有贡献者的支持。参与贡献。

许可证

ChatGPT-Telegram-Workers 采用 MIT 许可证发布。查看 LICENSE 以获取详细信息。

ChatGPT-Telegram-Workers 快速上手指南

环境准备

本项目主打“无依赖、单文件、Serverless"部署，因此本地开发环境要求极低。

• 系统要求：任意操作系统（Windows, macOS, Linux）。
• 前置依赖：
  • 一个 Cloudflare 账号（免费即可）。
  • 一个 Telegram Bot Token（通过 @BotFather 获取）。
  • 一个 AI 服务 API Key（支持 OpenAI, Azure, DeepSeek, Moonshot 等，详见配置文档）。
  • 无需安装 Node.js、Python 或配置本地服务器环境（若选择纯云端部署模式）。

安装步骤

本指南采用最便捷的 Cloudflare Workers 直接部署 方式，无需克隆代码到本地。

1. 获取源代码 访问项目仓库，复制 src/index.ts (或主逻辑文件) 的全部代码内容。

   提示：该项目为单文件架构，核心逻辑通常集中在一个文件中。

2. 创建 Worker 登录 Cloudflare Dashboard，进入 Workers & Pages 页面，点击 Create Application -> Create Worker。 输入名称（例如 chatgpt-bot），点击 Deploy。

3. 粘贴代码 在新建的 Worker 页面中，点击 Edit Code。 删除编辑器中的默认代码，将第 1 步复制的源代码完整粘贴进去，然后点击 Save and Deploy。

4. 配置变量 (Secrets) 在 Worker 管理页面的 Settings -> Variables and Secrets 中，点击 Add variable，添加以下必要的环境变量（点击 Secure 按钮将其设为加密状态）：

   • TELEGRAM_BOT_TOKEN: 填入你的 Telegram Bot Token。
   • OPENAI_API_KEY: 填入你的 AI 服务商 API Key。
   • OPENAI_BASE_URL: (可选) 如果使用非官方接口（如国内加速节点或中转服务），在此填入对应的 Base URL，例如 https://api.deepseek.com 或 https://api.moonshot.cn。

5. 设置路由 (Webhook) 在浏览器地址栏访问以下 URL 以自动注册 Webhook（请替换为你的 Worker 地址和 Bot Token）：

   https://<YOUR_WORKER_NAME>.<YOUR_SUBDOMAIN>.workers.dev/?token=<YOUR_TELEGRAM_BOT_TOKEN>&action=setWebhook
   

   若返回 {"ok":true,"result":true,...} 则表示设置成功。

基本使用

部署完成后，无需重启服务，配置即时生效。

1. 启动对话 打开 Telegram，搜索你创建的机器人用户名，点击 Start 或发送 /start 命令。

2. 发送消息 直接发送文本消息，机器人将流式返回 AI 的回答。

3. 切换模型 (可选) 如果配置了多个模型，可以通过内联键盘（Inline Keyboard）或自定义命令快速切换。例如发送：

   /model gpt-4o
   

   或者使用预设命令切换人格：

   /preset coder
   

4. 生成图片 (可选) 若后端支持绘图接口，发送带有特定前缀的消息即可触发（具体指令参考 /help）：

   /draw 一只在太空猫
   

提示：更多高级功能（如插件系统、多语言支持、Docker 本地部署）请参考项目文档中的 CONFIG.md 和 LOCAL.md。