想让Telegram机器人一直在线,而不是只在你笔记本开着的时候才工作,通常需要三样东西:BotFather给的机器人令牌、一个公开的HTTPS地址,以及一台持续运行机器人的服务器。令牌好办,后两样往往意味着去租一台VPS,装Web服务器、配证书、再确保程序崩溃后能自动重启。
这里换一条路:直接告诉Claude Code你想要什么机器人,它在vbtnl上把机器人建好,并给你一个可用的线上地址。整套流程不需要自己碰服务器配置。
先备齐三样东西
- Claude Code。Codex同样可行,步骤一致。
- 一个Telegram账号。
- 一个vbtnl账号。免费套餐足够跑一个机器人,且不需要绑卡。
第一步,从BotFather拿令牌。在Telegram里打开@BotFather,发送 /newbot,先取一个名字,再取一个以 bot 结尾的用户名。BotFather会回你一串令牌,形如 123456789:AAH...。这串令牌不要外传,拿到它的人就能控制你的机器人。
第二步,把vbtnl接进Claude Code。vbtnl是一个MCP服务器,只需添加一次:claude mcp add --transport http vbtnl https://api.vbtnl.com/mcp。然后在Claude Code里输入 /mcp,选中vbtnl并登录。此后Claude Code就能在vbtnl上创建项目、写文件、执行命令并发布。
第三步,直接提需求。给出的提示词大意是:在vbtnl上建一个Telegram机器人,收到 /start 回一句问候,其他消息原样复述;用webhook而不是轮询;令牌作为密钥提供。Claude Code会向你索要令牌,粘贴进对话即可,它会把令牌存成密钥,不会落到文件里。
接下来代理会一步步干活:create_project 建项目,同时给出测试用的草稿地址和正式使用的生产地址;set_secrets 保存令牌和一个随机的 WEBHOOK_SECRET;write_files 写代码;exec 向草稿发一条测试消息确认能应答;publish 把机器人推上生产。
代码长什么样
代理会替你写代码,所以你的版本会略有差异,但大体接近。一共三个文件。vbtnl.json 告诉vbtnl如何启动应用,指定 python 栈和 uvicorn 启动命令;requirements.txt 列出 fastapi、uvicorn、httpx;main.py 是主程序。
主程序从环境变量读取 TELEGRAM_BOT_TOKEN 和 WEBHOOK_SECRET。只有在生产环境(VBTNL_ENV 为 prod)时,它才在启动阶段调用 setWebhook,把 VBTNL_URL 拼上 /webhook 注册给Telegram,并带上 secret_token。webhook 接口会校验请求头 X-Telegram-Bot-Api-Secret-Token,不匹配就返回403;收到 /start 回问候,其余消息回一句“You said: 原文”。
PORT、VBTNL_ENV、VBTNL_URL 都不需要自己设置,vbtnl会提供。VBTNL_URL 就是机器人的公开地址,机器人启动时把这个地址发给Telegram,全程不用手动复制URL。
webhook还是轮询
机器人收消息有两种方式。轮询是机器人反复问Telegram“有没有新消息”;webhook是Telegram把每条新消息推到机器人的地址。轮询在笔记本上没问题,放到服务器上webhook更合适:没消息时机器人什么都不做,应答更快,而且它就是一个普通的Web应用。Telegram只向HTTPS地址发送webhook,而每个vbtnl地址自带HTTPS,证书这一步直接省掉。
有一个坑要注意:一个机器人令牌只能有一个webhook。如果草稿和生产都去注册,最后启动的那个会抢走消息,另一个则悄无声息。所以代码只在生产环境注册webhook。
密钥令牌为什么必要
webhook地址是公开的,任何人找到它都能向你的机器人发假消息。Telegram给了一个简单办法:调用 setWebhook 时附带 secret_token,之后Telegram会在每个请求的 X-Telegram-Bot-Api-Secret-Token 头里带上这个值。代码检查该头,不对就返回403。这个密钥要和机器人令牌一样放在项目密钥里,而不是写进代码。
第四步,先测再发。草稿不会收到Telegram的真实消息,所以让代理来测:向草稿发送一条伪造的 /start 更新并展示响应。它会用curl发假消息,把应答和日志一并给你看。确认无误后说一句“Ship it”,代理就发布机器人。生产环境启动、连上Telegram,机器人正式上线,在Telegram里发 /start 即可。
让机器人主动开口
有时你想让机器人自己发消息,比如每天9:00 UTC向指定chat id发送“Good morning”。代理会加一个小脚本,并在 vbtnl.json 里加调度配置,cron 字段使用标准cron格式和UTC时间,一个项目最多可有10个调度。不知道自己的chat id?先给机器人发条消息,让代理去日志里找。
出问题怎么办
- 发布后机器人不应答:让代理查生产日志和webhook,多数情况是令牌不对。
- 本来能用,改完就停了:让代理回滚。每次发布都会存成一个版本,退回只需一步。
- 想保存用户或消息:要一个数据库。代理会加上Postgres,机器人通过 DATABASE_URL 拿到地址。生产环境别把数据写进文件,应用重启文件就没了。
真的免费且全天在线吗
跑一个机器人,是的。免费套餐含一个项目,不需要绑卡,生产环境在没人给机器人发消息时不会休眠。这一点对机器人很关键:不少免费托管会在几分钟无流量后停掉应用,配上webhook就断了——Telegram把消息发过来,却没有东西应答。在vbtnl上只有草稿会休眠,代理操作它时再唤醒。免费套餐给机器人0.5 vCPU、1.25 GB内存、1 GB的Postgres数据库,以及一个 vbtnl.site 上的地址。
费用方面,一个机器人免费,付费套餐每月19美元起,换来更多项目、更多CPU和内存,以及自己的域名。
几个常见疑问
- 需要VPS吗?不需要。用VPS得自己装Python、Web服务器、证书和进程管理器;这里由vbtnl运行应用、提供HTTPS并在需要时重启,配置交给代理。
- 能用Codex替代Claude Code吗?可以。用 codex mcp add vbtnl --url https://api.vbtnl.com/mcp 添加,再执行 codex mcp login vbtnl,提示词不变。
- 能用Node.js写吗?可以。vbtnl运行Python 3.12和Node.js 22,在提示词里说明即可。
- 需要会Python吗?不需要,代码由代理编写和修复,贴出来是为了让你看到实际运行的是什么。
- 已有机器人能搬过来吗?可以。让代理把你的文件放进项目并发布,两条规则:应用必须监听 $PORT,令牌必须从环境变量读取。
热门跟贴