使用 Cloudflare Workers 部署专属于你的 AI 聊天机器人

项目简介

ChatGPT-Telegram-Workers 是一个轻量级的 Telegram AI 聊天机器人，可部署在 Cloudflare Workers 上，单文件、无依赖、免费额度够用

核心特性：

• ✅ 支持多 AI 平台（Cloudflare AI、OpenAI、Azure、DeepSeek、Gemini、Groq 等）
• ✅ 流式输出、多语言支持
• ✅ 插件系统、自定义命令
• ✅ 支持文生图、模型切换

准备工作

1.创建 Telegram Bot

1.打开 Telegram，搜索 @BotFather
2.发送 /newbot 创建机器人
3.按提示设置名称和用户名
4.设置完后，BotFather 会生成 Token，复制保存 Bot Token（类似 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11）

第二步：启用 Cloudflare AI（免费）

1. 激活 Workers AI

Cloudflare AI 免费可用，无需付费计划：

1. 登录 Cloudflare Dashboard
2. 进入 Workers & Pages → AI
3. 点击 Enable AI 激活服务

2. 了解免费额度

Workers AI 免费额度：

• 每天 10,000 neurons（约 100-500 次对话，取决于模型）
• 支持 50+ 开源模型
• 无需绑定信用卡

3. 选择模型

推荐模型（免费额度内可用）：

• @cf/meta/llama-3-8b-instruct - Meta Llama 3 8B（通用对话）
• @cf/meta/llama-3.1-8b-instruct - Llama 3.1 8B（更新版本）
• @cf/qwen/qwen1.5-14b-chat-awq - 通义千问 14B（中文友好）
• @cf/deepseek-ai/deepseek-math-7b-instruct - DeepSeek 数学

完整模型列表：https://developers.cloudflare.com/workers-ai/models/

第三步：部署 Cloudflare Workers

1. 创建 Worker

1. 访问 https://dash.cloudflare.com/?to=/:account/workers
2. 点击 Create a Service
3. 输入 Worker 名称（如 chatgpt-bot）
4. 点击 Deploy

2. 粘贴代码

1. 进入刚创建的 Worker
2. 点击 Quick Edit
3. 打开 https://github.com/tbxark/ChatGPT-Telegram-Workers/blob/master/dist/index.js
4. 复制全部代码，粘贴到编辑器
5. 点击 Save and Deploy

第四步：配置环境变量

1. 创建 KV 命名空间

1. 进入 Workers 首页 → KV
2. 点击 Create a Namespace
3. 输入名字（如 chatgpt-db），点击 Add

2. 绑定 KV 到 Worker

1. 回到你的 Worker → Settings → Variables
2. 找到 KV Namespace Bindings
3. 点击 Edit variables

4. 添加变量：

   • Variable name: DATABASE
   • KV Namespace: 选择刚才创建的 chatgpt-db
5. 点击 Save

3. 添加必需的环境变量

在 Variables and Secrets 部分点击 Add variable，添加以下变量：

获取账户 ID 和 API Token：

1. 账户 ID：Dashboard 右侧栏显示，或访问 https://dash.cloudflare.com/api-tokens

2. API Token：

   • 访问 https://dash.cloudflare.com/profile/api-tokens
   • 点击 Create Token
   • 选择 Edit Cloudflare Workers 模板
   • 权限：Account.Account ID 和 Workers Scripts 设为 Edit
   • 点击 Continue to summary → Create Token
   • 复制保存 Token

可选变量：

第五步：初始化 Webhook

在浏览器访问：

https://chatgpt-bot.yourname.workers.dev/init

替换为你的 Worker 实际域名。

页面显示 Success 即表示：

• ✅ Webhook 已自动绑定
• ✅ 命令已自动注册

使用指南

基本命令

在 Telegram 中与机器人对话：

• /start - 启动机器人
• /new - 开始新对话
• /help - 查看帮助
• /models - 切换模型
• /image - 生成图片
• /reset - 重置对话上下文

群聊支持

如需在群聊中使用，添加环境变量：

GROUP_CHAT_BOT_TOKENS = 你的 Bot Token

常见问题

Q: 机器人没反应？

• 检查 /init 页面是否显示 Success
• 访问 https://api.telegram.org/bot<TOKEN>/getWebhookInfo 查看 Webhook 状态

Q: 提示 AI 调用失败？

• 检查 CLOUDFLARE_ACCOUNT_ID 和 CLOUDFLARE_API_TOKEN 是否正确
• 确认 AI 服务已激活（Workers & Pages → AI）
• 查看 Worker 日志（Workers → 点击 Worker → Logs）

Q: 如何更换 AI 模型？

• 修改 AI_MODEL 为其他可用模型
• 参考：https://developers.cloudflare.com/workers-ai/models/

Q: 费用多少？

• Workers：免费计划每天 10 万次请求
• Workers AI：免费每天 10,000 neurons（约 100-500 次对话）
• 超出后：按量计费，约 $0.0001/1K neurons
• 个人使用：基本免费额度够用

参考链接

• 项目地址：https://github.com/tbxark/ChatGPT-Telegram-Workers
• Cloudflare AI 模型：https://developers.cloudflare.com/workers-ai/models/
• Workers AI 定价：https://developers.cloudflare.com/workers-ai/platform/pricing/
• 配置文档：https://github.com/tbxark/ChatGPT-Telegram-Workers/blob/master/doc/cn/CONFIG.md

提示： Cloudflare Workers + AI 完全免费可用，个人使用无需付费