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.

Quality

86%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Advisory

Suggest reviewing before use

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

Repository: Demerzels-lab/elsamultiskillagent
Commit: 45f9fac

Last updated: 27 days ago
Created: 27 days ago

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.