核心功能
elevenlabs-twilio-memory-bridge 是一款 FastAPI 驱动的个性化 Webhook 中间件，专为 ElevenLabs 与 Twilio 集成的语音 AI Agent 设计。其核心作用是在每次来电开始时，向 Agent 动态注入来电者的历史记忆、长期事实、当日上下文笔记及个性化人格模板，实现"千人千面"的通话体验。
工作流程
1. 来电触发 Twilio → ElevenLabs 原生集成
2. ElevenLabs 调用 /webhook/personalize 端点
3. 服务根据 SHA-256 哈希后的来电号码检索历史数据
4. 组合 soul_template.md + 长期记忆 + 短期笔记
5. 返回系统提示覆盖，Agent 以完整上下文应答
显著优点
- 零音频代理架构：ElevenLabs 与 Twilio 直接处理媒体流，本服务仅处理轻量级 HTTP Webhook，延迟极低、成本可控
- 零外部依赖：纯文件系统 JSON 持久化，无需 Redis/PostgreSQL，部署极简
- OpenClaw 兼容：支持任何 OpenAI-compatible LLM 端点，灵活适配自托管或第三方模型
- 隐私优先设计：电话号码 SHA-256 哈希后存储，无明文留存；密钥全环境变量管理，源码安全公开
潜在局限
- 扩展性天花板：文件系统 IO 在极高并发场景下可能成为瓶颈（估算单机上限数百 TPS）
- 无原生集群支持：缺乏分布式锁或一致性协议，多实例部署需外部协调
- 功能聚焦单一：仅处理上下文注入，不涉及通话录音、实时转写、情感分析等进阶功能
适用人群
- 中小型企业快速部署个性化语音客服
- 开发者构建 MVP 级 AI 电话 Agent
- 已使用 OpenClaw 或自托管 LLM 的技术团队
- 对数据隐私敏感、希望完全控制数据存储位置的场景
常规风险
- Webhook 安全性：若未配置
WEBHOOK_SECRET，端点可能遭受伪造请求攻击（建议生产环境强制启用 HMAC 验证） - 文件权限配置：
DATA_DIR目录权限不当可能导致数据泄露或篡改 - 密钥轮转：
ADMIN_API_KEY泄露将导致记忆管理端点完全暴露