clawbolt

KO | EN

gitlite — search

#typescript #ai-agents #deepseek-harness #dsh-plugin #open-source #ai #cli #dsh #claude-code #codex #developer-tools #react

★ 99 Open GitHub ↗

The AI Assistant that actually does things for the trades

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

AI assistant for the trades

---

Clawbolt is a messaging-first AI assistant that helps users manage their business: estimates, client records, job photos, and more. Text your assistant from iMessage, RCS, SMS, or Telegram. No app to install, no dashboard to learn. Just text.

**[User guide: clawbolt.ai/docs](https://clawbolt.ai/docs)**

## Demo

[![Clawbolt Demo](https://img.youtube.com/vi/YJcnij0SYiY/maxresdefault.jpg)](https://www.youtube.com/watch?v=YJcnij0SYiY)

## Features

- **Memory** -- Clawbolt remembers your rates, clients, preferences, and past conversations
- **Photo analysis** -- Send a job site photo and get an AI description for documentation
- **File cataloging** -- Photos and documents auto-organized in your Google Drive
- **Proactive heartbeat** -- Clawbolt checks in periodically with reminders and follow-ups
- **QuickBooks Online** -- Query, create, and send invoices and estimates via QuickBooks (experimental)
- **Google Calendar** -- Check availability, schedule jobs, and manage events from chat (experimental)
- **Onboarding** -- First-time users get a friendly conversation to set up their profile

## Quick Start

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

Verify it's running:

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

Webhooks are registered automatically via a Cloudflare Tunnel. Text the Linq phone number or message your Telegram bot and Clawbolt will respond.

## Documentation

| Audience | Where |
|---|---|
| **End users** (people using Clawbolt to run their business) | [clawbolt.ai/docs](https://clawbolt.ai/docs) |
| **Self-hosters** (running your own instance) | [docs/self-host/](./docs/self-host/) |
| **Contributors** (hacking on Clawbolt itself) | [CONTRIBUTING.md](./CONTRIBUTING.md) |

### Self-hosting

- [Self-hosting overview](./docs/self-host/README.md) -- quickstart and index
- [Configuration](./docs/self-host/configuration.md) -- full environment variable reference
- [Multi-user deployment](./docs/self-host/configuration.md#multi-user-deployment) -- `AUTH_MODE=multi_user`: Google sign-in, per-tenant quotas, admin console. Off by default; a self-host can ignore it
- [Docker](./docs/self-host/docker.md) -- Docker Compose setup and troubleshooting
- [Google Drive Setup](./docs/self-host/google-drive-setup.md) -- file storage integration, per-user OAuth
- Messaging channels: [Linq](./docs/self-host/linq-setup.md), [BlueBubbles](./docs/self-host/bluebubbles-setup.md), [Telegram](./docs/self-host/telegram-setup.md)

### Development

- [CONTRIBUTING.md](./CONTRIBUTING.md) -- local dev setup, tests, code standards, PR guidelines

## Contributing

See [CONTRIBUTING.md](./CONTRIBUTING.md) for local development setup, tests, and PR guidelines.

clawbolt

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README