kejizhihui/openbot-bot repository overview

┌─────────────────────────────────────────┐
│           bootstrap/ 启动引导层         │
│  launcher.py / web_server.py / cli.py  │
└─────────────────┬───────────────────────┘
                  │
┌─────────────────▼───────────────────────┐
│             core/ 核心系统层            │
│  client_manager / mtproto_client /     │
│  command_registry / plugin_scanner /   │
│  download_engine / media_scanner /    │
│  web_bridge / context.py               │
└─────────────────┬───────────────────────┘
                  │
┌─────────────────▼───────────────────────┐
│          features/ 插件功能层           │
│  downloader / gfiles / promote /       │
│  group_mgr / task_mgr / help_center /  │
│  devverify / tmp_plugins/              │
└─────────────────────────────────────────┘

# 是否启动Web服务 + 隧道（true=启动，false=纯命令行）
WEB_ENABLED=true
# 日志级别
LOG_LEVEL=INFO
# 时区
TZ=Asia/Shanghai

# BotFather创建的Bot Token
BOT_TOKEN=123456:ABC-DEF...
# my.telegram.org申请的API_ID和API_HASH
API_ID=123456
API_HASH=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 方式一：外部代理（推荐，简单）
PROXY=[http://127.0.0.1:7890](http://127.0.0.1:7890)
# 方式二：内置mihomo代理（不需要外部Clash）
# SUB_URL=https://你的订阅地址
# MIHOMO_ENABLED=1

# 超级管理员（可多个，逗号分隔）
ADMIN_ID=111111111,222222222
# 普通管理员
ADMIN_LIST=333333333

# 全局下载并发数（同时最多下载几个文件）
DL_MAX_CONCURRENT=6
# 批量调度文件数（海量文件时分批）
DL_BATCH_SIZE=50
# 失败自动重试次数
DL_RETRY_COUNT=1
# 下载进度落库间隔（秒）
DL_PROGRESS_INTERVAL=3
# 断网恢复检测间隔（秒）
DL_NETWORK_POLL=3
# 网络等待超时（秒）：断网时任务最多等待多少秒后转"待下载"
DL_NETWORK_MAX_WAIT=600
# 单文件网络错误重试上限
DL_FILE_NET_RETRY=8
# 单文件下载超时（秒）
DL_FILE_TIMEOUT=1800
# 单次MTProto读请求超时（秒）
DL_API_TIMEOUT=30
# 大文件分块并行下载阈值（MB）
DL_CHUNK_MIN_SIZE_MB=20
# 分块数（越大越快，注意Telegram限流）
DL_CHUNK_PARTS=4
# 同时允许几个大文件分块
DL_CHUNK_PARALLEL=1

# 每扫N条消息停顿X秒
DL_SCAN_RATE_EVERY=20
DL_SCAN_RATE_SLEEP=0.3
# 每扫N条加重停顿
DL_SCAN_HEAVY_EVERY=100
DL_SCAN_HEAVY_SLEEP=2.0
# 扫描停止阈值：连续N条已下载即停止
DL_SCAN_STOP_AFTER=50
# 单次/dl指定ID模式的数量上限
DL_MAX_IDS=5000

# 批次窗口（秒）：连续转发的消息在这个窗口内归为同一任务
DL_FORWARD_BATCH_SEC=3.0
# 延迟启动下载（秒）
DL_FORWARD_START_DELAY=4.0

AI_BASE_URL=[https://ark.cn-beijing.volces.com/api/v3](https://ark.cn-beijing.volces.com/api/v3)
AI_API_KEY=ark-xxxxxxxx
AI_MODEL=doubao-seed-2-1-turbo-260628

docker run -d \
  --name openbot \
  --restart unless-stopped \
  --memory="2g" \
  --cpus="2" \
  -p 7777:7777 \
  -v /your/path/.env:/app/.env \
  -v /your/path/sessions:/app/sessions \
  -v /your/path/download:/app/download \
  -v /your/path/logs:/app/logs \
  -v /your/path/data:/app/data \
  -v /your/path/tmp_plugins:/app/tmp_plugins \
  -e TZ=Asia/Shanghai \
  kejizhihui/openbot-bot:latest

services:
  openbot:
    image: kejizhihui/openbot-bot:latest
    container_name: openbot
    restart: unless-stopped
    ports:
      - "7777:7777"
    volumes:
      - ./.env:/app/.env
      - ./sessions:/app/sessions
      - ./download:/app/download
      - ./logs:/app/logs
      - ./data:/app/data
      - ./tmp_plugins:/app/tmp_plugins
    environment:
      - TZ=Asia/Shanghai
    deploy:
      resources:
        limits:
          memory: 2G
          cpus: "2"

docker-compose up -d

features/my_plugin/
├── __init__.py
├── plugin.py          # 主逻辑
├── help.txt          # 帮助说明（自动加载到命令菜单）
└── static/           # Web页面（可选）
    └── my_plugin.html

from telegram import Update
from telegram.ext import CommandHandler, ContextTypes
async def hello(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("你好！我是自定义插件！")
def register(app):
    app.add_handler(CommandHandler("hello", hello))

# 获取MTProto客户端
from core.context import get_mtproto_client
# 获取Bot应用
from core.context import get_application
# 注册Web路由
from core.web_server import add_route
# 写入下载任务队列
from core.web_bridge import add_download_task

# 查看实时日志
docker logs -f openbot
# 重启机器人
docker restart openbot
# 停止机器人
docker stop openbot
# 停止并删除容器
docker stop openbot && docker rm openbot
# 更新到最新版
docker pull kejizhihui/openbot-bot:latest
docker stop openbot && docker rm openbot
# 然后重新运行docker run命令启动