# Telegram Bot Management

> Telegram bot production management, monitoring, and troubleshooting. Use when user mentions telegram bot, claude-orchestrator, bot status, bot restart, or bot monitoring.

- Skill: `majiayu000/telegram-bot-management-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/telegram-bot-management-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/telegram-bot-management-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/majiayu000/telegram-bot-management-2

---


# 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

```bash
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

```bash
bot-service.sh logs
# Or use alias
bot logs
```

Tails all logs:
- Launchd logs (supervision layer)
- Bot logs (application layer)

### Restart Bot

```bash
bot-service.sh restart
# Or use alias
bot restart
```

Rarely needed due to automatic code reload via watchexec.

### Stop Bot

```bash
bot-service.sh stop
# Or use alias
bot stop
```

______________________________________________________________________

## Reference Documentation

For detailed information, see:
- [Operational Commands](./references/operational-commands.md) - Status, restart, logs, monitoring commands
- [Troubleshooting](./references/troubleshooting.md) - Common issues and diagnostic steps