Telegram - profClaw

profClaw’s Telegram integration creates a bot that responds to messages in private chats, groups, and supergroups. Supports both webhook and long-polling connection modes.

Capabilities

Feature	Supported
Private chats	Yes
Group chats	Yes
Supergroups	Yes
Inline keyboards	Yes
File/media messages	Yes
Commands	Yes (`/command`)
Webhook mode	Yes
Long-polling mode	Yes

Setup

Create a bot with BotFather

Open Telegram and message @BotFather:

/newbot
# Follow prompts to set name and username
# BotFather gives you a token: 1234567890:ABCdef...

Configure profClaw

TELEGRAM_BOT_TOKEN=1234567890:ABCdef...

Set webhook (optional)

For webhook mode, also set:

TELEGRAM_WEBHOOK_URL=https://your-domain.com/webhooks/telegram
TELEGRAM_WEBHOOK_SECRET=your-random-secret

If no webhook URL is set, profClaw uses long-polling automatically.

Verify

profclaw doctor --provider telegram

Environment Variables

string

required

Bot token from BotFather. Format: 1234567890:ABCdef...

string

Public webhook URL. If not set, long-polling is used instead.

string

Secret token for webhook verification. Recommended for webhook mode.

Configuration Example

.env (long-polling)
.env (webhook)
settings.yml

TELEGRAM_BOT_TOKEN=1234567890:ABCdef...
# No webhook URL = auto long-polling

TELEGRAM_BOT_TOKEN=1234567890:ABCdef...
TELEGRAM_WEBHOOK_URL=https://profclaw.example.com/webhooks/telegram
TELEGRAM_WEBHOOK_SECRET=my-secret-token

chat:
  telegram:
    bot_token: "${TELEGRAM_BOT_TOKEN}"
    webhook_url: "${TELEGRAM_WEBHOOK_URL}"
    webhook_secret: "${TELEGRAM_WEBHOOK_SECRET}"

Bot Commands

Set up commands in BotFather for better UX:

/ask - Ask a question
/run - Run a skill
/status - Check status
/help - Show help

Usage in Groups

Add the bot to a group and it responds when:

Directly mentioned: @your_bot_name What is...
Bot commands used: /ask What is...

For private groups, ensure the bot has message read permissions.

Notes

Long-polling is simpler for development and doesn’t require a public URL.
Webhook mode is recommended for production - lower latency and no missed messages.
Telegram’s Bot API supports MarkdownV2 formatting for rich responses.
Group bots require explicit permission to read all messages (or use commands only).

Chat Providers Overview - Compare all 27 supported channels
WhatsApp - Business messaging via Meta’s Cloud API
Signal - End-to-end encrypted messaging alternative
profclaw channels - Enable and test the Telegram connection from the CLI

​Capabilities

​Setup

​Environment Variables

​Configuration Example

​Bot Commands

​Usage in Groups

​Notes

​Related

Capabilities

Setup

Environment Variables

Configuration Example

Bot Commands

Usage in Groups

Notes

Related