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

Troubleshooting