Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
70364631f4
The Twilio SDK's request method wasn't working for the typing indicator API. This rewrites the implementation to use direct fetch() calls with comprehensive error handling and retry logic. Key changes: - Switch from SDK to direct fetch() with Basic auth - Add time-based retry loop (30s budget) for MDR propagation delays - Add 10s per-request timeout via AbortController to prevent hangs - Add exponential backoff with jitter (1s-5s, +200ms jitter) - Track succeeded SIDs to skip retry on refresh calls - Add typed errors (NetworkError, FetchTimeoutError) for proper handling - Fail fast on non-retryable errors (401, 403, non-MDR 400) - Fire-and-forget pattern to avoid blocking reply flow 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> |
||
|---|---|---|
| .github/workflows | ||
| bin | ||
| docs | ||
| src | ||
| test/mocks | ||
| .env.example | ||
| .gitignore | ||
| .npmrc | ||
| AGENTS.md | ||
| biome.json | ||
| CHANGELOG.md | ||
| CLAUDE.md | ||
| LICENSE | ||
| package.json | ||
| pnpm-workspace.yaml | ||
| README-header.png | ||
| README.md | ||
| tsconfig.json | ||
🦞 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
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."
🦞💙