Skip to content
wireclaw Docs

Connect Telegram

Connect your agent to Telegram so users can interact with it via a Telegram bot.

Prerequisites

Section titled “Prerequisites”
  • A Wireclaw agent (create one if you haven’t)
  • A Telegram account

Setup

Section titled “Setup”

  1. Create a bot with BotFather

    Open @BotFather in Telegram and send /newbot.

    BotFather will ask for:

    • Bot name: Display name (e.g., “My Research Bot”)
    • Bot username: Must end in bot (e.g., my_research_bot)

    BotFather responds with a bot token like:

    123456789:ABCdefGHIjklMNOpqrSTUvwxYZ

    Copy this token.

  2. Add the token in Wireclaw

    Go to Dashboard → Your Agent → Channels → Add Telegram.

    Paste the bot token and click Connect.

  3. Verify the connection

    A green checkmark next to the Telegram channel means it’s connected and ready.

  4. Set allowed users (optional)

    Restrict who can talk to your bot:

    [channels.telegram]
    token = "123456789:ABCdefGHIjklMNOpqrSTUvwxYZ"
    allowed_users = ["@alice", "@bob"]

    If allowed_users is omitted, anyone can message your bot.

Test it

Section titled “Test it”

Open your bot in Telegram (search for @your_bot_username) and send a message. The agent should respond within a few seconds.

Troubleshooting

Section titled “Troubleshooting”
IssueSolution
Bot doesn’t respondCheck agent status is “Running” in Dashboard
”Unauthorized” errorRegenerate the bot token in BotFather (/revoke) and update in Wireclaw
Bot responds slowlyCheck your model choice — faster models like gemini-2.5-flash have lower latency

Next steps

Section titled “Next steps”