🦞 CLAWDIS — WhatsApp Gateway for AI Agents

EXFOLIATE! EXFOLIATE!

CLAWDIS (formerly Warelay) is a WhatsApp-to-AI gateway. Send a message, get an AI response. It's like having a genius lobster in your pocket 24/7.

┌─────────────┐      ┌──────────┐      ┌─────────────┐
│  WhatsApp   │ ───▶ │ CLAWDIS  │ ───▶ │  AI Agent   │
│  (You)      │ ◀─── │  🦞⏱️💙   │ ◀─── │ (Tau/Claude)│
└─────────────┘      └──────────┘      └─────────────┘

Why "CLAWDIS"?

CLAWDIS = CLAW + TARDIS

Because every space lobster needs a time-and-space machine. The Doctor has a TARDIS. Clawd has a CLAWDIS. Both are blue. Both are chaotic. Both are loved.

Features

• 📱 WhatsApp Integration — Personal WhatsApp Web or Twilio
• 🤖 AI Agent Gateway — Works with Tau/Pi, Claude CLI, Codex, Gemini
• 💬 Session Management — Per-sender conversation context
• 🔔 Heartbeats — Periodic check-ins for proactive AI
• 👥 Group Chat Support — Mention-based triggering
• 📎 Media Support — Images, audio, documents, voice notes
• 🎤 Voice Transcription — Whisper integration
• 🔧 Tool Streaming — Real-time display (💻📄✍️📝)

Quick Start

# Install
npm install -g warelay  # (still warelay on npm for now)

# Link your WhatsApp
clawdis login

# Send a message
clawdis send --to +1234567890 --message "Hello from the CLAWDIS!"

# Talk directly to the agent (no WhatsApp send)
clawdis agent --to +1234567890 --message "Ship checklist" --thinking high

# Start the relay
clawdis relay --verbose

Configuration

Create ~/.clawdis/clawdis.json:

{
  inbound: {
    allowFrom: ["+1234567890"],
    reply: {
      mode: "command",
      command: ["tau", "--mode", "json", "{{BodyStripped}}"],
      session: {
        scope: "per-sender",
        idleMinutes: 1440
      },
      heartbeatMinutes: 10
    }
  }
}

Documentation

• Configuration Guide
• Agent Integration
• Group Chats
• Security
• Troubleshooting
• The Lore 🦞

Clawd

CLAWDIS was built for Clawd, a space lobster AI assistant. See the full setup in docs/clawd.md.

• 🦞 Clawd's Home: clawd.me
• 📜 Clawd's Soul: soul.md
• 👨‍💻 Peter's Blog: steipete.me
• 🐦 Twitter: @steipete

Providers

WhatsApp Web (Recommended)

clawdis login      # Scan QR code
clawdis relay      # Start listening

Twilio

# Set environment variables
export TWILIO_ACCOUNT_SID=...
export TWILIO_AUTH_TOKEN=...
export TWILIO_WHATSAPP_FROM=whatsapp:+1234567890

clawdis relay --provider twilio

Commands

Command	Description
clawdis login	Link WhatsApp Web via QR
clawdis send	Send a message
clawdis agent	Talk directly to the agent (no WhatsApp send)
clawdis relay	Start auto-reply loop
clawdis status	Show recent messages
clawdis heartbeat	Trigger a heartbeat

Credits

• Peter Steinberger (@steipete) — Creator
• Mario Zechner (@badlogicgames) — Tau/Pi, security testing
• 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."

🦞💙