现代化 Telegram UserBot 开发框架
TypeScript · 插件热加载 · TeleBox / Next 双版本 · 官方插件商店
TeleBox 是以个人 Telegram 账号运行的 UserBot 框架（不是 Bot API 机器人）。核心能力拆成可插拔插件，内置 TPM 插件商店，一条命令即可搜索、安装、更新社区插件。
- 语言：TypeScript · 运行时：Node.js 24
- 许可证：主框架 LGPL-2.1（插件以各自仓库声明为准）
- 两条产品线：TeleBox（成熟稳定）与 Next（下一代实现），装好后可用
.switch go互切
- 模块化插件：动态加载、热重载；命令别名、消息监听、定时任务
- 在线商店（tpm）：
.tpm search/.tpm i/.tpm update，官方插件仓 100+ 扩展 - 权限与安全：sudo / sure、受限 Shell、会话与 API 凭据本地保管
- 运维友好：PM2 后台、
.update/.autofix、系统状态与日志工具 - 双版本切换：TeleBox ↔ Next，会话转换 + 配置迁移
| TeleBox | Next | |
|---|---|---|
| 仓库 | TeleBox | TeleBox-Next |
| 插件仓 | TeleBox-Plugins | TeleBox-Next-Plugins |
| 定位 | 更成熟、资料与插件生态最全 | 下一代、原生异步架构 |
| Telegram API | Teleproto | mtcute |
| 默认目录 / PM2 | ~/telebox · telebox |
~/telebox-next · telebox-next |
拿不准就选 TeleBox；需要新架构或跟 Next 演进可选 Next。
| 仓库 | 说明 |
|---|---|
| TeleBox | TeleBox 主框架与内置系统插件 |
| TeleBox-Next | Next 主框架（Telegram API：mtcute） |
| TeleBox-Plugins | TeleBox 官方插件仓库 |
| TeleBox-Next-Plugins | Next 官方插件仓库 |
| TeleBox-Scripts | 本机 / Docker 一键安装与管理脚本 |
| quote-api | 引用贴纸等相关 quote API |
一键脚本（安装时可选 TeleBox 或 Next）：
wget https://raw.githubusercontent.com/TeleBoxOrg/TeleBox-Scripts/refs/heads/main/Install/telebox.sh -O telebox.sh && chmod +x telebox.sh && bash telebox.shDocker 版见 TeleBox-Scripts。
更完整的说明：
- TeleBox 安装：INSTALL.md
- Next 安装：INSTALL.md
- 开发规范：TELEBOX_DEVELOPMENT.md（Next 仓库内亦有对应文档）
Node.js 24 · TypeScript 5.9 · Teleproto（TeleBox）/ mtcute（Next）· better-sqlite3 / lowdb · Sharp · axios · cron · tsx
欢迎提交插件、修复与文档。请阅读组织内 CONTRIBUTING.md，并在对应仓库按规范开 PR。
安全问题请通过 GitHub Security → Report a vulnerability 私下反馈，勿公开可利用细节。
主框架 LGPL-2.1；各插件与附属仓库以各自 LICENSE 为准。
Made with ❤️ by the TeleBox Team
