@amodalai/channel-telegram

Telegram messaging channel plugin for Amodal agents. Lets users interact with their agent via Telegram DM instead of a browser.

Install

pnpm add @amodalai/channel-telegram

Add to amodal.json:

{
  "packages": ["@amodalai/channel-telegram"],
  "channels": {
    "telegram": {
      "botToken": "env:TELEGRAM_BOT_TOKEN",
      "webhookSecret": "env:TELEGRAM_WEBHOOK_SECRET",
      "allowedUsers": ["env:TELEGRAM_OWNER_ID"]
    }
  }
}

Setup

1. Create a bot via @BotFather and get the bot token
2. Set TELEGRAM_BOT_TOKEN in your .env
3. Set TELEGRAM_WEBHOOK_SECRET to a random string (optional but recommended)
4. Set TELEGRAM_OWNER_ID to your Telegram user ID (find via @userinfobot)
5. Register the webhook: amodal channels setup telegram --url https://your-domain.com
6. Start the server: amodal dev

Config

| Field | Required | Description | |-------|----------|-------------| | botToken | Yes | Bot API token from @BotFather | | webhookSecret | No | Secret for webhook verification | | allowedUsers | No | Array of Telegram user IDs. If omitted, all senders accepted. |