what OpenClaw is. If you have it running, otherwise you may well be about to set it up. This knowledge gets it hooked as much as Telegram so that you’ll keep in touch to it from your phone.
Arrange, nodes, and plugins are inside the OpenClaw medical doctors if you want to have them.
Faster than You Get began
You need:
- OpenClaw installed and the gateway running (
openclaw gateway statuswill have to show it’s reside) - A Telegram account
- About 5 minutes
If OpenClaw isn’t installed however, transfer during the legit set up information first. Come once more proper right here when openclaw gateway status returns clean.
Step 1: Create a Telegram Bot
OpenClaw does no longer use your personal Telegram account. It uses a bot. You create one through Telegram BotFather.

- Open Telegram and search for @BotFather. Be sure that the blue checkmark is there.
- Send
/newbot - BotFather asks for a name. Make a selection something transient and readable, like
My OpenClaw. - BotFather asks for a username. It’ll need to lead to
bot, as an examplemyopenclawbot. - BotFather will provide you with a token that looks like
123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Copy this now. You’ll be able to no longer retrieve it later without regenerating it.
Keep that token to hand. You’re going to stick it into your OpenClaw config next.
Step 2: Configure OpenClaw for Telegram
Open your OpenClaw config file. It lives at ~/.openclaw/config.yaml (or anywhere your setup problems it). Add the Telegram channel block:
channels:
telegram:
enabled: true
botToken: "PASTE_YOUR_TOKEN_HERE"
dmPolicy: "pairing"
groups:
"*":
requireMention: true
What each surroundings does:
enabled: trueturns the Telegram channel onbotTokenis the token BotFather gave youdmPolicy: "pairing"by the use of default simplest people you approve can DM the bot. That’s the safe defaultgroups.*.requireMention: truein crew chats the bot simplest responds when somebody @mentions it. Set tofalseif you want to have it to reply to the whole lot in a host
Save the config. Restart the gateway:
openclaw gateway restart
Step 3: Pair Your Telegram Account
By way of default, OpenClaw blocks unknown consumers from DMing your bot. You need to approve yourself first.
- Open Telegram and send any message in your bot (e.g. “hello”)
- The bot replies with a pairing code, a short lived alphanumeric string
- On your system, run:
openclaw pairing file telegram
openclaw pairing approve telegram
The pairing code expires after 1 hour. If it expires, send each different message to the bot to get a up to date code.
Once paired, you’ll chat along with your OpenClaw bot in an instant in Telegram. Ask it something to make sure it truly works.
Team of workers Chats: Together with the Bot
Want the bot in a host chat? That is how that works.
Add the Bot to Your Team of workers
In Telegram, transfer in your crew, tap the group name, tap “Add people”, and search for your bot username (the one completing in bot that you simply set in BotFather).

Permissions the Bot Needs
Privacy mode is what trips most of the people up. Telegram bots default to privacy mode, as a result of this they are able to simplest see messages that @indicate the bot or are directions. If you want to have the bot to be told all messages in a host, as an example to respond without being @mentioned, disable privacy mode.
To modify privacy mode:
- Cross to BotFather in Telegram
- Send
/setprivacy - Make a choice your bot
- Select Disable. This shall we the bot see all messages in groups
After disabling privacy mode, remove and re-add the bot to each crew for the exchange to take affect.
Making the Bot an Admin
On the other hand, make the bot a host admin. Admin bots bypass privacy mode routinely and can see all messages. This moreover gives the bot ability to pin messages, arrange people, and handle other admin tasks.
For lots of setups, each disable privacy mode OR make the bot an admin, no longer every.
Allow the Team of workers in OpenClaw Config
By way of default, OpenClaw blocks all crew messages excluding you explicitly allow the group. Add the group in your config:
channels:
telegram:
groups:
"-1001234567890": # your crew chat ID
requireMention: false # true = @indicate required, false = respond to all
groupPolicy: "open" # "open" = any person in crew can use it
To get your crew chat ID:
- Add @userinfobot or @getidsbot to the group
- Forward any message from the group to that bot
- It replies with the group chat ID (a longer adverse amount like
-1001234567890)
Or, be informed the ID from the logs:
openclaw logs --follow
Send a message inside the crew while tailing the logs. The chat.id will show the group ID.
Finding Your Telegram Shopper ID
Some configs require your numeric Telegram shopper ID slightly than your username. To look out it:
- DM your bot while running gateway logs:
openclaw logs --follow - Seek for
from.idinside the log output. That amount is your Telegram shopper ID
On the other hand, use the Telegram Bot API in an instant:
curl "https://api.telegram.org/bot/getUpdates"
Your shopper ID displays up inside the from object of the response.
Permissions Outlined
Right here’s a quick breakdown of the permissions and insurance coverage insurance policies you may well be surroundings:
| Setting | What it does | In point of fact useful |
|---|---|---|
dmPolicy: "pairing" |
Simplest approved consumers can DM the bot | Default, keep it |
dmPolicy: "allowlist" |
Simplest specific Telegram shopper IDs can DM | Additional locked down |
dmPolicy: "open" |
Somebody can DM the bot | No longer beneficial |
groupPolicy: "allowlist" |
Simplest configured groups can use the bot | Default, keep it |
groupPolicy: "open" |
Bot responds in any crew it’s in | Use with caution |
requireMention: true |
Bot simplest replies when @mentioned | Default, beneficial |
requireMention: false |
Bot replies to all messages inside the crew | Useful for ambient bot setups |
Holding the Bot Protected
Don’t set dmPolicy: "open" excluding you know the risk. An open DM protection way any person can send directions in your OpenClaw instance. Depending on what your agent can do, this is in a position to let strangers motive equipment, be informed knowledge, or run exec directions.
Use dmPolicy: "pairing" or dmPolicy: "allowlist" for DMs. Pairing way you explicitly approve each shopper. Allowlist way simplest predefined Telegram shopper IDs can get through. For a private bot, pairing is the most straightforward safe variety.
Be careful with crew groupPolicy: "open" and requireMention: false. This mix way any person who supplies the bot to a host can keep in touch to it. If your agent has exec or file get admission to, this is a conceivable attack flooring. Use specific crew allowlisting for the remaining previous relied on groups.
Don’t proportion your bot token. Maintain it like a password. If it leaks, transfer to BotFather right away and regenerate it with /revoke, then change your config.
Team of workers admin bot status gives the bot necessary powers previous merely finding out messages. Simplest make the bot an admin in groups you completely keep watch over.
Keep your OpenClaw gateway up-to-the-minute. Run openclaw change when new permutations land. Protection and feature releases are on the changelog.
Operating the Bot And not using a Public IP
OpenClaw uses long polling by the use of default. Your gateway time and again asks Telegram for new messages. This works behind a space NAT without a public IP or open ports sought after. Telegram on no account reaches your server; your server reaches out to it.
In case you occur to desire webhooks as a substitute, you’ll configure that, however it requires a publicly reachable URL. Long polling is more practical for lots of personal setups.
No longer peculiar Issues
Bot does no longer answer in crew chats:
- Check out if privacy mode continues to be on in BotFather, disable it, and re-add the bot
- Be sure that the group is listed in
channels.telegram.groupsotherwise you’ve were given"*"wildcard - Check out
openclaw logs --followto appear why messages are being dropped
Pairing code expired:
- Send each different message to the bot to get a up to date code
- Codes expire after 1 hour
Bot no longer seeing any messages:
- If
groupsis configured to your config, the group ID should be inside the file (or use"*"to allow all) - Take a look at the bot is actually inside the crew and no longer blocked
What’s Next
Once your bot is working, you’ll:
- Chat along with your OpenClaw agent from anywhere on Telegram
- Add it to crew chats for shared get admission to
- Use
/activation all the timein a host to have it answer without @mentions - Configure talents and power exposed to precise groups or consumers
Check out the OpenClaw medical doctors for channel configuration, multi-agent routing, and complicated Telegram choices like dialogue board topics and inline buttons.
The put up How one can Set Up and Chat With Your OpenClaw Bot on Telegram seemed first on Hongkiat.
Supply: https://www.hongkiat.com/blog/setup-openclaw-bot-telegram/


0 Comments