要在 Square Cloud 上开发和托管 ，遵循一套结构化的配置和前置条件流程至关重要。本技术指南将涵盖整个过程，从初始设置到生产环境部署。
前置条件
- Square Cloud 账户：通过注册页面使用你的邮箱进行注册。
- 有效的付费套餐：为你的应用提供专属资源和优化的性能。查看我们可用的套餐，选择最适合你需求的方案。
创建项目
一个 Telegram 账户对于测试你的机器人并与之交互至关重要。如果你还没有账户，请访问 Telegram 官方网站 免费创建你的账户。
在 Telegram 上创建机器人应用
获取身份验证令牌
与 BotFather 开始一段对话并输入 /start。然后，选择 /newbot 选项来创建一个新机器人。系统会要求你为机器人指定一个名称，确认后，将自动生成所需的身份验证令牌。 关键安全提示：请对你的机器人令牌绝对保密。此令牌授予对机器人的完全控制权，应当作为机密信息对待。
开发项目
选择哪个库或框架取决于你打算使用的编程语言。下面是一些最受欢迎的选项：
Node.js - grammY
Python - telebot
环境搭建
-
确认系统中已安装 Node.js。否则，请从 Node.js 官方网站 下载。
-
初始化一个新的 Node.js 项目：
- 安装 grammY 库：
基础实现
- 创建主文件（
index.js），结构如下：
const { Bot } = require("grammy");
// Authentication token configuration
const token = "YOUR_TOKEN_HERE";
// Bot initialization
const bot = new Bot(token);
(async () => {
// Get bot information
const botInfo = await bot.api.getMe();
const botName = botInfo.username;
// Define handler for text messages
bot.on("message:text", async (ctx) => {
const userMsg = ctx.message.text;
const responseMsg = `${botName} responds: ${userMsg}`;
await ctx.reply(responseMsg);
});
// Start the bot
bot.start();
console.log(`Bot ${botName} started successfully!`);
})();
环境搭建
-
确认已安装 Python 和 pip。否则，请从 Python 官方网站 下载。
-
安装 pyTelegramBotAPI 库：
pip install pyTelegramBotAPI
- 创建主文件（
main.py）：
import telebot
# Authentication token configuration
TOKEN = "YOUR_TOKEN_HERE"
# Bot initialization
bot = telebot.TeleBot(TOKEN)
# Define handler for non-command messages
@bot.message_handler(func=lambda message: not message.text.startswith('/'))
def echo_handler(message):
# Get bot information
bot_info = bot.get_me()
bot_name = bot_info.username
# Format response message
response_msg = f"{bot_name} responds: {message.text}"
# Reply to the user
bot.reply_to(message, response_msg)
# Main execution
if __name__ == '__main__':
bot_info = bot.get_me()
print(f"Bot {bot_info.username} started successfully!")
# Start polling
bot.infinity_polling()
- 创建
requirements.txt 文件来管理依赖：
通过控制面板
配置你的环境
上传 zip 后，你需要为项目配置名称、主文件或运行时环境以及其他设置。
如果你上传的是 Web 项目，请务必选择 “Web Publication” 并为项目设置子域名。
部署你的项目
最后，点击 “Deploy” 按钮，即可将项目托管到 Square Cloud。
部署完成后，你可以在控制面板中监控项目的状态和日志。 通过 CLI
要使用此方法，你需要在项目根目录中创建一个名为 squarecloud.app 的配置文件。该文件将包含项目所需的配置。
了解更多：如何为 Square Cloud 创建配置文件。
squarecloud.app 文件是一个配置文件，用于配置你的应用；它将用于定义你的环境。
安装 CLI
首先，你的环境中需要已安装 CLI。如果尚未安装，请在终端中运行以下命令：npm install -g @squarecloud/cli
Windows
Linux、macOS 和 WSL
curl -fsSL https://cli.squarecloud.app/install | bash
进行身份验证
现在，要进行身份验证并使用其他 CLI 命令，你可以在此处点击 “Request API Key” 找到你的授权密钥。获取授权密钥后，运行以下命令： 上传你的项目
最后，要使用 CLI 将应用部署到 Square Cloud，你需要运行以下命令：或者，如果你手动创建了 zip 文件，可以使用：squarecloud upload --file <path/to/zip>
测试机器人
部署成功后，在 Telegram 上找到你的机器人并发送一条测试消息。机器人应该会回显你的消息作为响应，从而确认实现功能正常。
更多资源
要深入了解 Telegram 机器人开发，请查阅 pyTelegramBotAPI 官方文档。该文档提供了详细的指南、进阶教程和完整的 API 参考。
联系我们
如果你仍然遇到技术问题，我们的专业支持团队可以为你提供帮助。联系我们，我们很乐意协助你解决任何问题。 
