Files

Peter Steinberger a27ee2366e 🦞 Rebrand to CLAWDIS - add docs, update README

- New README with CLAWDIS branding
- docs/index.md - Main landing page
- docs/configuration.md - Config guide
- docs/agents.md - Agent integration guide
- docs/security.md - Security lessons (including the find ~ incident)
- docs/troubleshooting.md - Debug guide
- docs/lore.md - The origin story

EXFOLIATE!

2025-12-03 15:45:43 +00:00

4.1 KiB

Raw Blame History

🦞 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!"

# 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

Clawd

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

Follow the journey: @steipete | clawd.me

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 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."

🦞💙

4.1 KiB Raw Blame History