本⽂档包含 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 运⾏中... (CtrlC 退出)1.3 进程保活策略 (Windows)为了确保 Telegram Bot 在崩溃或重启后⾃动恢复建议使⽤ PM2Node.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_KEYDeepSeek LLM 密钥必填BINANCE_API_KEY币安 API Key实盘交易必填BINANCE_API_SECRET币安 API Secret实盘交易必填TWITTER_BEARER_TOKENX 平台 API Token选填⽤于 KOL 情绪采集BINANCE_WHITELIST交易⽩名单币种选填如BTCUSDT,ETHUSDTA: 检查run.py启动⽇志中是否包含“定时推送已启动”。本次修复了scheduler.py中的缩进错误只要脚本保持运⾏9:00 / 12:00 / 15:00 / 21:00 将准时推送。