使用 Node.js 开发 Telegram Bot 完整指南

最新推荐文章于 2025-11-19 14:14:04 发布

原创最新推荐文章于 2025-11-19 14:14:04 发布 · 460 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#node.js #ai

使用 Node.js 开发 Telegram Bot 完整指南

前言

Telegram Bot 是一种自动化程序，可以在 Telegram 平台上与用户进行交互。通过 Telegram Bot API，我们可以创建功能强大的机器人，从简单的问答系统到复杂的自动化工具。本文将详细介绍如何使用 Node.js 从零开始开发一个 Telegram Bot。

什么是 Telegram Bot？

Telegram Bot 是运行在 Telegram 平台上的第三方应用程序，它可以：

自动回复消息：响应用户的文本、图片、文件等
提供交互式界面：使用按钮、内联键盘等组件
执行自动化任务：定时发送消息、监控数据、管理群组等
集成外部服务：连接 API、数据库、支付系统等

常见应用场景：

客服机器人
通知推送系统
投票和问卷调查
游戏和娱乐
群组管理工具

依赖安装

在开始之前，确保你的 Node.js 环境已安装并配置好。接下来，按照以下步骤创建并设置你的 Telegram Bot 项目：

1. 创建 Telegram Bot

打开 Telegram，搜索 @BotFather。
发送 /newbot 命令，按照提示创建一个新 Bot。
获取到 API Token，记录下来。

2. 初始化 Node.js 项目

在你的终端中，执行以下命令来初始化新的 Node.js 项目：

mkdir my-telegram-bot
cd my-telegram-bot
npm init -y

3. 安装必要的库

安装 node-telegram-bot-api 库，用于与 Telegram Bot API 交互：

npm install node-telegram-bot-api

编写 Bot 逻辑

在项目根目录下创建一个 bot.js 文件，并添加以下代码：

// 引入库
const TelegramBot = require('node-telegram-bot-api');

// 使用你的 Bot API Token
const token = 'YOUR_TELEGRAM_BOT_TOKEN'; // 替换为实际的 Token
const bot = new TelegramBot(token, { polling: true });

// 监听 /start 命令
bot.onText(/\/start/, (msg) => {
    const chatId = msg.chat.id;
    bot.sendMessage(chatId, '欢迎使用我的 Telegram Bot！');
});

// 监听 /help 命令
bot.onText(/\/help/, (msg) => {
    const chatId = msg.chat.id;
    bot.sendMessage(chatId, '可以使用以下命令:\n/start - 启动 Bot\n/help - 获取帮助');
});

// 监听文本消息并回复
bot.on('message', (msg) => {
    const chatId = msg.chat.id;
    const userMessage = msg.text;

    // 回复用户发送的消息
    bot.sendMessage(chatId, `你说: ${userMessage}`);
});

// 错误处理
bot.on('polling_error', (error) => {
    console.error(`Polling error: ${error.code}`); // 打印错误信息
});