Telegram Integration

YX Poon

Modified on: Mon, 6 Apr, 2026 at 4:21 PM

Create a Telegram Bot.
1. Open Telegram and search for the official BotFather account (look for the blue verified checkmark).
2. Start a chat and use the command /newbot.
3. Follow the prompts to provide a display name and a unique username (which must end in "bot").
4. BotFather will provide you with an API Token; copy this token.
Add the Token to OpenClaw.
1. Log in to your OpenClaw web interface or access its terminal on your VPS.
2. Navigate to the channels configuration section for Telegram and paste the copied token. You might also be able to type a message to OpenClaw such as "here's the token for my new bot" in its chat interface if you have web UI access.
Pair the Bot and Approve Pairing.
1. In Telegram, search for your new bot by its username and click Start or send it any message (e.g., "hello").
2. OpenClaw will send a message back containing your Telegram user ID and a pairing code.
3. In your VPS terminal, execute a command to approve the pairing (replace <CODE> with your actual code):
4. ```
openclaw pairing approve telegram <CODE>
```
Verify Connection.

Send a test message to your bot in Telegram (e.g., "hey are you online"). OpenClaw should respond, confirming the integration.