Skip to main content

​
Prerequisites

  • A Telegram account
  • A running Suji instance

​
Create a Telegram Bot

1

Open BotFather

Open Telegram and search for @BotFather, or click the link directly.
2

Create a new bot

Send /newbot to BotFather. Follow the prompts to choose a name and username for your bot.The username must end in bot (e.g., my_sales_bot).
3

Copy the bot token

BotFather will respond with a message containing your bot token. It looks like:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz
Copy this token — you’ll need it in the next step.
Keep your bot token secret. Anyone with the token can control your bot.

​
Connect to Suji

1

Go to your instance

Open your instance in the Suji dashboard and click the Connectors tab.
2

Add Telegram connector

Click Add Connector and select Telegram.
3

Enter the bot token

Paste your bot token in the botToken field.
4

Save

Click Save. The connector status should change to Connected within a few seconds.

​
Verify the Connection

Send a message to your bot on Telegram. If the connection is working, your OpenClaw agent will respond. You can also check the connector status by clicking Sync Status on the Connectors tab.

​
Troubleshooting

  • Make sure the instance is in the Running state
  • Verify the bot token is correct — try regenerating it with BotFather (/revoke)
  • Check the instance logs for error messages
  • The bot token may be invalid or revoked
  • Delete the connector and re-add it with a fresh token
  • Telegram uses long-polling by default, which can add slight latency
  • Check your instance’s CPU/memory metrics — it may need more resources