核心功能
elevenlabs-twilio-memory-bridge 是一款 FastAPI 构建的个性化 Webhook 服务，专为 ElevenLabs 对话式 AI 语音代理设计。当来电者拨打 Twilio 号码时，ElevenLabs 的原生集成会触发此服务，该桥接器会查询来电历史、加载长期记忆事实和每日上下文备注，结合可定制的灵魂/个性模板，将所有内容作为系统提示词覆盖返回，使代理能以完整上下文迎接每位来电者。
显著优点
- 零音频代理：ElevenLabs 与 Twilio 直接处理媒体流，无需复杂的音频管道
- 极简架构：纯 Webhook 触发，每通来电仅调用一次注入上下文
- 零外部依赖：基于文件的 JSON 持久化存储，无需数据库
- OpenClaw 兼容：支持任何 OpenAI 兼容的 LLM 端点
- 企业级安全：HMAC-SHA256 电话号码哈希、Fernet 静态加密、强制 Webhook 验证、速率限制、POSIX 文件锁
潜在局限
- v1.2.0 破坏性变更：新增
PHONE_HASH_SALT和WEBHOOK_SECRET为必填项，升级后现有来电者数据将无法访问 - 文件存储限制：JSON 文件不适合高并发大规模部署，缺乏数据库的事务保证和水平扩展能力
- 数据加密可选：默认明文存储，需手动配置
DATA_ENCRYPTION_KEY才启用加密 - 单实例架构：无内置集群支持，多节点部署需外部协调
适合人群
- 需要为 ElevenLabs 语音代理添加来电者记忆的开发者
- 追求极简部署、不愿维护数据库的中小型项目
- 使用 OpenClaw 或其他 OpenAI 兼容端点的用户
- 对通话隐私有要求、需要电话号码脱敏存储的场景
常规风险
- 数据丢失风险：更换
PHONE_HASH_SALT会导致所有历史来电者数据不可恢复 - 密钥管理负担：需安全存储
ELEVENLABS_API_KEY、WEBHOOK_SECRET、PHONE_HASH_SALT、DATA_ENCRYPTION_KEY等多把密钥 - Webhook 安全风险：生产环境必须设置
WEBHOOK_SECRET，否则面临伪造请求风险 - 文件权限依赖：依赖正确的 Unix 文件权限（0o700/0o600），在部分容器环境可能受限