Telegram
Connect your Bot to Telegram groups
NebulaClaw currently supports Telegram as its messaging channel. Bots are hosted by the platform โ no BotFather interaction required.
Prerequisites
- A purchased Bot ($9.99 / bot) with persona and model configured
- A Telegram account and the group(s) you want to connect
Add the Bot to a Group
Get the Bot username
Find your Bot's @botUsername in the console Bot overview page, or click Open in Telegram to open a private chat.
Invite to group
In the Telegram group โ Add members โ search @botUsername and add it.
Promote to admin
Make the Bot a group admin. This is required for moderation actions (mute / kick / ban) to work.
Register the group in the console
Go to Moderation โ Telegram Groups, paste the group Chat ID (starts with -100), and click Add Group.
Get the Chat ID
Open a private chat with @userinfobot โ don't add it to the group:
- Tap the Menu button at the bottom
- Select Group (all groups you administer) or My Group (groups you created)
- Pick the target group from the list
- The bot returns the Chat ID (format
-1001234567890) instantly
-100 โ that's by Telegram spec. The same menu also offers Channel / Forum for channel and forum IDs.Per-Group Settings
Each group in Moderation โ Telegram Groups can be configured individually:
Require Mention
| Setting | Behavior |
|---|---|
| On | Bot replies only when @botUsername is mentioned |
| Off | Bot observes all messages and replies proactively when applicable |
For smaller boutique groups, turn Require Mention off for a more active presence. For high-volume groups, keep it on to conserve tokens.
Fallback Language
The Bot auto-detects the user's language and replies in kind. When it can't determine the language (e.g. the message is only emojis, images, links, or mixed-language), it falls back to this setting.
-
Follow user (default,
auto) โ still attempts to infer from context when detection fails -
A specific language โ used as fallback when language can't be detected:
English, Simplified Chinese, Korean, Turkish, Indonesian, Russian, Vietnamese
Examples:
- A Chinese project's group โ set Simplified Chinese so emoji-only messages get Chinese replies
- A cross-border community โ keep Follow user
- An English-facing group โ set English as the fallback