SMS 设置（Twilio）

Hermes 通过 Twilio API 连接到 SMS。人们给你的 Twilio 电话号码发短信，然后收到 AI 回复。

前置要求

• Twilio 账户 — 在 twilio.com 注册
• 支持 SMS 的 Twilio 电话号码
• 公开可访问的服务器 — Twilio 在收到 SMS 时向你的服务器发送 webhook
• 安装 aiohttp

步骤 1：获取 Twilio 凭证

1. 进入 Twilio Console
2. 复制你的 Account SID 和 Auth Token
3. 记下你的电话号码（E.164 格式）

步骤 2：配置 Hermes

hermes gateway setup  # 选择 SMS (Twilio)

或手动配置：

TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=your_auth_token_here
TWILIO_PHONE_NUMBER=+15551234567
SMS_ALLOWED_USERS=+15559876543
SMS_WEBHOOK_URL=https://your-server:8080/webhooks/twilio

步骤 3：配置 Twilio Webhook

在 Twilio Console 中：

1. 进入你的电话号码设置
2. 在 A MESSAGE COMES IN 中设置：https://your-server:8080/webhooks/twilio

步骤 4：启动网关

hermes gateway

环境变量

变量	必需	描述
TWILIO_ACCOUNT_SID	是	Twilio Account SID
TWILIO_AUTH_TOKEN	是	Twilio Auth Token
TWILIO_PHONE_NUMBER	是	E.164 格式的电话号码
SMS_WEBHOOK_URL	是	公开 URL（用于签名验证）
SMS_ALLOWED_USERS	否	允许的用户号码

安全

注意

SMS 没有内置加密。不要用于敏感操作。

故障排除

问题	解决方案
消息未到达	检查 webhook URL 正确且公开可访问
回复未发送	验证 TWILIO_PHONE_NUMBER 正确