ChatGPT-Telegram-Workers

一键部署 Telegram AI 机器人，免服务器，低成本

ChatGPT-Telegram-Workers 是一个将 ChatGPT 接入 Telegram 的开源解决方案，核心目标是让用户以极低的成本、极简的步骤部署自己的 Telegram 机器人。它基于 Cloudflare Workers 等无服务器平台，也支持 Vercel、Docker 等部署方式，解决了传统自建机器人需要维护服务器、配置复杂、成本高的问题。项目核心能力包括：支持多用户隔离、上下文记忆、自定义提示词、白名单管理、流式回复、图片生成（DALL-E）等。通过简单的环境变量配置，用户即可在 Telegram 中与 GPT 模型对话，并支持多模型切换（如 GPT-4、Claude 等）。项目采用 TypeScript 编写，代码结构清晰，文档完善，适合个人开发者快速搭建私有 AI 助手，也适合团队内部使用，数据可控且部署灵活。

开源 free 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3806

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类对话助手

开发团队tbxark

所属国家

官网地址https://chatgpt-telegram-workers.tbxark.workers.dev

GitHubhttps://github.com/tbxark/ChatGPT-Telegram-Workers

定价模式free

价格说明开源项目，MIT许可证，可自行部署到Cloudflare Workers等平台，无内置付费功能。

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型bot,chatgpt,cloudflare,cloudflare-workers,gpt,serverless,telegram,telegram-bot,vercel

GitHub 星标★ 3806

30天Star增速

HF 下载量

上线时间2023-03-03 00:00:00

最近更新2026-09-22 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：云服务 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

一个 Telegram 账号及可用的机器人（用于与 bot 对话）
AI 服务商的 API 凭证（OpenAI / Azure OpenAI / Cloudflare AI / Cohere / Anthropic / Mist
Cloudflare Workers 账号；若改用 Vercel、Docker 或本地部署则需对应平台环境
可访问 Telegram 与所选 AI 服务商的网络环境

安装与启动步骤

1阅读部署文档

README 分别给出了 Cloudflare Workers、本地/Docker、其他平台三份部署文档，先按自己的平台打开对应文档再动手。
2选择部署平台

官方支持 Cloudflare Workers、Vercel、Docker 及本地部署。最省事的是 Cloudflare Workers：单文件、直接复制粘贴、无需域名与本地开发环境。
3部署到所选平台

按所选平台的部署文档操作。Cloudflare Workers 方式为无服务器部署，把项目提供的单文件内容复制粘贴到 Workers 即可，无需安装依赖。
4配置环境变量

按配置文档填写 AI 服务商凭证、Telegram 机器人等环境变量；可同时配置多个 AI 服务商与多个 Telegram 机器人。
5验证对话

部署完成后在 Telegram 中给机器人发消息，确认能收到回复，并可尝试切换模型或使用自定义命令。

如何确认成功

在 Telegram 中向你的机器人发送一条消息，能正常收到 AI 回复即表示部署成功。

常见问题

Q：不想维护服务器怎么办？

A：选择 Cloudflare Workers 无服务器部署即可，无需服务器、无需域名、无需本地开发环境。

Q：支持哪些 AI 服务商？

A：已适配 OpenAI、Azure OpenAI、Cloudflare AI、Cohere、Anthropic、Mistral、DeepSeek、Gemini、Groq 等，详见配置文档。

Q：可以同时用多个机器人或多个模型吗？

A：可以。项目支持多个 Telegram 机器人，并可通过 InlineKeyboard 或自定义命令快速切换模型与预设。

Q：能自定义机器人的性格吗？

A：可以设置系统初始化信息（提示词），让调试好的角色设定持久保留。

注意事项

README 本身未给出具体安装命令，实际操作请以 doc/en/DEPLOY.md、doc/en/LOCAL.md、doc/en/PLATFORM.md 中的说明为准。
环境变量与命令的完整清单见 doc/en/CONFIG.md，插件扩展见 doc/en/PLUGINS.md。
项目提供自动更新能力，说明见 doc/en/ACTION.md（README 中该链接被截断）。

核心亮点

支持 Cloudflare Workers / Vercel / Docker 多种部署方式，灵活适配不同环境
内置多用户隔离与白名单机制，保障私有部署安全
支持流式回复、上下文记忆、自定义提示词，交互体验接近原生 ChatGPT

不足之处

依赖第三方 AI 服务 API，需要自行获取密钥并承担调用费用
文档/社区待观察

适用场景

个人快速搭建私有 Telegram 助手，免维护服务器
团队内部共享 AI 对话工具，通过白名单控制访问
开发者学习 serverless 部署与 Telegram Bot 开发

替代项目

chatgpt-telegram-bot、telegram-chatgpt-bot、gpt-telegram-bot

项目介绍

ChatGPT-Telegram-Workers 是对话助手领域的开源项目，由 tbxark 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（3,806）位列前 30%，在对话助手分类的 907 个项目里位列前 7%。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-22。MIT许可证，可自行部署到Cloudflare Workers等平台，无内置付费功能。

它主要面向的使用场景是：个人快速搭建私有Telegram助手，免维护服务器。同类可对比的替代方案包括 chatgpt-telegram-bot、telegram-chatgpt-bot、gpt-telegram-bot。

上一篇：light-session

下一篇：ChatGPT-Telegram-Bot