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.
Prerequisites
Section titled “Prerequisites”- Archon server running (
archon serve; see Web UI) - A Telegram account
Create Telegram Bot
Section titled “Create Telegram Bot”- Message @BotFather on Telegram
- Send
/newbotand follow the prompts - Copy the bot token (format:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz)
Set Environment Variable
Section titled “Set Environment Variable”TELEGRAM_BOT_TOKEN=123456789:ABCdefGHI...Configure User Whitelist (Optional)
Section titled “Configure User Whitelist (Optional)”To restrict bot access to specific users:
- Message @userinfobot on Telegram to get your user ID
- Add to environment:
TELEGRAM_ALLOWED_USER_IDS=123456789,987654321When set, only listed user IDs can interact with the bot. When empty/unset, the bot responds to all users.
Configure Streaming Mode (Optional)
Section titled “Configure Streaming Mode (Optional)”TELEGRAM_STREAMING_MODE=stream # stream (default) | batchFor streaming mode details, see Configuration.
Project selection
Section titled “Project selection”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.
