Dpro-at/Tel-Agent

这是什么？

核心功能

• 01通过流式语音识别和合成实时接听 SIP 电话。
• 02根据来电号码将通话路由给人工、拦截或 AI 智能体。
• 03智能体可调用转接电话、留言、查看日历和 HTTP 接口等工具。
• 04保存可搜索的通话录音和转写文本。
• 05使用运营者自己的凭据处理短信、邮件、网页聊天及主流即时通讯渠道。
• 06支持自托管，API 密钥加密存储，首次运行必须设置管理员密码。

适用场景

• 用 AI 前台接听企业电话，可以留言或转接给员工。
• 把通话录音和转写文本保存在自有服务器上，而不是托管服务中。
• 让同一个 AI 助手同时处理电话、短信、邮件和聊天渠道的客户咨询。
• 把现有的 3CX、Asterisk 或 FreePBX 系统作为分机接入 AI 智能体。

快速上手

1. 1

   克隆代码仓库

   git clone https://github.com/Dpro-at/Tel-Agent.git
2. 2

   进入项目文件夹

   cd Tel-Agent
3. 3

   复制示例环境变量文件

   cp .env.example .env
4. 4

   在 .env 中设置 ENCRYPTION_KEY（可用 openssl 生成），然后启动容器

   docker compose up -d --build

使用前须知

• !项目处于 alpha 阶段。
• !安装程序未签名，操作系统会在运行前要求确认。
• !电话渠道需要语音识别、大语言模型和语音合成服务商的 API 密钥，以及 SIP 线路或 PBX。
• !本地模型需要 GPU 才能进行自然对话，且不是默认选项。

标签

常见问题

Tel-Agent 是什么？

自托管网关，把电话线路和聊天渠道接入 AI 智能体，使用你自己的 API 密钥。 Tel-Agent 位于电话线路与 AI 智能体之间。来电（SIP）会先按路由规则判断，可以转给人工、直接拒绝，或交给 AI 智能体实时通话。智能体可以调用工具，例如转接电话、留言、查看日历或调用 HTTP 接口，所有通话都会被录音、转写并可搜索。

Tel-Agent 可以免费使用吗？用的什么许可证？

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

Tel-Agent 还在维护吗？

活跃维护中。Tel-Agent 最近一次提交是在 2026年10月8日。

Tel-Agent 适合用来做什么？

用 AI 前台接听企业电话，可以留言或转接给员工。 把通话录音和转写文本保存在自有服务器上，而不是托管服务中。 让同一个 AI 助手同时处理电话、短信、邮件和聊天渠道的客户咨询。 把现有的 3CX、Asterisk 或 FreePBX 系统作为分机接入 AI 智能体。

Tel-Agent 怎么安装和运行？

克隆代码仓库: git clone https://github.com/Dpro-at/Tel-Agent.git 进入项目文件夹: cd Tel-Agent 复制示例环境变量文件: cp .env.example .env 在 .env 中设置 ENCRYPTION_KEY（可用 openssl 生成），然后启动容器: docker compose up -d --build

在哪里获取 Tel-Agent？

源代码和安装说明在 GitHub 上：https://github.com/Dpro-at/Tel-Agent