Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞
a9f3527c4c
Implements identity mapping to allow linking WhatsApp, Telegram, and Twilio identities for shared Claude conversation sessions across providers. Core Features: - Identity mapping storage in ~/.clawdis/identity-map.json - Session ID normalization for unified sessions - CLI commands for managing identity mappings - Full backwards compatibility (opt-in feature) New Identity Module (src/identity/): - types.ts: Type definitions for identity mappings - storage.ts: CRUD operations for identity persistence - normalize.ts: Session ID normalization logic - Comprehensive test coverage (29 tests passing) CLI Commands (src/commands/identity.ts): - identity link: Link multiple provider identities - identity list: Show all identity mappings - identity show: Display specific mapping details - identity unlink: Remove identity mapping - Input validation for E.164 phone numbers and Telegram usernames - JSON output support for list/show commands Session Integration: - Made deriveSessionKey() async to support identity lookups - Updated all callers: auto-reply, agent command, web provider - Group conversations excluded from identity mapping - Provider detection based on ID format Documentation: - docs/session-sharing.md: Comprehensive user documentation - Architecture overview and use cases - CLI usage examples and troubleshooting guide Test Coverage: - src/identity/normalize.test.ts: 11 tests for normalization - src/identity/storage.test.ts: 18 tests for storage operations - 100% coverage of identity module functionality Files Changed: - 10 new files (identity module, CLI, docs, tests) - 5 modified files (sessions, CLI integration, auto-reply) Build Status: - All tests passing (29/29) - Zero TypeScript errors - Ready for production use |
||
|---|---|---|
| .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."
🦞💙