elevenlabs-twilio-memory-bridge

---

name: elevenlabs-twilio-memory-bridge

version: "1.0.0"

author: britrik

description: "FastAPI personalization webhook that adds persistent caller memory and dynamic context injection to ElevenLabs Conversational AI agents on Twilio. No audio proxying, file-based persistence, OpenClaw compatible."

tags: ["elevenlabs", "twilio", "voice-agent", "telephony", "conversational-ai", "memory-injection", "fastapi"]

emoji: ":telephone_receiver:"

---

# elevenlabs-twilio-memory-bridge

Personalization webhook service for ElevenLabs + Twilio voice agents with persistent caller memory.

What It Does

When a call arrives on your Twilio number, ElevenLabs' native integration triggers this webhook. The bridge looks up the caller's history, loads long-term memory facts and daily context notes, combines them with a customizable soul/personality template, and returns everything as a system prompt override so your agent greets each caller with full context.

Architecture

Endpoints

| Endpoint | Method | Purpose |

|----------|--------|---------|

| `/webhook/personalize` | POST | ElevenLabs calls this on inbound call |

| `/webhook/post-call` | POST | Optional post-call cleanup |

| `/api/memory/{phone_hash}` | POST | Add long-term fact about a caller |

| `/api/notes` | POST | Add global or caller-scoped context note |

| `/health` | GET | Health check |

Setup

1. Clone repo, `pip install -r requirements.txt`

2. Copy `.env.example` to `.env`, fill in secrets

3. Configure ElevenLabs agent with Custom LLM pointing to your OpenClaw instance

4. Enable system prompt + first message overrides in agent Security settings

5. Add webhook URL `https://your-domain/webhook/personalize` in ElevenLabs settings

6. Import Twilio number in ElevenLabs dashboard

7. Run: `uvicorn app:app --host 0.0.0.0 --port 8000`

Required Environment Variables

Security