Skip to content

Telegram

Connect Archon to Telegram so you can interact with your AI coding assistant from any Telegram client.

New identities are created as members. The operator can designate admins with archon user role <id> admin; only a run’s starter or an admin can act on it. See Who can act on a run.

  • Archon server running (archon serve; see Web UI)
  • A Telegram account
  1. Message @BotFather on Telegram
  2. Send /newbot and follow the prompts
  3. Copy the bot token (format: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHI...

To restrict bot access to specific users:

  1. Message @userinfobot on Telegram to get your user ID
  2. Add to environment:
TELEGRAM_ALLOWED_USER_IDS=123456789,987654321

When set, only listed user IDs can interact with the bot. When empty/unset, the bot responds to all users.

TELEGRAM_STREAMING_MODE=stream # stream (default) | batch

For streaming mode details, see Configuration.

Select a registered project by submitting /setproject <name> in the conversation or thread where you want to work. To register a local directory first, submit /register-project [--folder] <name> <path>, then select it; registration alone does not bind the conversation. Projectless questions still work. Selection applies to that conversation, not every channel.

Once scoped, the assistant launches and manages runs through its native tools (Claude, Codex, Pi) or the existing CLI (Copilot/OpenCode). CLI launches are detached and headless, use CLI identity and return a run ID for inspection; they do not deliver progress or results to the originating chat. See Deprecated providers.