telegram-bot-manager

Manage and configure Telegram bots for OpenClaw. Use when setting up Telegram integrations, troubleshooting bot connectivity, configuring bot tokens, or managing Telegram channel/webhook settings. Handles bot registration, token validation, and network connectivity checks for api.telegram.org.

Jump to install

Repository: CraftOS-dev/CraftBot
Last source activity: May 28, 2026 at 10:49
Detected SKILL.md language: English
Stars: 376
Forks: 42

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Back to search Back to installation

name	telegram-bot-manager
description	Manage and configure Telegram bots for OpenClaw. Use when setting up Telegram integrations, troubleshooting bot connectivity, configuring bot tokens, or managing Telegram channel/webhook settings. Handles bot registration, token validation, and network connectivity checks for api.telegram.org.

Telegram Bot Manager

Quick Start

Setup a new Telegram bot

Create bot via BotFather
- Message @BotFather on Telegram
- Use /newbot command
- Follow prompts for bot name and username
- Copy the bot token (format: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz)
Configure in OpenClaw
- Add token to OpenClaw config
- Enable Telegram plugin
- Set up pairing mode for DM access

Validate bot configuration

# Test Telegram API connectivity
curl -I https://api.telegram.org

# Check bot token validity
curl -s "https://api.telegram.org/bot<YOUR_TOKEN>/getMe"

Common Workflows

Troubleshooting connectivity issues

When api.telegram.org is unreachable:

Check network access
```
curl -I -m 10 https://api.telegram.org
```
Verify DNS resolution
```
nslookup api.telegram.org
```
Test alternative endpoints
```
curl -I https://telegram.org
```

Configuring OpenClaw Telegram integration

See OPENCLAW_CONFIG.md for detailed configuration steps.

Bot token security

Never commit bot tokens to version control
Store tokens in environment variables or secure config files
Rotate tokens if compromised
Use different tokens for different environments (dev/prod)

Bot Commands Reference

Common Telegram bot commands for BotFather:

/newbot - Create a new bot
/mybots - Manage your bots
/setdescription - Set bot description
/setabouttext - Set about text
/setuserpic - Set bot profile picture
/setcommands - Set bot commands
/token - Generate new token
/revoke - Revoke current token
/setprivacy - Configure privacy mode

Webhook vs Polling

Webhook (Recommended for production)

Bot receives updates via HTTP POST
Requires public HTTPS endpoint
More efficient for high-volume bots

Polling (Good for development)

Bot continuously checks for updates
Simpler setup, no public endpoint needed
Easier to debug locally

See WEBHOOK_SETUP.md for webhook configuration.

Error Handling

Common errors and solutions

"Connection timed out"

Check firewall rules
Verify proxy configuration
Test with different network

"Invalid token"

Verify token format (should contain colon)
Check for extra spaces or characters
Regenerate token if needed

"Bot not responding"

Verify bot is not blocked
Check bot privacy settings
Ensure bot has proper permissions

Testing Your Bot

Manual testing

Search for your bot username on Telegram
Start a conversation with /start
Test basic commands

Automated testing

Use the test script in scripts/test_bot.py for automated validation.

References