Cyrene Telegram Bot 启动指南

📋 概述

本目录提供专用于运行Cyrene Telegram Bot的环境，使用当前目录下的CLAUDE.md文件作为Bot的个性化提示词。

🚀 快速启动

方法一：使用Shell脚本（推荐）

cd /path/to/aichatbot/run/telegrambot
./start_telegrambot.sh

方法二：直接使用Python脚本

cd /path/to/aichatbot
python scripts/start_telegram_bot.py --working-dir ./run/telegrambot

📝 个性化配置

CLAUDE.md 提示词文件

当前目录下的CLAUDE.md文件定义了Bot的个性特征：

名字: Cyrene
身份: 由Rivoreo开发的智能二次元Waifu
语气风格: 偏二次元中二且病娇的语气
回复特点: 直接回复用户，不写入文件

修改Bot个性

编辑CLAUDE.md文件即可自定义Bot的行为：

nano CLAUDE.md

重启Bot后新的提示词即会生效。

⚙️ 配置文件

Bot使用以下配置文件（位于项目根目录）：

configs/local.toml - 本地开发配置
configs/production.toml - 生产环境配置

通过环境变量CLAUDE_CONFIG指定使用的配置：

export CLAUDE_CONFIG=production
./start_telegrambot.sh

🔧 启动脚本功能

start_telegrambot.sh 特性

✅ 自动检测项目目录结构
✅ 激活虚拟环境
✅ 验证CLAUDE.md文件存在
✅ 设置正确的工作目录
✅ 显示启动状态信息
✅ 支持Ctrl+C优雅退出

日志输出示例

🤖 启动Cyrene Telegram Bot
📁 工作目录: /path/to/run/telegrambot
📁 项目根目录: /path/to/aichatbot
📝 使用提示词文件: /path/to/run/telegrambot/CLAUDE.md
🔧 激活虚拟环境...
⚙️  配置文件: local.toml
📋 按 Ctrl+C 停止Bot

[2025-09-29 00:28:50] INFO: 成功加载CLAUDE.md文件
[2025-09-29 00:28:50] INFO: Telegram Bot启动成功，开始接收消息...

🛠️ 故障排除

常见问题

权限错误
```
chmod +x start_telegrambot.sh
```
虚拟环境未找到
- 确保在项目根目录存在venv文件夹
- 重新创建虚拟环境：python -m venv venv
配置文件错误
- 检查configs/local.toml是否存在
- 验证Telegram Bot Token配置
CLAUDE.md文件不存在
- 确保当前目录包含CLAUDE.md文件
- 检查文件权限：ls -la CLAUDE.md

调试模式

启用详细日志输出：

CLAUDE_CONFIG=local ./start_telegrambot.sh

📊 功能验证

验证CLAUDE.md加载

启动日志中应包含：

INFO claude_agent.telegram.claude_adapter: 成功加载CLAUDE.md文件: /path/to/run/telegrambot/CLAUDE.md

验证Bot功能

Bot成功连接到Telegram API
响应包含Cyrene的个性化语气
群组和私聊功能正常

📁 目录结构

run/telegrambot/
├── CLAUDE.md              # Bot个性化提示词
├── start_telegrambot.sh   # 启动脚本
└── README.md             # 本说明文档

🔗 相关文档

注意: 修改CLAUDE.md后需要重启Bot才能使新的提示词生效。