1、背景介绍

Telegram 允许开发者构建自己的客户端，其 API 是 100% 开放的。有时候我们不需要开发一个完整的客户端，而只需要基于 API 完成一些定制需求，这类完成特殊需求的定制客户端一般称为 “Telegram Userbot”。

Telegram Userbot 本质上是一种自动化脚本，它以普通用户账号（而非 Bot 账号）连接到 Telegram 的 Client API，这使得 Userbot 能够执行标准 Bot API 无法实现的操作，例如访问私人聊天历史、加入受限群组或模拟用户行为。然而，由于它使用真实用户账号，滥用可能导致账号封禁，因此建议仅用于个人学习和自动化任务。

与标准 Telegram Bot 的区别：

• Bot API：使用 Bot 账号，功能受限（如无法主动加入群组），但易于开发和部署。
• Client API：Userbot 使用此协议，能模拟完整用户体验，但需要 API 凭证且更复杂。

下面的章节将构建一个基本 Userbot，能连接 Telegram、监听消息并响应简单命令。基于我们主要使用 TypeScript 语言，所以本次将使用 GramJS 库作为示例框架。完成本教程后，你将能够自定义 Userbot 以满足特定需求。

2、准备

在开始编写代码前，确保你具备以下知识和工具：

所需知识

• Node.js 基础：了解异步编程、模块导入等。
• TypeScript 基础：熟悉类型注解、接口和编译过程。
• Telegram 基础：拥有一个 Telegram 账号（用于 Userbot 登录）。注意：不要在主要账号上测试，以防封禁风险。

安装工具

1. Node.js：安装版本 18 或更高。从 nodejs.org 下载。
2. npm 或 yarn：Node.js 自带 npm；如果你偏好 yarn，可运行 npm install -g yarn。