Telegram Bot Manager
Apps & Automationtelegram-bot-managerTelegram Bot Manager is an Agent Skill for apps & automation published in the CraftOS-dev/CraftBot repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/CraftOS-dev/CraftBot/blob/HEAD/skills/telegram-bot-manager/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/telegram-bot-manager, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Telegram Bot Manager
Quick Start
Setup a new Telegram bot
-
Create bot via BotFather
- Message @BotFather on Telegram
- Use
/newbotcommand - 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.