仅需五分钟,即可使用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:
进入:
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。
Comments NOTHING