AI ASSISTANT
Clawdbot Setup Guide: Your Personal AI Assistant for Any Platform 🦞
Clawdbot is a personal AI assistant you run on your own devices. It answers you on WhatsApp, Telegram, Slack, Discord, Signal, iMessage, and more—with voice support, live Canvas, and full control over your data.
What is Clawdbot?
Clawdbot is a personal AI assistant that you run on your own devices. Unlike cloud-based AI services, Clawdbot gives you full control—it connects to the messaging channels you already use (WhatsApp, Telegram, Slack, Discord, and more) and responds as your personal AI assistant.
Built by Peter Steinberger and the open-source community, Clawdbot supports multiple AI providers including Anthropic (Claude) and OpenAI. The project has over 31,000 stars on GitHub and is actively maintained with regular releases.
- Multi-Channel: Works on WhatsApp, Telegram, Slack, Discord, Signal, iMessage, Microsoft Teams, Google Chat, and more
- Self-Hosted: Run on your own devices—your data stays with you
- Voice Support: Voice Wake and Talk Mode for hands-free interaction
- Live Canvas: Agent-driven visual workspace for rich interactions
- Multi-Agent Routing: Route different channels to isolated agents
- Companion Apps: Native macOS menu bar app, iOS and Android nodes
Why Choose Clawdbot?
Unlike cloud AI services, Clawdbot runs on your hardware. Your conversations, context, and data never leave your control.
- Self-hosted on your devices
- No third-party data storage
- Full privacy control
- Local-first architecture
Chat with your AI assistant on the platforms you already use daily. No new apps to install—just message your assistant.
- WhatsApp, Telegram, Discord
- Slack, Microsoft Teams
- Signal, iMessage (macOS)
- Google Chat, Matrix, WebChat
Personal Use
- Personal AI assistant on your phone
- Quick Q&A via messaging apps
- Voice-activated tasks
- Always-on availability
Power Users
- Multi-agent workflows
- Custom skills and tools
- Browser automation
- Cron jobs and webhooks
Prerequisites & Requirements
- Node.js: Version 22 or higher (required)
- OS: macOS, Linux, or Windows (WSL2 strongly recommended)
- pnpm: Recommended if building from source
- macOS: Xcode/CLT if building companion apps
- Anthropic: API key or Claude Pro/Max subscription (OAuth)
- OpenAI: ChatGPT/Codex subscription (OAuth) or API key
- Recommended: Anthropic Pro/Max + Opus 4.5 for best results
- Optional: Brave Search API key for web search
WSL2 (Ubuntu recommended) is strongly recommended for Windows. Native Windows is untested and has poorer tool compatibility. Install WSL2 first, then run all commands inside WSL.
Installation Guide
The recommended approach is to use the CLI onboarding wizard, which sets up everything automatically.
Step 1: Install the CLI
Install via the official installer script:
# macOS / Linux
curl -fsSL https://clawd.bot/install.sh | bash
# Windows (PowerShell) - then use WSL2
iwr -useb https://clawd.bot/install.ps1 | iex
# Alternative: npm/pnpm global install
npm install -g clawdbot@latest
# or
pnpm add -g clawdbot@latestStep 2: Run the Onboarding Wizard
The wizard guides you through gateway setup, auth, channels, and daemon installation:
clawdbot onboard --install-daemonThe wizard will help you configure:
- Local vs Remote gateway mode
- Auth: OpenAI Codex subscription (OAuth) or API keys
- Providers: WhatsApp QR login, Telegram/Discord tokens, etc.
- Daemon: Background service (launchd/systemd)
- Gateway token: Auto-generated for security
Step 3: Verify the Gateway
# Check gateway status
clawdbot gateway status
# Run gateway manually (foreground)
clawdbot gateway --port 18789 --verbose
# Quick health check
clawdbot status
clawdbot healthOnce the gateway is running, access the Control UI dashboard at http://127.0.0.1:18789/
Key Features & Capabilities
- WhatsApp (via Baileys)
- Telegram (via grammY)
- Slack (via Bolt)
- Discord (via discord.js)
- Signal, iMessage, Microsoft Teams
- Google Chat, Matrix, WebChat
- Voice Wake for always-on listening
- Talk Mode for continuous conversation
- Live Canvas visual workspace (A2UI)
- ElevenLabs voice integration
- macOS/iOS/Android support
- Browser control (dedicated Chromium)
- Camera snap/clip, screen record
- Cron jobs and webhooks
- Gmail Pub/Sub triggers
- Skills platform (bundled + custom)
- macOS menu bar app
- iOS node (Canvas, Voice, camera)
- Android node (Canvas, Talk, camera)
- Remote gateway control
Route different channels, accounts, or peers to isolated agents with their own workspaces and sessions. Perfect for separating personal and work contexts.
{
"routing": {
"agents": {
"main": {
"workspace": "~/clawd",
"sandbox": { "mode": "off" }
},
"work": {
"workspace": "~/clawd-work",
"sandbox": { "mode": "non-main" }
}
}
}
}Supported Channels
Link via QR code, just like WhatsApp Web.
clawdbot channels loginUse a bot token from @BotFather.
{
"channels": {
"telegram": {
"botToken": "123:ABC"
}
}
}Configure with your Discord bot token.
{
"channels": {
"discord": {
"token": "your-token"
}
}
}Use Bolt with bot and app tokens.
SLACK_BOT_TOKEN=xoxb-...
SLACK_APP_TOKEN=xapp-...Requires signal-cli setup.
macOS only, requires Messages sign-in.
Getting Started: Your First Chat
1. Pair a Channel (WhatsApp Example)
# Login to WhatsApp (scan QR code)
clawdbot channels login
# Approve pairing for new contacts
clawdbot pairing list whatsapp
clawdbot pairing approve whatsapp <code>2. Send a Test Message
# Send a message via CLI
clawdbot message send --to +1234567890 --message "Hello from Clawdbot"
# Or interact directly with the agent
clawdbot agent --message "What can you help me with?" --thinking high3. Chat Commands
Send these commands in any connected channel (WhatsApp, Telegram, etc.):
| Command | Description |
|---|---|
/status | Show session status (model, tokens, cost) |
/new or /reset | Reset the session |
/compact | Compact session context (summary) |
/think <level> | Set thinking level (off/minimal/low/medium/high/xhigh) |
/verbose on|off | Toggle verbose mode |
/restart | Restart gateway (owner-only) |
Advanced Usage & Configuration
Configuration File
Main configuration lives at ~/.clawdbot/clawdbot.json:
{
"agent": {
"model": "anthropic/claude-opus-4-5"
},
"browser": {
"enabled": true,
"controlUrl": "http://127.0.0.1:18791"
},
"channels": {
"whatsapp": {
"allowFrom": ["+1234567890"]
}
}
}Skills & Workspace
Clawdbot supports bundled, managed, and workspace skills:
- Workspace root:
~/clawd(configurable) - Prompt files:
AGENTS.md,SOUL.md,TOOLS.md - Custom skills:
~/clawd/skills/<skill>/SKILL.md
Tailscale Remote Access
Expose the gateway securely via Tailscale Serve or Funnel:
{
"gateway": {
"tailscale": {
"mode": "serve" // or "funnel" for public access
}
}
}Building from Source
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build # auto-installs UI deps
pnpm build
pnpm clawdbot onboard --install-daemon
# Development mode (auto-reload)
pnpm gateway:watchSecurity & Best Practices
Clawdbot connects to real messaging surfaces. Treat all inbound DMs as untrusted input.
- Default behavior: Unknown senders receive a pairing code— the bot won't process messages until approved
- Approve senders:
clawdbot pairing approve <channel> <code> - Run diagnostics:
clawdbot doctorto check for risky DM policies
- DM pairing required by default
- Tools run on host for main session only
- Non-main sessions can be sandboxed (Docker)
- Gateway tokens auto-generated
- Set
sandbox.mode: "non-main" - Groups/channels run in Docker
- Bash isolated per session
- Tool allowlist/denylist supported
Run clawdbot doctor regularly to check for configuration issues and security risks. It will surface any misconfigured DM policies or missing auth.
Frequently Asked Questions
Clawdbot is the personal AI assistant you run on your own terms. With support for 12+ messaging channels, voice interaction, and a thriving open-source community, it's the most flexible way to have an AI assistant everywhere you chat.