用途：管理并监控 Telegram 机器人，重点服务于 claude-orchestrator 机器人，实现多工作区机器人工作流编排与完整进程守护，用于无头（headless）Claude Code 交互场景。
主要能力：提供机器人状态查看、重启、停止与日志查看等管理命令，并支持机器人的生命周期管理（启动/停止/重启）。状态查看会显示 launchd 守护状态、watchexec 进程（PID、运行时长、内存）、机器人进程（PID、运行时长、内存）、完整进程树以及最近日志活动。日志命令会跟踪所有日志，包括 launchd 日志（守护层）与机器人日志（应用层）。由于通过 watchexec 自动重载代码，重启通常并不需要频繁执行。
必要用法：使用 bot-service.sh status 或别名 bot status 查看状态；使用 bot-service.sh logs 或别名 bot logs 查看日志；使用 bot-service.sh restart 或别名 bot restart 重启；使用 bot-service.sh stop 或别名 bot stop 停止。注意：自 v5.8.0 起，生产模式是唯一运行模式。
适用场景：检查机器人状态、重启或排查问题；监控机器人健康与资源占用；查看日志并调试问题；管理机器人生命周期。
限制与常见问题：机器人无响应通常因进程崩溃，可先查看状态再重启；launchd 未启动说明服务未加载，需用 launchctl load 加载；日志为空可能是日志轮转或路径问题，需检查 launchd plist 中的日志路径；watchexec 未重载可能是文件匹配模式不匹配，需检查过滤器模式；内存占用过高可能是机器人代码内存泄漏，需重启并排查 Python 内存使用；权限被拒需执行 chmod +x bot-service.sh；环境变量缺失说明 .env 未加载，需检查 launchd plist 中的环境配置；出现多个机器人实例说明先前实例未停止，需终止所有机器人进程后干净重启。