Telegram

This is a shipped runtime-backed surface: direct sends are implemented, the serve loop is implemented, and the channel can join gateway run or gateway run.

At A Glance

Field	Value
Catalog id	`telegram`
Config key	`telegram`
Implementation status	`runtime_backed`
Transport	`telegram_bot_api_polling`
Aliases	none
Default send target kind	`conversation`

Minimal Config

[telegram]
enabled = true
bot_token_env = "TELEGRAM_BOT_TOKEN"
allowed_chat_ids = [123456789]

Smoke Test

loong channels send telegram --target "123456789" --text "hello from loong"
loong channels serve telegram

Command Surface

Operation	Command	Usage or status
direct send	`channels send telegram`	Usage: loong channels send telegram [OPTIONS] —target <TARGET> —text <TEXT>
reply loop	`channels serve telegram`	Usage: loong channels serve telegram [OPTIONS]

Required Fields For Send

Requirement	Config paths	Env pointer paths	Default env
channel enabled	`telegram.enabled` `telegram.accounts.<account>.enabled`	none	none
bot token	`telegram.bot_token` `telegram.accounts.<account>.bot_token`	`telegram.bot_token_env` `telegram.accounts.<account>.bot_token_env`	`TELEGRAM_BOT_TOKEN`

Required Fields For Serve

Requirement	Config paths	Env pointer paths	Default env
channel enabled	`telegram.enabled` `telegram.accounts.<account>.enabled`	none	none
bot token	`telegram.bot_token` `telegram.accounts.<account>.bot_token`	`telegram.bot_token_env` `telegram.accounts.<account>.bot_token_env`	`TELEGRAM_BOT_TOKEN`
allowed chat ids	`telegram.allowed_chat_ids` `telegram.accounts.<account>.allowed_chat_ids`	none	none

Gateway And Ownership

This surface can run directly through channels serve telegram, or under Gateway And Supervision through gateway run.

Operator Notes

Telegram remains the smallest runtime-backed reply-loop path. Keep allowed_chat_ids tight and explicit.

Continue to Channel Guides for the full shipped channel matrix.
Continue to Channels for the conceptual surface model.
Continue to Channel Setup for the shared public setup contract.
Continue to Gateway And Supervision when this surface needs longer-lived runtime ownership.

Overview

Get Started

Use Loong

Build On Loong

Reference

Telegram

At A Glance

Minimal Config

Smoke Test

Command Surface

Required Fields For Send

Required Fields For Serve

Gateway And Ownership

Operator Notes

​Telegram

​At A Glance

​Minimal Config

​Smoke Test

​Command Surface

​Required Fields For Send

​Required Fields For Serve

​Gateway And Ownership

​Operator Notes

​Related Docs

Telegram

At A Glance

Minimal Config

Smoke Test

Command Surface

Required Fields For Send

Required Fields For Serve

Gateway And Ownership

Operator Notes

Related Docs