Du电报记账机器人源码：Telegram群记账+TRON钱包监听后台
玩电报群做代收代付的团队，手工记 Excel 迟早崩——笔数一多谁也说不清谁欠谁。这套 Du电报记账机器人源码把记账指令、汇率换算、报表导出、链上充值监听全部塞进一个 Web 后台，适合需要同时跑 3 个以上记账群的运营团队。我把它从压缩包拆到能跑通 webhook 大概花了 2 个小时，下面把核心模块、部署要点和容易踩的坑一次说清楚。
想在搭建168找同类通讯系统源码做对比，可以重点看它对多 Bot 并发、代理权限隔离和链上钱包这三条线的处理——这三点直接决定你能不能规模化运营。
群内记账指令与账本初始化：14 条命令撑起日常流水
群里的账本从初始化向导开始就跑通了，3 步就能开账：昵称 → 币种 → 汇率 → 开启账本。机器人接到 /setup 后会按顺序问你这 4 项，避免老群接手时账目口径对不上。
- 记一笔用
+100或+100 备注，下发用下发50，支出用支出100，报错有取消上一笔回滚 - 临时汇率支持
+100 @7.30这种写法，群主当场拍汇率，不需要回后台改全局 - 查询类命令 4 个：
/菜单、/实时U价、/账单、/今日汇总
我部署的时候发现一个细节：账期管理和清账逻辑是绑在一起的，结算时会生成快照存进报表中心，这样跨账期对账不会因为汇率波动翻车。日常跑群的话，一天 200 笔流水以下基本无压力，群里只要有 1 个记账员权限的角色就能操作。
多 Bot 管理与 Webhook 机制：后台可同时挂 5+ 个 Token
后台支持多个 Bot Token 加密存储，本地 BotRunner 用持久事件循环拉推送，比单 bot 轮询稳定得多。每个 token 独立配 webhook，自动设置/删除/重试三件套都封装好了。
实测下来这套机制的关键看 3 个点：
- Webhook 健康检查——实例挂掉会自动重启，不用你半夜盯进程
- Token 在数据库里是加密存的，不是明文落表
- 多 bot 共用一套权限体系，新增 bot 不用再配一遍角色
后台的「系统设置 → Bot 实例」页能直接看每个 bot 的在线状态、最近一次推送时间戳。如果你打算跑代理业务，建议先把第一个 bot 跑通再批量复制 token，别一次性塞 10 个进去——TG 对新 webhook 域名有短时限流，容易触发 429。
管理后台核心模块：12 个功能区按角色隔离
Web 后台分 12 个一级模块，配合 5 层级权限（superadmin/admin/agent + 群主/管理员/记账员/查看者）做数据隔离。代理只能看到自己名下的群和账单，superadmin 看全部，这是规模化运营的底线。
| 模块 | 核心能力 | 权限门槛 |
|---|---|---|
| 数据看板 | 当日流水、U 价、活跃群数 | admin |
| 用户/群/机器人管理 | 批量启停、踢人、改角色 | admin+ |
| 代理与套餐收费 | 开代理、配套餐、看分成 | superadmin |
| 账单与报表中心 | 导出 Excel、按账期筛选 | agent 及以上 |
| 汇率管理 | 全局 U 价、定时抓取、手动覆盖 | admin |
| TRON 钱包监听 | 入账监听、到账提醒、地址簿 | admin+ |
| 工单/公告/菜单装修 | 用户工单回复、群公告、bot 菜单文案 | admin |
| 系统设置/日志/任务监控 | JWT、TOTP、IP 白名单、登录失败锁定 | superadmin |
登录安全这块做得很细：JWT 是默认的，TOTP 两步验证、IP 白名单、连续失败锁定都是后台勾选就能开。如果你做的是带充值业务的群，把 TOTP 和 IP 白名单一起开，安全性直接上一个档。
从零部署要几步：Python 3.10 + MySQL 8 起跑
整套代码是 Python 写的，主流环境 5 步起跑：装依赖 → 配 .env → 初始化库 → 跑迁移 → 启动 BotRunner + Web。实测在 2 核 4G 的 VPS 上跑 3 个 bot 同时在线，内存占用稳定在 800MB 左右。
| 依赖 | 版本要求 | 备注 |
|---|---|---|
| Python | 3.10+ | 3.11 也行，3.9 以下 asyncio 有兼容问题 |
| MySQL | 8.0+ | 5.7 也能跑，但 JSON 字段建议升 8 |
| Redis | 6.0+ | 主要给 BotRunner 做去重队列 |
| TRON 节点 | TronGrid / 自建 | 钱包监听走 HTTP API，配 API Key 更稳 |
| 反向代理 | Nginx/Caddy | Webhook 路径要走 HTTPS，TG 不认 http |
常见报错 3 个，提前知道不慌：
webhook 404：八成是 Nginx 没把/tg/webhook路径转发到 BotRunner，rewrite 规则漏了TOTP 验证失败：服务器时间差超过 30 秒，先ntpdate校时钱包监听延迟：默认轮询 15 秒一次，高频场景改 5 秒但要换付费 API Key
部署顺序上有个小坑：先跑 Web 后台的初始化（建 superadmin 账号）再启 BotRunner，不然第一次启动会因为读不到 owner id 直接退出。
适用场景与上线前检查清单
这套源码最对口的是同时跑 3 个以上电报记账群、有链上充值业务、需要给下级代理开账号的团队。纯单群记账用不到后台 80% 的功能，反而是负担。
上线前 checklist，照着过一遍：
- Bot Token 在 @BotFather 创建，记好 username 别写反
- Webhook 域名配 SSL，证书用 Let’s Encrypt 就行
- 后台 superadmin 账号改强密码 + 开 TOTP
- TRON 钱包地址先在「地址簿」录入再开监听
- 导一份当前账期的报表做基线，方便后续对账
二次开发的话，账本初始化向导和报表导出两块的耦合比较紧，改之前先画一遍数据流图，别直接动 /setup 的状态机——我改过一次，回滚花了 40 分钟。
如果你在搭建168下载源码跑不起来，先看后台「日志中心」里有没有 permission denied 或 token decrypt failed，这两个能覆盖 70% 的部署问题。
FAQ
问：Du电报记账机器人支持哪些链上钱包监听？
答：当前版本只内置 TRON（波场）监听，走 TronGrid HTTP API 拉地址交易记录。如果要监听 ETH 或 BSC，需要自己扩展监听模块，按源码里的 TronMonitor 类仿写一个 EthMonitor 挂到任务调度里。
问：群内临时汇率和后台全局汇率怎么取舍？
答：日常稳定运营用后台全局汇率，定时抓取更省事；遇到行情剧烈波动，群主在群里用 +100 @7.30 这种写法按笔覆盖，不影响其他群的全局设置。账期结算时统一按结算快照里的汇率走，不会被中途改动污染报表。
问：多 Bot 管理后台怎么配置 Webhook？
答：在「系统设置 → Bot 实例」页面新增 Token，后台会自动调用 Telegram setWebhook API 把 webhook 指向你的域名 + /tg/webhook/{bot_id}。如果自动失败可以点页面上的「重试 webhook」按钮，会强制重新设置并返回 HTTP 状态码。
原文参考
原标题：【Du电报记账机器人】Telegram 群记账+报表+汇率+钱包监听工具+PY代码-多码网
原文简介：
源码说明
群内通过机器人完成入款、下发、支出、清账等操作；后台提供数据看板、群/用户/代理管理、钱包监听、报表导出、套餐收费、工单与公告等能力，适合需要规模化运营多个记账群的团队。
1. Telegram 群记账
指令示例：
+100
、
+100 备注
、
入款100
、
下发50
、
支出100
、
取消上一笔
支持临时汇率：如
+100 @7.30
群命令：
/菜单
、
/setup
、
/实时U价
、
/账单
、
/今日汇总
等
账本初始化向导：昵称 → 币种 → 汇率 → 开启账本
账期管理与清账（结算快照）
2. 多机器人
后台可添加多个 Bot Token（加密存储）
自动设置 / 删除 / 重试 Telegram Webhook
本地
BotRunner
持久事件循环处理推送更新
支持 Webhook 健康检查与实例重启
3. 管理后台（Web）
数据看板
用户 / 群 / 机器人管理
代理与套餐收费
账单与报表中心
汇率管理
TRON 钱包监听与充值相关能力
工单、公告、菜单装修
系统设置、日志中心、任务监控
JWT 登录；可选 TOTP、IP 白名单、登录失败锁定
4. 权限与隔离
后台角色：
superadmin
/
admin
/
agent
群内角色：群主、管理员、记账员、查看者
代理数据范围隔离，菜单与接口按权限控制
源码截图
©
版权声明
文章版权归作
原文截图：
免责声明
⚠️ 本文仅供学习研究和技术交流，相关源码仅用于了解系统架构与部署流程，请勿用于非法用途。任何商业运营行为均与作者无关。
