hail-hq/hail

这是什么？

核心功能

• 01通过 Twilio、Telnyx、DIDWW 实现呼入与呼出电话
• 02支持短信收发，并提供退订名单管理
• 03基于 AWS SES 在 Hail 域名或自有域名上收发邮件
• 04可按通话或全组织设置自带的 OpenAI 兼容大模型接口
• 05提供远程 MCP 服务器、Python SDK、命令行工具和 OpenAPI 接口
• 06支持使用 Docker Compose 与 Postgres 自托管

适用场景

• 让智能体致电客户确认或改期预约
• 为 AI 助手配置专用号码，用于短信和语音
• 把呼入电话或邮件转交给智能体处理
• 通过 MCP 让编程助手直接发送消息或拨打电话

快速上手

1. 1

   克隆代码仓库

   git clone https://github.com/hail-hq/hail
2. 2

   进入项目目录并复制环境变量模板

   cd hail && cp .env.example .env
3. 3

   使用本地 Docker Compose 环境运行数据库迁移

   docker compose -f docker-compose.yml -f docker-compose.local.yml run --rm api alembic upgrade head
4. 4

   在后台启动自托管服务

   docker compose -f docker-compose.yml -f docker-compose.local.yml up -d

使用前须知

• !语音通话需要外部服务：LiveKit Cloud、运营商（Twilio、Telnyx 或 DIDWW）、Deepgram、Cartesia 以及 LLM 提供商。
• !邮件功能需要 AWS SES，且为可选项。
• !采用 AGPL-3.0 许可证，修改后作为网络服务运行时必须公开源代码。
• !Whisper、AssemblyAI 和说话人分离等部分计划功能尚未发布。

标签

常见问题

hail 是什么？

开源的 AI 智能体通信平台，为智能体提供真实电话号码、短信与邮箱能力，可接入自带的大模型。 Hail 让 AI 智能体可以拨打和接听电话、收发短信，并拥有一个邮箱。它通过 LiveKit 对接 Twilio、Telnyx、DIDWW 等运营商，并负责语音识别、语音合成和轮次检测等语音链路。智能体的推理部分可以接入任意兼容 OpenAI Chat Completions 接口的模型，也可以使用内置的 Anthropic、OpenAI、Gemini 回退链路。

hail 可以免费使用吗？用的什么许可证？

hail 以 AGPL-3.0 许可证开源。用于商业产品前，请先确认许可证条款。

hail 还在维护吗？

活跃维护中。hail 最近一次提交是在 2026年10月20日。

hail 适合用来做什么？

让智能体致电客户确认或改期预约 为 AI 助手配置专用号码，用于短信和语音 把呼入电话或邮件转交给智能体处理 通过 MCP 让编程助手直接发送消息或拨打电话

hail 怎么安装和运行？

克隆代码仓库: git clone https://github.com/hail-hq/hail 进入项目目录并复制环境变量模板: cd hail && cp .env.example .env 使用本地 Docker Compose 环境运行数据库迁移: docker compose -f docker-compose.yml -f docker-compose.local.yml run --rm api alembic upgrade head 在后台启动自托管服务: docker compose -f docker-compose.yml -f docker-compose.local.yml up -d

在哪里获取 hail？

源代码和安装说明在 GitHub 上：https://github.com/hail-hq/hail