Setup Wizard
Clawdbot provides an interactive setup wizard to help you quickly complete initial configuration.
Start the Wizard
clawdbot onboard --install-daemonWizard Steps
1. Authentication Configuration
The wizard first asks about your AI model provider authentication:
API Key Authentication
- Enter your API key directly
- Supports Anthropic, OpenAI, Gemini, etc.
OAuth Authentication (Recommended)
- Authorize via browser OAuth flow
- More secure, supports automatic token refresh
- Recommended for Anthropic Claude
? Select authentication method:
❯ API Key
OAuth (recommended for Anthropic)2. Select Chat Platforms
Choose which chat platforms to enable:
? Select channels to enable:
◉ WhatsApp
◉ Telegram
◯ Discord
◯ Slack
◯ Signal
◯ iMessage3. Platform Configuration
Based on your selections, the wizard guides you through specific platform setup:
- Scan QR code with your phone
- Dedicated phone number recommended
Telegram
- Enter Bot Token (from @BotFather)
- Configure DM policy
Discord
- Enter Bot Token
- Enable required Intents
4. Security Settings
Configure access control policies:
? Default DM policy:
❯ pairing (require approval code)
allowlist (only approved users)
open (allow all)5. Daemon Installation
The wizard asks whether to install the system daemon:
? Install as system service?
❯ Yes (recommended)
NoConfiguration Verification
After completion, the wizard automatically validates configuration:
✓ Configuration validated
✓ Gateway started
✓ WhatsApp connected
✓ Telegram bot online
Your Clawdbot is ready! 🎉Manual Configuration
If you prefer manual configuration, edit the config file directly:
nano ~/.clawdbot/clawdbot.jsonThen run validation:
clawdbot doctorRe-run the Wizard
To reconfigure, run the wizard again:
clawdbot onboardOr configure specific channels only:
clawdbot channels login whatsapp
clawdbot channels login telegramNext Steps
- Dashboard - Manage via web interface
- Channel Configuration - Detailed channel setup guides