不会编程用 AI 做 Telegram 机器人：从零到上线（2026）

/setdescription   设置机器人简介（用户首次打开时看到的说明）
/setabouttext     设置资料卡里的简短介绍
/setuserpic       设置头像
/setcommands      设置命令菜单，用户输入 / 时会自动提示
/token            重新查看 token
/revoke           token 泄露了用这个作废重发

帮我写一个 Telegram 机器人，要求：
1. 用 Python + python-telegram-bot 最新版（v22.x），异步写法
2. 用长轮询（run_polling）接收消息，不用 webhook
3. token 从环境变量 BOT_TOKEN 读取，不要硬编码
4. 支持 /start 命令回复一句欢迎语
5. 收到任何文本消息就原样回复一遍（先跑通链路）
6. 给我一份 requirements.txt 和运行说明

注意：python-telegram-bot v20 之后 API 改动很大，请用 ApplicationBuilder 的新写法，
不要用 Updater / dispatcher 那套旧 API。

import os
from telegram import Update
from telegram.ext import (
    ApplicationBuilder, CommandHandler, MessageHandler,
    ContextTypes, filters,
)

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("你好，我是你的 AI 助手，直接发消息给我就行。")

async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text(f"你说的是：{update.message.text}")

if __name__ == "__main__":
    app = ApplicationBuilder().token(os.environ["BOT_TOKEN"]).build()
    app.add_handler(CommandHandler("start", start))
    app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))
    app.run_polling()

python3 -m venv venv
source venv/bin/activate          # Windows 用 venv\Scripts\activate
pip install -U python-telegram-bot

export BOT_TOKEN="你的token"        # Windows PowerShell 用 $env:BOT_TOKEN="..."
python bot.py

import os
from openai import AsyncOpenAI
from telegram import Update
from telegram.constants import ChatAction
from telegram.ext import ContextTypes

client = AsyncOpenAI(
    api_key=os.environ["LLM_API_KEY"],
    base_url=os.environ.get("LLM_BASE_URL", "https://api.deepseek.com/v1"),
)

async def chat(update: Update, context: ContextTypes.DEFAULT_TYPE):
    # 先发"正在输入"，避免用户以为机器人死了
    await context.bot.send_chat_action(update.effective_chat.id, ChatAction.TYPING)

    # 用 chat_data 保存这个会话的历史，实现多轮对话
    history = context.chat_data.setdefault("history", [])
    history.append({"role": "user", "content": update.message.text})

    resp = await client.chat.completions.create(
        model=os.environ.get("LLM_MODEL", "deepseek-chat"),
        messages=[{"role": "system", "content": "你是一个简洁友好的助手，回答控制在 300 字以内。"}]
                 + history[-10:],   # 只带最近 10 条，防止 token 爆炸
    )
    answer = resp.choices[0].message.content
    history.append({"role": "assistant", "content": answer})

    await update.message.reply_text(answer)

# 设置 Webhook
curl "https://api.telegram.org/bot<你的TOKEN>/setWebhook?url=https://your-worker.workers.dev"

# 查看当前 Webhook 状态和最近的错误（排查神器）
curl "https://api.telegram.org/bot<你的TOKEN>/getWebhookInfo"

# 删掉 Webhook，切回长轮询
curl "https://api.telegram.org/bot<你的TOKEN>/deleteWebhook"

import { Bot, Context, webhookCallback } from "grammy";

export default {
  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
    const bot = new Bot(env.BOT_TOKEN, { botInfo: JSON.parse(env.BOT_INFO) });

    bot.command("start", async (ctx: Context) => {
      await ctx.reply("你好，我是跑在 Cloudflare 上的机器人。");
    });

    bot.on("message:text", async (ctx: Context) => {
      await ctx.reply(`收到：${ctx.message?.text}`);
    });

    return webhookCallback(bot, "cloudflare-mod")(request);
  },
};

npm create cloudflare@latest my-tg-bot
cd my-tg-bot
npm install grammy

# token 存成加密 secret，不会出现在代码里
npx wrangler secret put BOT_TOKEN

# 部署
npx wrangler deploy

# 拿到 workers.dev 域名后，注册 webhook
curl "https://api.telegram.org/bot<你的TOKEN>/setWebhook?url=https://my-tg-bot.<你的子域>.workers.dev"

sudo tee /etc/systemd/system/tgbot.service > /dev/null <<'EOF'
[Unit]
Description=Telegram Bot
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/home/ubuntu/mybot
EnvironmentFile=/home/ubuntu/mybot/.env
ExecStart=/home/ubuntu/mybot/venv/bin/python bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

sudo systemctl daemon-reload
sudo systemctl enable --now tgbot
sudo systemctl status tgbot        # 看运行状态
journalctl -u tgbot -f             # 实时看日志，排查必用