๐Ÿ“ฑ
Platform Guide

Clawdbot for Telegram

Telegram is the most popular platform for Clawdbot. Set up your bot in minutes and start chatting with AI right in Telegram.

Telegram Features

๐Ÿ’ฌ

Private Chats

Chat one-on-one with your AI assistant

๐Ÿ‘ฅ

Group Chats

Add Clawdbot to group conversations

๐ŸŽค

Voice Messages

Send voice and get transcribed responses

๐Ÿ–ผ๏ธ

Image Analysis

Send images for AI to analyze

๐Ÿ“Ž

File Sharing

Share documents for processing

โšก

Inline Mode

Use @bot in any chat for quick answers

Setup Guide

1
Create a Telegram Bot
  1. Open Telegram and search for @BotFather
  2. Start a chat and send /newbot
  3. Choose a name for your bot (e.g., "My Clawdbot")
  4. Choose a username ending in "bot" (e.g., "my_clawdbot_bot")
  5. BotFather will give you a token - save it!
Open BotFather โ†’
2
Configure Bot Settings (Optional)

In BotFather, you can customize your bot:

/setdescription - Set bot description

/setabouttext - Set about text

/setuserpic - Upload a profile picture

/setcommands - Set command suggestions

3
Add Token to Clawdbot

Add your bot token to the Clawdbot configuration:

# In your .env file

TELEGRAM_BOT_TOKEN=1234567890:ABC-DEFghij_KLMnop

Replace the token with the one you received from BotFather.

4
Restart and Test

# Restart Clawdbot

docker compose restart

# Or if running natively

npm start

Open Telegram, find your bot, and send a message. You should get a response!

Advanced Configuration

Restrict Access
Only allow specific users

# In .env - comma-separated user IDs

TELEGRAM_ALLOWED_USERS=123456789,987654321

Get your user ID by messaging @userinfobot on Telegram.

Group Chat Support
Enable bot in groups

# In .env

TELEGRAM_ALLOW_GROUPS=true

# Require bot mention in groups

TELEGRAM_REQUIRE_MENTION=true

Custom Commands
Define slash commands

Set up commands in BotFather:

start - Start conversation

help - Show help message

reset - Clear conversation history

model - Switch AI model

Webhook Mode
For production deployments

# In .env

TELEGRAM_WEBHOOK_URL=https://your-domain.com/webhook

TELEGRAM_WEBHOOK_PORT=3000

Webhook mode is more efficient for high-traffic bots.

Tips for Telegram

๐Ÿ’ก

Use Reply for Context

Reply to specific messages to reference them in your conversation with the bot.

๐Ÿ’ก

Send Images for Analysis

Send photos to get AI-powered analysis, OCR, or creative descriptions.

๐Ÿ’ก

Voice Messages Work Too

Send voice messages - they'll be transcribed and processed by the AI.

๐Ÿ’ก

Use /reset to Clear Context

Start fresh by using the reset command when you want a new conversation.