3.5 KiB
summary, read_when
| summary | read_when | |
|---|---|---|
| Top-level overview of Clawdis, features, and purpose |
|
CLAWDIS 🦞
"EXFOLIATE! EXFOLIATE!" — A space lobster, probably
CLAWDIS is a WhatsApp-to-AI gateway that lets your AI assistant live in your pocket. Built for Clawd, a space lobster who needed a TARDIS.
Source & Issues: github.com/steipete/clawdis
What is this?
CLAWDIS bridges WhatsApp to AI coding agents like Tau/Pi. Send a message, get an AI response. It's like having a genius lobster on call 24/7.
┌─────────────┐ ┌──────────┐ ┌─────────────┐
│ WhatsApp │ ───▶ │ CLAWDIS │ ───▶ │ AI Agent │
│ (You) │ ◀─── │ 🦞⏱️💙 │ ◀─── │ (Tau/Pi) │
└─────────────┘ └──────────┘ └─────────────┘
Features
- 📱 WhatsApp Integration — Uses Baileys for WhatsApp Web protocol
- 🤖 AI Agent Gateway — Pi/Tau only (Pi CLI in RPC mode)
- 💬 Session Management — Maintains conversation context across messages
- 🔔 Heartbeats — Periodic check-ins so your AI doesn't feel lonely
- 👥 Group Chat Support — Mention-based triggering in group chats
- 📎 Media Support — Send and receive images, audio, documents
- 🎤 Voice Messages — Transcription via Whisper
- 🔧 Tool Streaming — Real-time display of AI tool usage (💻📄✍️📝)
Note: support for Claude, Codex, Gemini, and Opencode has been removed; Pi/Tau is now the only coding agent path.
The Name
CLAWDIS = CLAW + TARDIS
Because every space lobster needs a time-and-space machine to travel through WhatsApp messages. It's bigger on the inside (130k+ tokens of context).
The Doctor has a TARDIS. Clawd has a CLAWDIS. Both are blue. Both are a bit chaotic. Both are loved.
Quick Start
# Install
pnpm install
# Configure
cp ~/.clawdis/clawdis.example.json ~/.clawdis/clawdis.json
# Edit with your settings
# Run
clawdis start
# Check status
clawdis status
Documentation
- Configuration Guide — Setting up your CLAWDIS
- Agent Integration — Connecting AI agents
- Direct Agent CLI — Use
clawdis agentwithout sending WhatsApp messages - Group Chats — Mention patterns and filtering
- Media Handling — Images, voice, documents
- Session Management — How conversations are keyed and reset
- Security — Keeping your lobster safe
- Troubleshooting — When the CLAWDIS misbehaves
Why "Clawdis"?
The original name was Clawdis (WhatsApp + Gateway). It worked. It was fine.
But then Clawd happened, and suddenly we needed something with more... personality.
CLAWDIS was born. The lobster approved. 🦞
Credits
- Peter Steinberger (@steipete) — Creator, lobster whisperer
- Mario Zechner (@badlogicc) — Tau/Pi creator, security pen-tester
- Clawd — The space lobster who demanded a better name
License
MIT — Free as a lobster in the ocean 🦞
"We're all just playing with our own prompts." — An AI, probably high on tokens