Connect Bot to OpenClaw
Integrate your Telegram bot token with OpenClaw platform
Connect Bot to OpenClaw
Once you have your bot token from BotFather, connect it to OpenClaw for instant deployment.
Access Bot Management
- Log into openclaw-portal.restai.vn
- Navigate to "Bots" section from main menu
- Click "Add New Bot" button
Enter Bot Details
Fill in the bot connection form:
Bot Name (Internal)
Display name for your reference in the Portal dashboard. Can be different from Telegram username.
Example: "Customer Support Bot"
Bot Token
Paste the complete token from BotFather:
123456789:ABCdefGHIjklMNOpqrsTUVwxyz123456789Ensure no extra spaces or line breaks when pasting the token.
Description (Optional)
Brief note about bot purpose or environment (production, staging, testing).
Verify Connection
Click "Connect Bot" button. OpenClaw will:
- Validate Token - Verify token format and authenticity
- Fetch Bot Info - Retrieve username, ID, and name from Telegram
- Test API Access - Confirm bot responds to basic commands
- Display Confirmation - Show bot details and connection status
Connection typically completes in 2-5 seconds.
Review Bot Information
After successful connection, verify these details:
- Username - Should match BotFather username (e.g.,
@your_bot) - Bot ID - Unique numeric identifier from Telegram
- Connection Status - Should show "Connected"
- Webhook Status - Initially "Not Configured" (set up in next step)
Troubleshooting Connection Issues
Invalid Token Error
Cause: Token format incorrect or bot deleted
Solution:
- Verify token copied completely from BotFather
- Check for extra characters or spaces
- Confirm bot still exists in BotFather
- Generate new token if necessary
Connection Timeout
Cause: Network issues or Telegram API temporarily unavailable
Solution:
- Check your internet connection
- Wait 1-2 minutes and retry
- Check Telegram Status for outages
Bot Already Connected
Cause: Bot token already in use by another OpenClaw account or integration
Solution:
- Verify you're logged into correct OpenClaw account
- Check if bot connected to different project
- If migrating, disconnect from previous service first
Each bot token can only be active on one platform at a time.
Security Considerations
Token Storage
OpenClaw stores bot tokens:
- Encrypted at rest using AES-256
- Encrypted in transit via TLS 1.3
- Never logged in plaintext
- Accessible only to authorized platform services
Access Controls
- Only account owner can view or modify bot settings
- API requests require authentication
- Audit logs track all bot configuration changes
Token Rotation
To rotate your bot token:
- Generate new token via BotFather (
/token→ "Revoke current token") - Update token in OpenClaw Portal immediately
- Old token becomes invalid instantly
- Bot reconnects automatically with new token
Managing Multiple Bots
OpenClaw supports multiple bots per account based on your subscription tier:
- Basic: Up to 5 bots
- Pro: Up to 20 bots
- Ultra: Unlimited bots
Each bot operates independently with separate:
- Configuration and skills
- Message logs and analytics
- Webhook endpoints
- Usage tracking
Next Steps
With your bot connected: