Telegram

What You'll Need

1. A Telegram account.
2. About 5 minutes.
3. A Clawi/OpenClaw agent in your dashboard.

Step-by-Step Guide

1. Create Your Telegram Bot

Use @BotFather to create a bot.

1. Open Telegram and search for @BotFather.
2. Start a chat and send /newbot.
3. Follow prompts:
   • Display Name: Friendly name (example: My AI Assistant)
   • Username: Must end with bot (example: myaiassistant_bot)
4. Copy the token returned by BotFather (format like 123456789:ABC...).

Keep this token private. Anyone with this token can control your bot.

2. Add Telegram to Your Agent

1. Open My Agents in dashboard.
2. Create a new agent or click Configure on an existing one.
3. In Channels, enable Telegram.
4. Paste the token into Bot Token.
5. Click Save & Connect and wait for restart.

3. Pair Your Telegram Account

1. Search for your bot by username in Telegram.
2. Send any message to the bot.
3. Copy the 6-digit pairing code from the response.
4. In dashboard, click Pairing on your agent card.
5. Enter the pairing code.

Advanced Settings

DM Policy

• Pairing (default): Users must pair with code.
• Allowlist: Only specific user IDs can DM.
• Open: Anyone can DM.
• Disabled: DMs disabled.

Group Policy

Set whether the bot can be added to groups.

Stream Mode

• Off: Full response at once.
• Partial: Stream in chunks (recommended).
• Block: Stream semantic blocks.

Troubleshooting

Bot not responding

• Confirm agent status is Running.
• Verify bot token is correct.
• Restart agent from dashboard.

Pairing code not showing

• Ensure DM Policy is set to Pairing.
• Check whether the user is already paired.
• Wait 30 seconds after restart, then retry.