Bot Management
Create, configure, launch, and manage your Telegram bots
Bot Management
Complete guide to managing your Telegram bots through the OpenClaw Portal.
Creating a Bot
Click Create Bot on the Bots page to open the creation stepper.
Basic Info
Enter your bot's foundational details:
- Bot Name — Display name for your bot
- Description — Brief explanation of the bot's purpose
- Tags — Optional labels for organizing bots
Choose Integration
Select the messaging platform to connect:
- Telegram — Connect via BotFather token
- Additional integrations may be available
Integration Setup
Configure platform-specific settings:
- Bot Token — Paste the token from Telegram BotFather
- OpenClaw validates the token and retrieves bot username
Personality
Define your bot's behavior:
- System Instructions — Custom instructions for how the bot should respond
- Tone and style — Configure the bot's communication personality
After completing the stepper, your bot enters provisioning state while the infrastructure spins up.
Provisioning typically completes in 10-30 seconds. The bot status changes to Active when ready.
Bot List
The Bots page displays all your bots in a responsive grid:
- Bot cards — Name, status badge, description, and tags
- Status indicators — Active (green), Stopped (gray), Error (red), Provisioning (yellow)
- Quick actions — Start/Stop buttons directly on each card
- Refresh button — Manually poll for latest statuses
Bot Detail Page
Click any bot card to open the detail view with a tabbed interface.
Overview Tab
Bot configuration and information:
- Bot name, username, description
- Current status with control buttons
- Configuration details and health status
Chat Tab
Test your bot with a live chat interface directly in the portal.
Chat is an experimental feature for testing bot responses without opening Telegram.
Skills Tab
Manage skills attached to this bot:
- View currently enabled skills
- Add skills from the ClawHub catalog or custom skills
- Remove skills no longer needed
- Changes require a bot restart to take effect
Logs Tab
View real-time platform logs when the bot is running:
- Log streaming with live updates
- Filter by log level
- Useful for debugging bot behavior
Monitoring Tab
Per-bot usage and performance metrics:
- Request and token consumption
- Performance indicators
- Health status over time
Bot Actions
Control buttons available in the bot detail header:
- Start — Launch a stopped bot
- Stop — Gracefully stop a running bot
- Restart — Stop and restart to apply configuration changes
- Delete — Permanently remove the bot (requires typing the VM name to confirm)
Deletion is permanent. All bot configuration, logs, and data will be removed. The Telegram bot token remains valid and can be reconnected.