| name | telegram-bot-management |
| description | Telegram bot production management, monitoring, and troubleshooting. Use when user mentions telegram bot, claude-orchestrator, bot status, bot restart, or bot monitoring. |
Telegram Bot Management
Overview
Multi-workspace Telegram bot workflow orchestration with full supervision (launchd + watchexec). Manages the claude-orchestrator Telegram bot for headless Claude Code interactions.
When to Use This Skill
- Check bot status, restart, or troubleshoot issues
- Monitor bot health and resource usage
- View bot logs and debug problems
- Manage bot lifecycle (start/stop/restart)
Production Mode
As of v5.8.0, production mode is the only operational mode.
Bot Management Commands
Check Status
bot-service.sh status
# Or use alias
bot status
Shows:
- launchd supervision status
- watchexec process (PID, uptime, memory)
- Bot process (PID, uptime, memory)
- Full process tree
- Recent log activity
View Logs
bot-service.sh logs
# Or use alias
bot logs
Tails all logs:
- Launchd logs (supervision layer)
- Bot logs (application layer)
Restart Bot
bot-service.sh restart
# Or use alias
bot restart
Rarely needed due to automatic code reload via watchexec.
Stop Bot
bot-service.sh stop
# Or use alias
bot stop
Reference Documentation
For detailed information, see:
- Operational Commands - Status, restart, logs, monitoring commands
- Troubleshooting - Common issues and diagnostic steps