Getting Started
Deploy First Bot
Complete guide to deploying your first Telegram bot on OpenClaw
Deploy Your First Bot
This guide walks you through creating and deploying a fully functional Telegram bot.
Before You Begin
Ensure you have:
- Active OpenClaw account with paid subscription
- Telegram bot token from BotFather
- Clear understanding of your bot's purpose
Create Bot in Portal
- Log into openclaw-portal.restai.vn
- Navigate to "Bots" from main menu
- Click "Add New Bot" button
- Fill in bot details:
- Bot Name - Descriptive name for internal use
- Bot Token - Token from BotFather
- Description - Brief explanation of bot purpose (optional)
Verify Bot Connection
After adding the bot token, OpenClaw will:
- Verify token validity with Telegram
- Retrieve bot username and ID
- Set up webhook endpoint automatically
The webhook URL is automatically configured. No manual setup required.
Configure Bot Skills
Select capabilities for your bot:
Core Skills (All Tiers)
- Message Handler - Process incoming text messages
- Command Parser - Handle slash commands like
/start,/help - Echo Bot - Simple response mirroring for testing
Advanced Skills (Pro & Ultra)
- Conversational AI - GPT-powered natural language understanding
- Context Memory - Remember conversation history
- Multi-language Support - Automatic translation
Premium Skills (Ultra Only)
- Custom Webhooks - Forward messages to external APIs
- Scheduled Messages - Time-based broadcasts
- Analytics Integration - Connect to data warehouses
Set Bot Configuration
Configure behavior settings:
{
"welcome_message": "Hello! I'm your AI assistant.",
"default_language": "en",
"timezone": "UTC",
"rate_limit": {
"messages_per_minute": 20,
"enabled": true
}
}Deploy Bot
- Review all configuration
- Click "Deploy" button
- Monitor deployment status (typically completes in 10-20 seconds)
- Wait for "Active" status indicator
Test Your Bot
- Open Telegram app
- Search for your bot by username
- Send
/startcommand - Verify bot responds correctly
- Test additional commands and messages
Monitoring Deployment
Watch real-time deployment logs in the Portal:
- Webhook Registration - Confirms Telegram webhook setup
- Skill Initialization - Each enabled skill starts up
- Health Check - System validates bot responsiveness
Post-Deployment Checklist
- Test all configured commands
- Verify welcome message displays correctly
- Check message response time (should be under 1 second)
- Review initial analytics data
- Set up monitoring alerts (optional)
Troubleshooting Deployment
Bot Not Responding
- Check bot status in Portal (should show "Active")
- Verify webhook URL in Telegram bot settings
- Review error logs in Portal dashboard
- Ensure subscription is active and payment current
Skill Configuration Issues
If a skill isn't working:
- Confirm skill is enabled in bot settings
- Check skill-specific configuration
- Review compatibility with your subscription tier
- Restart bot deployment
Changes to skills or configuration require redeploying the bot.