SkillHub

telegram-bot-manager

v1.0.0

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.

Sourced from ClawHub, Authored by OpenClaw

Installation

Please help me install the skill `telegram-bot-manager` from SkillHub official store. npx skills add 362224222/telegram-bot-manager

Telegram Bot Manager

Quick Start

Setup a new Telegram bot

  1. Create bot via BotFather
  2. Message @BotFather on Telegram
  3. Use /newbot command
  4. Follow prompts for bot name and username

  5. Copy the bot token (format: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz)

  6. Configure in OpenClaw

  7. Add token to OpenClaw config
  8. Enable Telegram plugin
  9. 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:

  1. Check network access bash curl -I -m 10 https://api.telegram.org

  2. Verify DNS resolution bash nslookup api.telegram.org

  3. Test alternative endpoints bash 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

  • 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

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

Automated testing

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

References

  • Telegram Bot API Documentation
  • BotFather Documentation
  • OpenClaw Configuration Guide