AgentSkillsCN

elevenlabs-twilio-memory-bridge

FastAPI 个性化 Webhook，为 Twilio 上的 ElevenLabs 会话式 AI 代理添加持久化来电者记忆与动态上下文注入功能。无需音频代理、基于文件的持久化，兼容 OpenClaw。

SKILL.md
--- frontmatter
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

  • •No audio proxying - ElevenLabs and Twilio handle media directly
  • •Webhook only - called once per inbound call to inject context
  • •File-based persistence - JSON files in ./data/, zero external dependencies
  • •OpenClaw compatible - works with any OpenAI-compatible LLM endpoint

Endpoints

EndpointMethodPurpose
/webhook/personalizePOSTElevenLabs calls this on inbound call
/webhook/post-callPOSTOptional post-call cleanup
/api/memory/{phone_hash}POSTAdd long-term fact about a caller
/api/notesPOSTAdd global or caller-scoped context note
/healthGETHealth 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

  • •ELEVENLABS_API_KEY - scoped ElevenLabs key
  • •ELEVENLABS_AGENT_ID - your agent ID
  • •OPENCLAW_API_BASE_URL - your OpenClaw instance URL
  • •PUBLIC_BASE_URL - publicly reachable URL of this service

Security

  • •All caller phone numbers are SHA-256 hashed before storage/logging
  • •Secrets loaded exclusively from environment variables
  • •Optional HMAC webhook signature verification
  • •Safe for public GitHub repos, no secrets in source