[TradeAI] Kario 系统启动与运维指南
本⽂档包含 Kario 系统各个核⼼模块的启动⽅法、保活策略以及常⻅问题的排查指南。
1. Telegram Bot 启动指南
telegram_bot是系统的核⼼交互端，集成了实时⾏情、定时推送、异动监控和 Binance 交易等功
能。
1.1 启动命令
⽆需使⽤ FastAPI 或 Uvicorn，直接运⾏独⽴的启动脚本：
cd C:\Users\13804\.minimax-agent\projects\Kario python apps\telegram_bot\run.py1.2 预期输出
成功启动后，控制台应输出如下信息：
✅ 已加载 .env
✅ 主 Bot Token: ...xxxx
✅ Binance API 已配置
✅ 命令菜单已设置
✅ Polling 已启动
✅ 定时推送已启动
✅ 盘中异动监控已启动 (30s 扫描)
🟢 Bot 运⾏中... (Ctrl+C 退出)
1.3 进程保活策略 (Windows)
为了确保 Telegram Bot 在崩溃或重启后⾃动恢复，建议使⽤ PM2（Node.js 的进程管理器）或
Windows 计划任务进⾏保活。
⽅案 A：使⽤ PM2（推荐，需安装 Node.js）
# 全局安装 pm2 npm install -g pm2# 启动并命名为 kario_tg_bot pm2 start apps\telegram_bot\run.py --name kario_tg_bot --interpreter python # 设置开机自启 pm2 save pm2 startup⽅案 B：使⽤ PowerShell 守护脚本
创建⼀个名为start_kario.bat的⽂件：
@echo off :loop echo 启动 Kario Telegram Bot... cd C:\Users\13804\.minimax-agent\projects\Kario python apps\telegram_bot\run.py echo Bot 意外退出，5秒后重启... timeout /t 5 goto loop2. Web Market 后端 API 启动指南
Web Market 后端服务提供了供前端⻚⾯（包括 Telegram Web App）调⽤的 API，同时也是统⼀
数据层的 HTTP 出⼝。
2.1 启动命令
cd C:\Users\13804\.minimax-agent\projects\Kario python apps\web_market\server.py 或使⽤ Uvicorn： uvicorn apps.web_market.server:app --host 0.0.0.0 --port 80002.2 预期输出
🚀 Kario Web Market API 启动: http://0.0.0.0:8000•
✅ 市场数据缓存预热完成
2.3 进程保活策略
同样可以使⽤ PM2 进⾏管理：
pm2 start apps\web_market\server.py --name kario_web_api --interpreter python pm2 save3. 环境变量 (.env ) 配置检查清单
在启动之前，请确保.env⽂件中包含以下关键配置：
4. 常⻅问题排查 (FAQ)
Q1: Telegram 按钮点击后⼀直转圈？
A: 本次更新已加⼊即时 ACK 机制（tg_answer_callback）。如果仍然转圈，请检查⽹络是否能够正
常访问 Telegram API，或查看控制台是否有报错⽇志。
Q2: Telegram 底部键盘消失？
A: 本次更新已修复该问题。系统会在发送内联键盘（Inline Keyboard）后，⾃动追加⼀条静默消
息来恢复底部持久键盘。如果偶尔丢失，可发送/start或任意⽆法识别的⽂本重新唤出。
Q3: ⽆法获取 X 平台 KOL 情绪数据？
A: 检查.env中的TWITTER_BEARER_TOKEN是否有效。如果未配置，系统会⾃动降级，不影响其
他⾏情和新闻功能。
Q4: 定时推送没有按时发出？
变量名
说明
状态要求
TELEGRAM_BOT_TOKEN_KARIO
主 Bot Token
必填
DEEPSEEK_API_KEY
DeepSeek LLM 密钥
必填
BINANCE_API_KEY
币安 API Key
实盘交易必填
BINANCE_API_SECRET
币安 API Secret
实盘交易必填
TWITTER_BEARER_TOKEN
X 平台 API Token
选填（⽤于 KOL 情绪采集）
BINANCE_WHITELIST
交易⽩名单币种
选填（如BTCUSDT,ETHUSDT）A: 检查run.py启动⽇志中是否包含“定时推送已启动”。本次修复了scheduler.py中的缩进错
误，只要脚本保持运⾏，9:00 / 12:00 / 15:00 / 21:00 将准时推送。