OpenClaw Telegram Setup
This guide covers the exact OpenClaw Telegram setup flow people actually search for: BotFather, botToken, allowFrom, pairing, your first message, and safe group-chat defaults.
You can run OpenClaw on your own hardware, but if you want the fastest route to a reliable 24/7 Telegram assistant, ClawBox is the easy path because the box, storage, and runtime are already prepared.
What you need
A Telegram account, a bot created in BotFather, your OpenClaw instance, and your own Telegram sender ID for allowFrom.
What most guides miss
A valid bot token is not enough. OpenClaw Telegram setup usually fails because pairing was never approved or allowFrom is wrong.
What stays local
Your OpenClaw files, browser sessions, memory, and automation runtime stay on your own hardware. Telegram still handles message delivery.
OpenClaw Telegram setup in 5 steps
Create your bot with BotFather
In Telegram, search for @BotFather and run /newbot. Choose a display name, then choose a username that ends in bot.
BotFather returns the bot token immediately. Save it carefully because this token is the credential OpenClaw uses to talk to Telegram.
Add the Telegram botToken to OpenClaw
Open your OpenClaw configuration or setup flow and paste in the bot token under the Telegram channel settings.
On ClawBox this is the fastest path because the hardware, browser profile, and messaging runtime are already prepared for an always-on assistant.
Set DM access safely with pairing or allowFrom
Keep dmPolicy on pairing or allowlist, then add your Telegram sender ID to allowFrom so only approved accounts can trigger the assistant.
This is the detail many tutorials miss. A working bot token alone is not enough if your sender is not allowed.
Send the first message and approve pairing
Open your bot, send a simple test like hello, and confirm the pairing request if your setup uses pairing mode.
If the bot does not answer, check the token first, then your sender ID, then whether the pairing approval actually completed.
Enable groups carefully
If you want OpenClaw inside Telegram groups or forum topics, keep requireMention enabled so the assistant only replies when you actually call it.
That keeps group chats sane and avoids accidental bot spam while still giving you topic-based routing when you need it.
Recommended OpenClaw Telegram config
Docs and setup reference →If you prefer to understand the moving parts before using the setup wizard, this is the core shape you are aiming for. The important pieces are the botToken, the direct-message policy, and a correct allowFrom entry for your Telegram account.
{
channels: {
telegram: {
enabled: true,
botToken: "your-bot-token",
dmPolicy: "pairing",
allowFrom: ["tg:123456789"],
groups: {
"*": { requireMention: true }
}
}
}
}Keep requireMention on in groups unless you intentionally want the assistant to answer freely in shared chats.
What OpenClaw does on Telegram once setup is finished
Common OpenClaw Telegram problems and fixes
The bot never replies
Verify the bot token first. If the token is correct, check whether your sender ID is present in allowFrom or whether pairing approval is still pending.
Direct messages work, but groups do not
That is usually because group replies are gated behind mentions. Keep requireMention enabled, then mention the bot explicitly when testing.
The wrong person can message the bot
Do not leave Telegram open to the world. Use pairing or allowlist mode and keep allowFrom tight instead of using broad wildcards.
The setup works, but the assistant is unreliable
This is often a hardware uptime problem, not a Telegram problem. A machine that sleeps, reboots, or loses browser state will feel flaky compared with dedicated always-on hardware.
FAQ
How do I create an OpenClaw Telegram bot?
Open Telegram, message @BotFather, run /newbot, choose a display name and username, then copy the bot token BotFather returns. Paste that token into your OpenClaw Telegram channel settings.
What should go in allowFrom for OpenClaw Telegram setup?
Use your Telegram sender ID so only your account can trigger the bot in direct messages. In OpenClaw examples this is commonly written with a tg: prefix, for example tg:123456789.
Why is my OpenClaw Telegram bot not replying?
The most common causes are a wrong bot token, missing or mismatched allowFrom entry, DM pairing not approved yet, or group chats requiring mentions before the bot responds.
Can OpenClaw work in Telegram groups and topics?
Yes. OpenClaw can be used in Telegram groups and topics, but the safest default is to require mentions in groups so the bot does not answer every message.
Do I need ClawBox to use OpenClaw on Telegram?
No. You can run OpenClaw on your own Mac Mini, mini PC, VPS, or other hardware. ClawBox is simply the easiest dedicated 24/7 option because it ships pre-configured.
Related guides that strengthen this setup
If you want the broader install flow, start with the OpenClaw setup guide. If you are still choosing hardware, read the best OpenClaw hardware guide. If you want channel docs and feature references, open the documentation hub.
Best hardware for an always-on Telegram assistant
Telegram is easiest when OpenClaw stays online all day, keeps browser state, and does not depend on a laptop lid staying open. That is the real advantage of dedicated hardware.
Get OpenClaw on Telegram without the usual friction
Jetson hardware, persistent sessions, local storage, and the fastest path to a reliable always-on Telegram assistant.
30-day money-back guarantee