基于Codex开发的电报群管机器人
-
TG-Go-BOT
早期以Hermes开发,后期通过Pi和Codex迭代,用五个群进行了测试,对比目前的其他机器人,反垃圾广告强很多,配置了AI作为最后无法识别的兜底。
Telegram 群组治理机器人、Control API 和 Vue 3 管理控制台。
项目包含三部分:
Go 机器人执行面:消息审核、规则判定、投票、处罚、申诉、白名单和 Agent 对话。
本机 Control API:提供模块能力、配置、运行状态、模型中心和 Agent 契约。
Vue 3 管理控制台:通过认证 BFF 管理群组、规则、模型和运行观测。
特性
分层审核管线:归一化、规则、行为、相似度、模型和人工复核协同工作。
有界并发、持久化副作用队列、重试和运行观测,避免 Telegram API 波动阻塞收包。
群组策略、白名单、申诉和处罚状态统一由机器人与 Control API 管理。
模型渠道、Agent 场景和服务端密钥通过服务端配置管理;密钥不进入前端或 Git。
管理控制台默认要求认证,开发时也可以显式启用本地不安全模式。
快速开始
要求:Go 1.22+、Node.js 20+、npm。git clone https://github.com/coolwolfqs/tg-go-bot.git
cd tg-go-bot
cp .env.example .env
编辑 .env,填入 BOT_TOKEN 和其他本地配置
set -a
. ./.env
set +a
go run ./cmd/bot
构建并启动控制台:cd dashboard
npm ci
npm run build
BOT_DATA_DIR=../data DASHBOARD_ALLOW_INSECURE_LOCAL=1 node server/index.js
生产环境必须设置 DASHBOARD_AUTH_TOKEN、CONTROL_API_TOKEN,并通过 systemd EnvironmentFile、容器 Secret 或其他受控密钥系统注入凭据。不要把 .env、运行时 JSON、日志、聊天数据或模型密钥提交到 Git。 -
"反垃圾广告强很多"
有示例吗? 比如, 哪个广告, 在其它机器人那里判断不出来, 在你这里能判断出来?
