AI assistant for the trades

---

Clawbolt is a messaging-first AI assistant that helps contractors manage their business: estimates, client records, job photos, voice memos, and more, all through Telegram. No app to install, no dashboard to learn. Just text.

Read the full documentation

Demo

Features

• Estimates -- Describe a job, get a professional PDF estimate generated and sent back instantly
• Memory -- Clawbolt remembers your rates, clients, preferences, and past conversations
• Photo analysis -- Send a job site photo and get an AI description for documentation
• Voice memos -- Send a voice note, get it transcribed and processed as a message
• File cataloging -- Photos and documents auto-organized in Dropbox or Google Drive
• Proactive heartbeat -- Clawbolt checks in periodically with reminders about stale drafts and follow-ups
• Onboarding -- First-time contractors get a friendly conversation to set up their profile

Quick Start

git clone https://github.com/mozilla-ai/clawbolt.git
cd clawbolt
cp .env.example .env
# Edit .env with your TELEGRAM_BOT_TOKEN and LLM API key
docker compose up --build

Verify it's running:

curl http://localhost:8000/api/health
# {"status":"ok"}

The Telegram webhook is registered automatically via a Cloudflare Tunnel. Send a message to your bot and Clawbolt will respond.

See the docs for full configuration options, storage setup, and Telegram bot setup.

Contributing

See DEVELOPMENT.md for local setup and running tests, or read the full contributing guide.