Clawdbot

Clawdbot is a personal AI assistant that runs locally and connects to multiple messaging platforms via a WebSocket-based Gateway architecture.

⚠️ Work in Progress

This template is under development. Clawdbot is in rapid development, so this template uses the main tag to get the latest version.

✅ Completed

• Gateway starts and accepts WebSocket connections
• Web UI loads via public domain
• Token-based authentication (no device pairing required)
• AI provider authentication (Anthropic API key)
• Chat with AI assistant via Web UI
• Zeabur AI Hub integration
• Telegram bot connection

🔄 Testing

• WhatsApp connection (QR code login)
• Discord bot connection
• Slack integration

---

Recommended Resources

Resource requirements may vary depending on the tools and features you use.

• Shared Cluster: 2000 m (2 vCPU), 2048 Mi (2 GB)
• Dedicated Server: Recommended for better performance

Supported Platforms

• WhatsApp
• Telegram
• Slack
• Discord
• And more messaging platforms

Usage

1. After deployment, a secure Gateway token is automatically generated for you
2. Find the pre-generated URL in the Instructions tab
3. Click the "Web UI (with token)" link to connect directly (token is included in URL)
4. When you see the Clawdbot interface, deployment is complete
5. Go to the Chat page to test if your AI provider is working

For more details, see the official documentation.

Configuration

• ZEABUR_AI_HUB_API_KEY: Your Zeabur AI Hub API key (Recommended). Get your API key here
• ANTHROPIC_API_KEY: Your Anthropic API key for Claude
• OPENAI_API_KEY: Your OpenAI API key (optional, for OpenAI features like memory search, TTS)

Telegram Bot Setup

Getting your bot token from BotFather:

1. Open Telegram and search for @BotFather
2. Send /newbot to create a new bot
3. Follow the prompts to set a name and username for your bot
4. BotFather will send you a token (e.g., 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

Adding the token to Zeabur:

1. Go to your service's Environment Variables tab in Zeabur dashboard
2. Add TELEGRAM_BOT_TOKEN with your bot token
3. Restart the service

Pairing your Telegram account:

1. Send /start to your bot in Telegram
2. The bot will reply with a pairing code (e.g., JN4MSY23)
3. Open Command in Zeabur dashboard to access the container terminal
4. Run: clawdbot pairing approve telegram <code>
5. You'll see: Approved telegram sender <user-id>.
6. Now you can chat with the bot!

Additional Configuration

Beyond environment variables, you can configure Clawdbot using:

Web UI

1. Open the Clawdbot Web UI
2. Go to Settings to configure models, channels, and preferences

Command Line

1. Open Command in Zeabur dashboard
2. Use clawdbot commands to manage providers, models, and settings

Changing the Default Model

The default model is zeabur-ai/gpt-5-mini. To change it:

Via Web UI:

1. Open Settings in Clawdbot Web UI
2. Select your preferred model from the list

Via Command Line:

clawdbot config set agents.defaults.model.primary zeabur-ai/claude-sonnet-4-5

Available models: gemini-3-pro-preview, gpt-5, claude-sonnet-4-5, gemini-3-flash-preview, gpt-5-mini, claude-haiku-4-5, gemini-2.5-flash, deepseek-v3.2

Data Persistence

• /home/node/.clawdbot - Configuration, sessions, and credentials
• /home/node/clawd - Workspace and memory files

Documentation

• GitHub: https://github.com/clawdbot/clawdbot