PLATFORM

AWBotNest

面向 Telegram 的平台型项目，把插件、账号、日志、任务和系统设置统一放进网页控制台，适合长期维护与持续扩展。

PROJECT INTRO

项目介绍

AWBotNest 的核心不是做单个机器人脚本，而是把 Telegram 功能平台化。它把“功能实现”和“平台管理”拆开，让你能通过插件方式增删能力，通过控制台统一管理账号与运行状态。

仓库地址

适用场景

适合谁用

  • 希望通过网页后台管理 Telegram 功能的人
  • 需要持续新增、删除、配置插件的人
  • 不想把所有业务硬写死在一个脚本里的人

核心价值

  • 插件即功能，启停不必整体重启
  • 平台、功能、配置三者分层清晰
  • 适合作为长期演进的平台底座

主要功能

插件市场 多账号登录 网页控制台 日志查看 任务管理 系统设置

平台支持插件安装、插件配置、插件开关、账号登录、日志查看和系统凭据维护。对使用者来说，它更像一套 Telegram 自动化后台，而不是命令行项目。

环境要求

  • 一台可运行 Docker 的 Linux 服务器或 NAS
  • Docker 与 Docker Compose
  • Telegram API_ID、API_HASH、Bot Token
  • 可访问 Telegram 网络环境
  • Web 控制台访问端口，例如 18001

详细搭建方法

  1. 获取项目源码，并进入项目目录。
  2. 确认主机已安装 Docker。没有的话先补齐 Docker 环境。
  3. 检查并编辑 docker-compose.yml，确认映射端口、挂载目录和数据库方案。
  4. 执行 docker compose up -d 启动服务。
  5. 浏览器访问 http://服务器IP:18001 打开控制台。
  6. 使用默认账号 admin / password 登录，立即修改登录密码。
  7. 进入“系统设置 → Telegram 凭据”，填入 API_ID、API_HASH、BOT_TOKEN。
  8. 按项目要求重启或重载平台，让凭据生效。
  9. 进入“账号管理”，按手机号、验证码、两步验证密码完成 Telegram 账号登录。
  10. 进入“插件管理 → 插件市场”，安装需要的插件，并在“我的插件”里手动启用。

部署建议

推荐方案

  • Docker Compose 单机部署
  • 外层用 Nginx/Caddy 做反向代理
  • 把 data/ 目录单独持久化

维护重点

  • 定期备份平台数据与登录状态
  • 插件安装后逐个验证再长期启用
  • 记录 Telegram 凭据与密码变更

常见问题

控制台密码忘了怎么办？

删除 data/auth.json 并重启，系统会恢复默认登录账号和密码。

插件安装后为什么没有立即生效？

插件不会自动启用，需要到“我的插件”里手动打开开关。

平台核心数据在哪？

关键数据通常在 data/ 目录中，备份该目录即可保存配置、会话和插件数据。