如何 7×24 小时托管 Telegram 机器人

​

简介

​

前置条件

• Square Cloud 账户：通过注册页面使用你的邮箱进行注册。
• 有效套餐：为你的应用提供专属资源和优化的性能。查看我们可用的套餐，选择最适合你需求的方案。

​

创建项目

​

在 Telegram 上创建机器人应用

找到 BotFather

访问 Telegram Web 并搜索官方的 BotFather 机器人，它负责在平台上创建和管理机器人。

获取令牌

与 BotFather 开始一段对话并输入 /start。然后，选择 /newbot 选项来创建一个新机器人。系统会要求你为机器人指定一个名称，确认后，将自动生成所需的身份验证令牌。

​

开发机器人

npm init -y

npm install grammy

const { Bot } = require("grammy");

// The token comes from the TELEGRAM_BOT_TOKEN environment variable
const bot = new Bot(process.env.TELEGRAM_BOT_TOKEN);

// Reply to every text message with an echo
bot.on("message:text", async (ctx) => {
  await ctx.reply(`${ctx.me.username} responds: ${ctx.message.text}`);
});

// Long polling: the bot asks Telegram for new messages, so no public URL is needed
bot.start({
  onStart: (botInfo) => console.log(`Bot ${botInfo.username} started successfully!`),
});

pip install pyTelegramBotAPI

import os

import telebot

# The token comes from the TELEGRAM_BOT_TOKEN environment variable
bot = telebot.TeleBot(os.environ["TELEGRAM_BOT_TOKEN"])
bot_name = bot.get_me().username


# Echo every message that isn't a command
@bot.message_handler(func=lambda message: not message.text.startswith("/"))
def echo_handler(message):
    bot.reply_to(message, f"{bot_name} responds: {message.text}")


if __name__ == "__main__":
    print(f"Bot {bot_name} started successfully!")
    # Long polling: no public URL is needed
    bot.infinity_polling()

pyTelegramBotAPI

​

配置 Square Cloud

DISPLAY_NAME=My Telegram Bot
MAIN=index.js
MEMORY=512
VERSION=recommended
AUTORESTART=true

DISPLAY_NAME=My Telegram Bot
MAIN=main.py
MEMORY=512
VERSION=recommended
AUTORESTART=true

• MAIN 是 Square Cloud 运行的文件，MEMORY 是机器人的内存（单位 MB）。机器人至少需要 256 MB；512 MB 则留有增长空间。
• AUTORESTART=true 会在机器人崩溃时重新启动它。请参阅自动重启的工作方式。
• 没有 SUBDOMAIN：使用长轮询时，机器人不需要公开 URL。

​

设置机器人令牌

• 控制面板：在上传页面打开 Advanced configuration，添加名为 TELEGRAM_BOT_TOKEN 的变量，值为你的令牌。对于已部署的机器人，请在应用的 Environment Variables 页面添加它，然后重启机器人。
• CLI：上传机器人后（参见部署并验证），立即使用 squarecloud app env set 设置它并重启机器人：

squarecloud app env set TELEGRAM_BOT_TOKEN=your_token_here
squarecloud app restart

​

ZIP 中包含什么

• 你的主文件（index.js 或 main.py）和其他源文件。
• package.json 或 requirements.txt。
• squarecloud.app。

​

部署并验证

​

通过控制面板

1

访问上传页面

访问上传页面并上传你的项目 zip 文件。

2

配置你的环境

上传 zip 后，你需要为项目配置名称、主文件或运行时环境以及其他设置。
如果你上传的是 Web 项目，请务必选择 “Web Publication” 并为项目设置子域名。

3

部署你的项目

最后，点击 “Deploy” 按钮，即可将项目托管到 Square Cloud。
部署完成后，你可以在控制面板中监控项目的状态和日志。

4

确认你的应用已上线

首次部署通常在一分钟内完成。在控制面板中，等待你的应用状态显示为运行中，并检查日志中是否有启动错误。
如果你部署的是网站或 API，请在浏览器中打开 https://<your-subdomain>.squareweb.app，你应该能看到应用正常响应。如果你部署的是机器人，发送一条命令确认它已上线。

应用无法启动？请参见故障排除指南，了解最常见的原因和解决方法。

​

通过 CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

测试机器人

​

常见错误

​

Error 409: Conflict: terminated by other getUpdates request

​

Error 401: Unauthorized

​

令牌为空或 KeyError: 'TELEGRAM_BOT_TOKEN'

​

后续步骤

​

联系我们