channels

name	channels
description	Telegram and Discord channel integration for the orchestrator. Handles inbound messages as orchestrator commands and pushes mission lifecycle events back.
license	MIT
metadata	{"author":"joey","version":"0.1.0"}

Channels

Bridges external messaging platforms to the nanika orchestrator via Claude Code Channels.

Supported Platforms

• Telegram — see telegram/SKILL.md for inbound message routing rules

Architecture

Two-layer split:

• Inbound: Anthropic's official channel plugin forwards messages into your Claude Code session. This skill teaches Claude to interpret them as orchestrator commands.
• Outbound: The orchestrator daemon pushes mission lifecycle events (started, phase progress, completed, failed) directly to Telegram Bot API. Config at ~/.alluka/channels/telegram.json.

Voice Message Handling

All channel platforms support voice messages. When an audio attachment arrives:

1. Download the attachment via the platform's download tool
2. Transcribe with elevenlabs transcribe --input <path>
3. Treat the transcription as the user's message — route it through normal command handling
4. Confirm what was heard before acting

Supported audio formats: audio/ogg, audio/mpeg, audio/mp4, audio/wav, audio/webm

Requires the elevenlabs plugin to be installed. Gracefully falls back to asking for text if unavailable.

Setup

1. Create a Telegram bot via BotFather
2. Install the official plugin: /plugin install telegram@claude-plugins-official
3. Configure: /telegram:configure <token>
4. Create ~/.alluka/channels/telegram.json:

   {
     "bot_token": "<your-token>",
     "notify_chat_ids": [<your-chat-id>],
     "events": ["mission.started", "mission.completed", "mission.failed", "phase.failed"]
   }
   

5. Launch: claude --channels plugin:telegram@claude-plugins-official