TelePost

语言 / Language: 中文 · English

TelePost 是开源、自托管的 Telegram 频道投稿与审核 Bot，支持私聊、Mini App 和 HTTP API 投稿。用户可上传、预览和编辑内容，管理员可在审核群中处理待审稿件并发布到频道。

主要功能

功能	说明
投稿	支持图片、视频、GIF、音频、文档和纯文字，提交前可预览、编辑，支持匿名与剧透。
审核与发布	在独立审核群中预览、修改、批准或拒绝投稿，支持内容遮罩；可选接入 AI Agent 辅助审核。
Mini App	可选网页界面：用户可浏览、投稿和查询状态，管理员可处理审核队列。
搜索与热榜	关键词与标签搜索、热门内容、个人投稿查询和统计。
定时发布	`/schedule add weekly-hot` 等命令按计划发布热榜内容。
自动化投稿	提供 HTTP API，供脚本和其他程序提交稿件，支持重复请求保护。
重启与恢复	投稿和审核状态持久保存，服务重启后可继续处理未完成的审核。
多 Bot	通过统一入口在同一台机器运行多个 Bot，各自使用独立的频道、审核群、语言和数据目录。

如何工作

查看 Bot 界面

Bot 私聊主菜单

用户在 Bot 私聊或 Mini App 上传内容，在预览中确认标签、标题、简介、链接及匿名、剧透设置后提交。是否进入审核由投稿入口决定：

投稿入口	默认行为
Bot 私聊	确认后直接发布；`CHAT_REVIEW_REQUIRED=true` 时先审核
Mini App	默认先审核；由 `MINIAPP_REVIEW_REQUIRED` 单独控制
HTTP API	固定先提交审核，必须人工批准

默认配置需要独立审核群（REVIEW_CHAT_ID），且不能与发布频道相同。如需私聊投稿也先审核，设置 CHAT_REVIEW_REQUIRED=true；Mini App 的审核行为由 MINIAPP_REVIEW_REQUIRED 单独控制。更多设置见配置参考。

下载与安装

需要一台可持续运行且能访问 Telegram 的电脑或服务器。仅使用 Bot 时可选 Polling 模式，无需域名；Mini App 需要 Webhook 模式和公网 HTTPS。

选择一种安装方式：

方式	适用情况	入口
独立程序	Windows x64、Linux x64、macOS Apple Silicon；无需安装 Python	下载最新版程序
pip	已有 Python 3.10+ 环境	`python -m pip install telepost-bot`
Docker / Compose	服务器或长期部署	Docker / Compose 安装

独立程序下载后加 --setup 运行配置向导；pip 安装后执行 telepost --setup。完整安装、升级与备份步骤见安装指南。

首次使用

创建 Bot：在 @BotFather 创建 Bot 并取得 Token。
准备频道和审核群：将 Bot 设为发布频道的管理员并授予发帖权限，再加入一个独立的私有审核群，确认 Bot 有发送消息的权限。频道 ID 支持 @频道用户名 或 -100 开头的数字 ID；Owner ID 应填写 Bot 所有者的数字 Telegram User ID，不得填写群或频道 ID。
补齐配置并启动：配置向导只收集 Token、频道和 Owner ID，审核群需手动补齐。打开生成的 config.ini，保留已有内容，在 [BOT] 节添加审核群 ID（保存为 UTF-8）：
```
[BOT]
REVIEW_CHAT_ID = -1001234567890
```
将示例 ID 替换为审核群的实际数字 ID。如需私聊投稿也先审核，在同一 [BOT] 节追加 CHAT_REVIEW_REQUIRED = true。Windows 独立程序可双击启动；Linux / macOS 运行对应的 ./telepost-linux-x64 或 ./telepost-macos-arm64；pip 用 telepost。 Docker 用户按安装指南配置环境变量，无需运行向导或编辑 config.ini。
发起第一次投稿：私聊 Bot 发送 /start，点击「📝 开始投稿」或发送 /submit；上传图片、视频、GIF、音频或文件，完成后发送 /done_media 进入预览；纯文字投稿用 /skip_media 跳过上传。在预览中填写标签和文字内容，确认后点击「✅ 确认发布」（开启聊天审核后为「✅ 提交审核」）。发送 /cancel 可取消当前投稿。

全部命令见命令参考。

可选功能

Mini App：在 Telegram 内完成网页投稿、进度查询和审核；需配置 HTTPS 地址及登录密钥。
HTTP API：供脚本和其他程序投稿，支持幂等提交，避免重试产生重复稿件。
AI 辅助审核（MCP）：通过 MCP 连接外部 AI Agent 查看稿件、提供建议。建议使用只读模式；开启写入权限后，程序不强制要求额外的人工确认。
在线阅读：可选启用 TelePress，为 TXT 小说生成 Telegraph 阅读页。

文档

完整文档站：https://redtidev1918.github.io/TelePost/

安装、升级与卸载：安装与部署
配置项、审核默认值与多 Bot：配置参考
投稿、审核及管理命令：命令参考
网页投稿与审核界面：Telegram Mini App
脚本与自动化投稿：HTTP API
常见运行问题：故障排查
本地开发、测试与贡献：贡献指南

Webhook 部署、Fly.io、运维手册与性能容量等文档见文档站。

许可证

MIT License

Metadata

Release files for telepost-bot 2.84.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for telepost-bot 2.84.6
File	Size	Uploaded	Provenance
telepost_bot-2.84.6.tar.gz	1.1 MB	Oct 25, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for telepost-bot 2.84.6
File	Interpreter	ABI	Platform	Reset
telepost_bot-2.84.6-py3-none-any.whl 845.1 kB Oct 25, 2026 With provenance	Python 3	none	any	Details

Total release size: 2.0 MB

Release files / telepost_bot-2.84.6.tar.gz

Download URL	telepost_bot-2.84.6.tar.gz
Size	1.1 MB
Tags	Source
SHA-256 checksum How to use checksums	`19320478e5112af870eafe02f1ff79ca614b34d694435096e3d51648dc7b8ca2`
BLAKE2b-256 checksum How to use checksums	`3dc74b891a5e4e3590808d1abe1f47f11e8412300bd90bf7e222080aff0c2bea`
Upload date	Oct 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/redtidev1918/TelePost
Publishing commit: github.com/redtidev1918/TelePost/tree/cc9374653e1563dbfc621335dafcc109d891bb6a

Workflow

Publishing configuration: github.com/redtidev1918/TelePost/blob/cc9374653e1563dbfc621335dafcc109d891bb6a/.github/workflows/pypi-publish.yml
Publishing logs: github.com/redtidev1918/TelePost/actions/runs/40173811347/attempts/1

Artifact

Subject: telepost_bot-2.84.6.tar.gz
SHA-256 checksum: 19320478e5112af870eafe02f1ff79ca614b34d694435096e3d51648dc7b8ca2 Verifying attestations

Release files / telepost_bot-2.84.6-py3-none-any.whl

Download URL	telepost_bot-2.84.6-py3-none-any.whl
Size	845.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`a507fcd70c5df46c8b81324b6f2a0b5f67b8f343a577d3d7de7199cadeefcbd3`
BLAKE2b-256 checksum How to use checksums	`9e9d8d52858296b605cb9c100599b961b40644de83ca68a2979575a06b894abd`
Upload date	Oct 25, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/redtidev1918/TelePost
Publishing commit: github.com/redtidev1918/TelePost/tree/cc9374653e1563dbfc621335dafcc109d891bb6a

Workflow

Publishing configuration: github.com/redtidev1918/TelePost/blob/cc9374653e1563dbfc621335dafcc109d891bb6a/.github/workflows/pypi-publish.yml
Publishing logs: github.com/redtidev1918/TelePost/actions/runs/40173811347/attempts/1

Artifact

Subject: telepost_bot-2.84.6-py3-none-any.whl
SHA-256 checksum: a507fcd70c5df46c8b81324b6f2a0b5f67b8f343a577d3d7de7199cadeefcbd3 Verifying attestations

Security for telepost-bot 2.84.6

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for telepost_bot-2.84.6.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/redtidev1918/TelePost
Publishing commit: github.com/redtidev1918/TelePost/tree/cc9374653e1563dbfc621335dafcc109d891bb6a

Workflow

Publishing configuration: github.com/redtidev1918/TelePost/blob/cc9374653e1563dbfc621335dafcc109d891bb6a/.github/workflows/pypi-publish.yml
Publishing logs: github.com/redtidev1918/TelePost/actions/runs/40173811347/attempts/1

Artifact

Subject: telepost_bot-2.84.6.tar.gz
SHA-256 checksum: 19320478e5112af870eafe02f1ff79ca614b34d694435096e3d51648dc7b8ca2 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.