214 lines
5.0 KiB
Markdown
214 lines
5.0 KiB
Markdown
# Telegram Bot 管理指南
|
||
|
||
## 📌 概述
|
||
|
||
**唯一运行的脚本**: `integrated_bot_ai.py`
|
||
|
||
这是一个**统一的、完整集成的** Telegram bot，包含所有功能：
|
||
- ✅ AI 对话引导（使用 claude-agent-sdk）
|
||
- ✅ Pyrogram 搜索（镜像 @openaiw_bot）
|
||
- ✅ 自动翻页缓存（SQLite 30天）
|
||
- ✅ 智能按钮生成
|
||
|
||
## 🚀 快速使用
|
||
|
||
### 使用管理脚本（推荐）
|
||
|
||
```bash
|
||
# SSH 到虚拟机
|
||
ssh atai@192.168.9.159
|
||
|
||
# 查看所有命令
|
||
/home/atai/telegram-bot/manage_bot.sh
|
||
|
||
# 常用命令
|
||
/home/atai/telegram-bot/manage_bot.sh status # 查看状态
|
||
/home/atai/telegram-bot/manage_bot.sh start # 启动 bot
|
||
/home/atai/telegram-bot/manage_bot.sh stop # 停止 bot
|
||
/home/atai/telegram-bot/manage_bot.sh restart # 重启 bot
|
||
/home/atai/telegram-bot/manage_bot.sh logs # 查看日志
|
||
/home/atai/telegram-bot/manage_bot.sh info # 显示信息
|
||
```
|
||
|
||
### 手动操作
|
||
|
||
```bash
|
||
# 启动
|
||
cd /home/atai/telegram-bot
|
||
export ANTHROPIC_BASE_URL="http://202.79.167.23:3000/api"
|
||
export ANTHROPIC_AUTH_TOKEN="cr_9792f20a98f055e204248a41f280780ca2fb8f08f35e60c785e5245653937e06"
|
||
export ALL_PROXY="socks5://127.0.0.1:1080"
|
||
screen -dmS agent_bot bash -c 'python3 -u integrated_bot_ai.py 2>&1 | tee bot_agent_sdk.log'
|
||
|
||
# 查看运行状态
|
||
screen -ls
|
||
|
||
# 查看日志
|
||
tail -f bot_agent_sdk.log
|
||
|
||
# 进入 screen 会话
|
||
screen -r agent_bot
|
||
# 退出 screen: Ctrl+A, D
|
||
|
||
# 停止
|
||
screen -S agent_bot -X quit
|
||
```
|
||
|
||
## 📁 文件说明
|
||
|
||
### 🟢 当前使用的文件
|
||
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `integrated_bot_ai.py` | **主bot脚本**（唯一运行） |
|
||
| `claude_agent_wrapper.py` | Claude Agent SDK 包装器 |
|
||
| `manage_bot.sh` | Bot 管理脚本 |
|
||
| `bot_agent_sdk.log` | 运行日志 |
|
||
| `cache.db` | SQLite 缓存数据库 |
|
||
| `user_session.session` | Pyrogram 会话文件 |
|
||
|
||
### 🟡 备份文件（不使用）
|
||
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `integrated_bot_ai_backup_*.py` | 自动备份 |
|
||
| `integrated_bot_ai.backup.py` | 手动备份 |
|
||
|
||
### 🔴 旧版文件（可删除）
|
||
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `agent_bot.py` | 旧版 Agent Bot |
|
||
| `unified_telegram_bot.py` | 旧版统一 Bot |
|
||
| `integrated_bot.py` | 旧版集成 Bot |
|
||
| `bot_without_mirror.py` | 旧版无镜像 Bot |
|
||
|
||
## 🔧 配置信息
|
||
|
||
### 环境变量
|
||
|
||
已配置在 `~/.bashrc`:
|
||
```bash
|
||
export ANTHROPIC_BASE_URL="http://202.79.167.23:3000/api"
|
||
export ANTHROPIC_AUTH_TOKEN="cr_9792f20a98f055e204248a41f280780ca2fb8f08f35e60c785e5245653937e06"
|
||
```
|
||
|
||
### Bot 信息
|
||
|
||
- **Bot名称**: @ktfund_bot
|
||
- **使用SDK**: claude-agent-sdk (Python)
|
||
- **AI模型**: claude-sonnet-4-5-20250929
|
||
- **镜像Bot**: @openaiw_bot
|
||
- **代理**: socks5://127.0.0.1:1080
|
||
|
||
## 🔍 监控与调试
|
||
|
||
### 实时监控日志
|
||
|
||
```bash
|
||
# 监控所有日志
|
||
tail -f /home/atai/telegram-bot/bot_agent_sdk.log
|
||
|
||
# 监控 AI 调用
|
||
tail -f /home/atai/telegram-bot/bot_agent_sdk.log | grep -E 'Claude|Agent|AI'
|
||
|
||
# 监控用户消息
|
||
tail -f /home/atai/telegram-bot/bot_agent_sdk.log | grep -E '用户|消息|搜索'
|
||
|
||
# 监控错误
|
||
tail -f /home/atai/telegram-bot/bot_agent_sdk.log | grep -E 'ERROR|❌|失败'
|
||
```
|
||
|
||
### 检查运行状态
|
||
|
||
```bash
|
||
# 检查 screen 会话
|
||
screen -ls
|
||
|
||
# 检查进程
|
||
ps aux | grep integrated_bot_ai.py
|
||
|
||
# 检查日志最新内容
|
||
tail -50 /home/atai/telegram-bot/bot_agent_sdk.log
|
||
```
|
||
|
||
## 🐛 常见问题
|
||
|
||
### Bot 无响应
|
||
|
||
1. 检查是否运行：`/home/atai/telegram-bot/manage_bot.sh status`
|
||
2. 查看日志错误：`tail -100 /home/atai/telegram-bot/bot_agent_sdk.log | grep ERROR`
|
||
3. 重启 bot：`/home/atai/telegram-bot/manage_bot.sh restart`
|
||
|
||
### AI 调用失败
|
||
|
||
检查环境变量：
|
||
```bash
|
||
echo $ANTHROPIC_BASE_URL
|
||
echo $ANTHROPIC_AUTH_TOKEN
|
||
```
|
||
|
||
如果为空，运行：
|
||
```bash
|
||
source ~/.bashrc
|
||
```
|
||
|
||
### Pyrogram 搜索失败
|
||
|
||
1. 检查代理：`curl --socks5 127.0.0.1:1080 https://api.telegram.org`
|
||
2. 检查会话文件：`ls -l user_session.session`
|
||
|
||
## 📊 系统架构
|
||
|
||
```
|
||
Telegram 用户
|
||
↓
|
||
@ktfund_bot (虚拟机)
|
||
↓
|
||
integrated_bot_ai.py
|
||
├─ Claude Agent SDK → AI 对话
|
||
├─ Pyrogram → 搜索 @openaiw_bot
|
||
├─ SQLite → 缓存管理
|
||
└─ Auto Pagination → 后台翻页
|
||
```
|
||
|
||
## ⚙️ 维护建议
|
||
|
||
### 定期检查
|
||
|
||
- 每天检查 bot 状态：`/home/atai/telegram-bot/manage_bot.sh status`
|
||
- 每周清理旧日志：保留最近30天
|
||
- 每月备份数据库：`cache.db`
|
||
|
||
### 日志管理
|
||
|
||
```bash
|
||
# 查看日志大小
|
||
du -h /home/atai/telegram-bot/bot_agent_sdk.log
|
||
|
||
# 如果日志太大，可以轮转
|
||
cd /home/atai/telegram-bot
|
||
mv bot_agent_sdk.log bot_agent_sdk.log.old
|
||
/home/atai/telegram-bot/manage_bot.sh restart
|
||
```
|
||
|
||
## 🎯 性能优化
|
||
|
||
当前配置已优化：
|
||
- ✅ 使用 SQLite 缓存（30天）
|
||
- ✅ 自动翻页（后台异步）
|
||
- ✅ 对话历史管理（最近5轮）
|
||
- ✅ 智能按钮去重
|
||
|
||
## 📝 更新日志
|
||
|
||
### 2025-10-07
|
||
- ✅ 完成 claude-agent-sdk 集成
|
||
- ✅ 创建统一管理脚本
|
||
- ✅ 虚拟机完全独立运行
|
||
- ✅ 不再依赖 Mac 服务
|
||
|
||
---
|
||
|
||
**注意**：其他所有旧 bot 脚本都已弃用，只需运行 `integrated_bot_ai.py`！
|