setup-telegram

name	setup-telegram
version	1.3.0
description	Check Telegram bot configuration and guide setup if anything is missing.
category	infrastructure
trigger	when user says /setup-telegram, "setup telegram", "configure telegram bot"
tools	["Read"]
tags	["telegram","setup","configuration"]
invoked_by	user
user_invocable	true
error_handling	graceful
verified	true
source	builtin
trust_score	100
provenance_sha	be8990003effcb06

Setup Telegram

Check if the Telegram bot is properly configured by reading config files. Do NOT use Bash — use the Read tool only.

Files to check

Read each of these files and verify the required values:

1. Read .env in the project root. Check for:

   • TELEGRAM_BOT_TOKEN — must exist and be non-empty
   • TELEGRAM_OWNER_ID — must exist (numeric Telegram user ID)
   • CHANNEL_AUTO_START — must be true
   • CHANNEL_PROJECT_ROOT — the absolute path to the project the daemon works with (e.g., C:\dev\projects\agent-studio). Task executors use this as their working directory for git, file, and code operations. If missing, defaults to the daemon's startup directory.
   • TELEGRAM_ALLOWED_USERS — recommended (comma-separated user IDs)
   • ANTHROPIC_API_KEY or CLAUDE_CODE_OAUTH_TOKEN — needed for headless monitor auth

2. Read ~/.claude/channels/telegram/access.json (path: C:\Users\oimir\.claude\channels\telegram\access.json). Check for:

   • allowFrom array with at least one user ID

3. Read ~/.claude/channels/telegram/.env (path: C:\Users\oimir\.claude\channels\telegram\.env). Check for:

   • TELEGRAM_BOT_TOKEN present

4. Read .claude/.mcp.json. Check for:

   • telegram-relay key in mcpServers

Report format

Show a simple checklist:

Telegram Setup Status:
  [x] .env: Bot token configured
  [x] .env: Owner ID: 6521653928
  [x] .env: CHANNEL_AUTO_START=true
  [x] .env: CHANNEL_PROJECT_ROOT=C:\dev\projects\agent-studio
  [x] .env: Allowed users: 6521653928
  [x] .env: Auth token configured (API key or OAuth token)
  [x] Voice: transcribe-anything installed (pip)
  [x] MCP: telegram-relay registered
  [x] access.json: 1 allowed user
  [x] channels/.env: token present

For any [ ] items, tell the user exactly what to add and where.

If both ANTHROPIC_API_KEY and CLAUDE_CODE_OAUTH_TOKEN are missing, tell the user: