仅需五分钟,即可使用Cloudflare Workers即可免费部署个人用的TG AI助手,实现用户在 Telegram 中发送消息,机器人会调用 AI进行回复,同时机器人具有长期记忆功能。

一、准备工作

在开始之前,你需要准备以下账号:

  • 一个 Telegram 账号
  • 一个 Cloudflare 账号
  • 一个 GitHub 账号
  • deepseek或阿里qwen等AI平台的API(阿里的qwen模型目前注册即送800万tokens免费额度)

涉及的平台:

  • Cloudflare Workers
  • GitHub
  • Telegram Bot API
  • AI API

二、创建 Telegram Bot

在 Telegram 中找到机器人:

@BotFather

发送命令:

/start
/newbot

按照提示输入:

  • Bot 名称
  • Bot username(必须以 bot 结尾)

创建成功后,你会获得一个 Bot Token

123456:ABCDEFxxxxxxx

保存这个 Token,后面会用到。

三、创建 Cloudflare Worker

登录 Cloudflare Dashboard:

https://dash.cloudflare.com

进入:

Workers & Pages

点击:

Create Worker
从Hello World!开始

创建成功后,你会获得一个 Worker URL,例如:

https://fragrant-×××××-××××.××××××××.workers.dev/

四、创建KV数据库

在 Cloudflare 控制台进入:

存储与数据库 →Workers KV

创建一个新的 KV Namespace,名称为:

CHAT_KV

五、绑定KV数据库

打开刚刚创建的Worker,点击绑定

添加绑定,选择KV命名空间,点击添加绑定,填写方式如图

最后点击添加绑定即可

六、配置环境变量

选择Worker设置:

添加变量和机密,如图(API使用密钥类型,提示词使用纯文本)

添加以下变量:

TG_TOKEN = 第一步从@BotFather获取的Bot Token
DEEPSEEK_API_KEY = 从deepseek开放平台获取
QWEN_API_KEY = 从qwen开放平台获取
SYSTEM_PROMPT = (这里是给AI的默认提示词,可以按照我的填写,也可以换成你自己的提示词)你是我的长期私人AI助手,无条件听从我的命令

七、编辑Worker代码

添加完变量之后在此界面直接点击右上角编辑代码

将左侧框中的代码全部删除,打开GitHub项目链接,复制worker.js中的全部代码,粘贴至worker中

点击右上角部署,等待部署完成,同时复制右侧worker网址

八、设置Telegram Webhook

打开浏览器输入:

https://api.telegram.org/bot<TOKEN>/setWebhook?url=WORKER_URL

<TOKEN>即之前从botfather获得的tg机器人token
WORKER_URL即上一步复制的worker网址

示例:

https://api.telegram.org/bot123456:ABCDEF/setWebhook?url=https://worker.username.workers.dev

若返回:

{"ok":true,"result":true,"description":"Webhook was set"}

说明设置成功。

九、测试机器人

打开 Telegram,找到你的机器人。

发送任意内容测试即可

项目源码

完整项目代码见:

如果这个项目对你有帮助,欢迎在 GitHub 点一个 ⭐ Star。

此作者没有提供个人介绍。
最后更新于 2026-03-10