拓宇博客

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

Too子牙
2026-03-04 / 0 评论 / 235 阅读 / 耗时: 110 ms / 正在检测是否收录...
温馨提示:
本文最后更新于2026年03月11日,已超过37天没有更新,若内容或图片失效,请留言反馈。

项目简介

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

核心特性:

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

准备工作

第一步:创建 Telegram Bot

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

第二步:启用 Cloudflare AI(免费)

Cloudflare AI 免费可用,无需付费计划
2.1 激活 Workers AI
  1. 登录 Cloudflare 控制台
  2. 进入 AI 标签页
  3. 点击 启用 AI 激活服务
2.2 了解 Workers AI 免费额度
2.3 选择模型

推荐文本生成模型(免费额度内可用):

  • @cf/zai-org/glm-4.7-flash - GLM-4.7-Flash(专为超100种语言优化,快速高效,支持多轮工具调用)
  • @cf/openai/gpt-oss-120b - GPT-OSS-120B(OpenAI开放权重的千亿级MoE模型,推理和工具调用能力强,支持代码解释器)
  • @cf/deepseek-ai/deepseek-r1-distill-qwen-32b - DeepSeek-R1-Distill-Qwen-32B(适合深度推理、数学解题、代码生成)
  • @cf/qwen/qwen3-30b-a3b-fp8 - Qwen3-30B-A3B-FP8(适合高并发、通用对话、工具调用)

其他实用模型:

  • @cf/stabilityai/stable-diffusion-xl-base-1.0 - Stable Diffusion XL(图像生成)
  • @cf/openai/whisper-large-v3-turbo - OpenAI Whisper(语音识别)
  • @cf/baai/bge-m3 - BGE-base(做向量搜索用)
  • @cf/meta/llama-guard-3-8b - Llama Guard 3(检测有害内容)
  • @cf/qwen/qwen2.5-coder-32b-instruct - Qwen2.5-Coder-32B(代码生成)

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


第三步:部署 Cloudflare Workers

3.1 创建 Worker
  1. 访问 Workers 和 Pages
  2. 点击 创建 Worker
  3. 输入 Worker 名称(如 chatgpt-bot
  4. 点击 部署
3.2 粘贴代码
  1. 进入刚创建的 Worker
  2. 点击 编辑代码
  3. 打开 https://github.com/tbxark/ChatGPT-Telegram-Workers/blob/master/dist/index.js

  1. 复制全部代码,粘贴到编辑器
  2. 点击 部署

第四步:配置环境变量

4.1 创建 KV 命名空间
  1. 进入 Workers 首页 → KV
  2. 点击 创建命名空间
  3. 输入名字(如 chatgpt-db),点击 添加
4.2 绑定 KV 到 Worker
  1. 回到你的 Worker → 设置变量
  2. 找到 KV 命名空间绑定
  3. 点击 编辑变量
  4. 添加变量:

    • 变量名称: DATABASE
    • KV 命名空间: 选择刚才创建的 chatgpt-db
  5. 点击 保存
4.3 添加必需的环境变量

变量和密钥 部分点击 添加变量,添加以下变量:

变量名说明
TELEGRAM_AVAILABLE_TOKENS你的 Bot TokenTelegram 机器人令牌
CLOUDFLARE_ACCOUNT_ID你的账户 IDCloudflare 账户 ID
CLOUDFLARE_API_TOKEN你的 API 令牌Cloudflare API 令牌
AI_MODEL@cf/meta/llama-3-8b-instruct使用的 AI 模型
获取账户 ID 和 API 令牌:
  1. 账户 ID:控制台右侧栏显示,或访问 https://dash.cloudflare.com/api-tokens
  2. API 令牌

4.4 可选变量
变量名说明
SYSTEM_PROMPT自定义系统提示词
PLUGINS启用插件(如 search,calculator
ALLOWED_USERS限制使用用户 ID,留空则公开

第五步:初始化 Webhook

在浏览器访问:https://chatgpt-bot.yourname.workers.dev/init
替换为你的 Worker 实际域名。
页面显示 Success 即表示:

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

使用指南

基本命令

在 Telegram 中与机器人对话:

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

群聊支持

如需在群聊中使用,添加环境变量:
GROUP_CHAT_BOT_TOKENS = 你的 BotToken


常见问题

Q: 机器人没反应?

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

Q: 提示 AI 调用失败?

  • 检查 CLOUDFLARE_ACCOUNT_IDCLOUDFLARE_API_TOKEN 是否正确
  • 确认 AI 服务已激活(AI)
  • 查看 Worker 日志(Workers → 点击 Worker → 日志

Q: 如何更换 AI 模型?

Q: 费用多少?

  • Workers:免费计划每天 10 万次请求
  • Workers AI:免费每天 10000 neurons(约 1000-2000 次对话)
  • 超出后:按量计费,约 $0.0001/1K neurons
  • 个人使用:基本免费额度够用

参考链接

本文共 1249 个字数,平均阅读时长 ≈ 4分钟
0

打赏

海报

正在生成.....

评论 (0)

语录
取消