clawdis

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 (née Warelay) 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 agent without 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 “Warelay”?

The original name was Warelay (WhatsApp + Relay). 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

This site is open source. Improve this page.