使用 ElevenAgents 通过电话呼叫你的 Hermes Agent

@ElevenLabsDevs
英语1个月前 · 2026年6月04日
404K
520
49
22
1.2K

TL;DR

本指南介绍了如何将 Hermes 编程 Agent 与 ElevenLabs 和 ElevenAgents 集成,通过 Twilio 和 ngrok 实现实时语音交互及电话连接。

如果你把这篇文章复制给你的编程 Agent,它可以为你执行其中的许多步骤

想象一下,如果你的编程 Agent 能接电话会怎样?你不在办公桌前,却想知道昨晚的测试是否顺利通过,或者想启动一次重构,让它在你开车时自动运行。

Hermes 已经内置了 ElevenLabs 的文本转语音和语音转文本支持,但要实现真正的对话体验,你需要 ElevenAgents。

将两者连接起来,Hermes 就能接听你的电话了。

**

架构

ElevenLabs Developers - inline image

Agent 流程图

ElevenLabs Agents 负责处理话轮切换、语音合成与识别、电话集成以及其他语音相关功能。

OpenClaw 负责处理工具、记忆和技能。

这两个系统通过标准的 OpenAI 兼容聊天补全协议进行通信。ElevenLabs 通过以下方式将每个对话轮次发送给 Hermes:

text
1POST /v1/chat/completions

Hermes 像 OpenAI 兼容的 LLM 一样进行响应,但在这个端点背后运行的是完整的 Hermes Agent 运行时环境。

**

前提条件

  • 一个 ElevenLabs 账户
  • 一个配置了可用模型/提供商的 Hermes Agent
  • 已安装并完成身份验证的 ngrok
  • 一个 Twilio 账户,或另一个 ElevenLabs 支持的电话号码设置(如果你想连接真实电话号码)

**

设置 Hermes

Hermes 通过其网关暴露一个 OpenAI 兼容的 API 服务器。通过将以下值添加到 ~/.hermes/.env 文件来启用它:

bash
1API_SERVER_ENABLED="true"
2API_SERVER_HOST="127.0.0.1"
3API_SERVER_PORT="8642"
4API_SERVER_KEY="YOUR_RANDOM_HERMES_API_SERVER_KEY"
5API_SERVER_MODEL_NAME="hermes-agent"

请生成一个强 API 密钥,而不是使用占位符。然后安装并启动 Hermes 网关:

bash
1hermes gateway install
2hermes gateway start

验证本地 API 服务器:

bash
1curl -sS <http://127.0.0.1:8642/health>

你应该会看到类似这样的输出:

bash
1{"status": "ok", "platform": "hermes-agent"}

**

使用 ngrok 暴露 Hermes

启动一个指向 Hermes API 服务器的隧道:

bash
1ngrok http 8642

ngrok 会给你一个类似这样的公共 HTTPS URL:

text
1<https://your-ngrok-subdomain.ngrok-free.app>

保持 ngrok 运行。ElevenLabs 将通过这个 URL 调用 Hermes。

配置 ElevenLabs

在 ElevenLabs Agent 仪表盘中:

  1. 创建或打开一个 ElevenLabs 对话式 AI Agent。
  2. 进入 LLM 设置。
  3. 选择自定义 LLM。
ElevenLabs Developers - inline image

在仪表盘中选择自定义 LLM

  1. 将自定义 LLM URL 设置为你的 ngrok 端点 https://your-ngrok-subdomain.ngrok-free.app/v1
  1. 使用 Hermes API 服务器密钥配置身份验证。
ElevenLabs Developers - inline image

使用 Hermes 端点进行配置

配置完成后,ElevenLabs 会将对话轮次路由到 Hermes。Hermes 会像处理常规 Agent 消息一样处理它们,并可以访问你的网关/API 服务器平台所允许的任何工具和技能。

使用你的 Agent 配置 ElevenLabs

除了使用仪表盘,你的编程 Agent 也可以为你发出这些 API 请求。

步骤 1:创建 ElevenLabs 密钥

bash
1curl -X POST <https://api.elevenlabs.io/v1/convai/secrets> \\\\
2 -H "xi-api-key: YOUR_ELEVENLABS_API_KEY" \\\\
3 -H "Content-Type: application/json" \\\\
4 -d '{
5 "type": "new",
6 "name": "hermes_gateway_token",
7 "value": "YOUR_RANDOM_HERMES_API_SERVER_KEY"
8 }'

这会返回一个包含 secret_id 的响应:

bash
1{
2 "type": "stored",
3 "secret_id": "abc123...",
4 "name": "hermes_gateway_token"
5}

步骤 2:创建 ElevenLabs Agent

bash
1curl -X POST <https://api.elevenlabs.io/v1/convai/agents/create> \\\\
2 -H "xi-api-key: YOUR_ELEVENLABS_API_KEY" \\\\
3 -H "Content-Type: application/json" \\\\
4 -d '{
5 "name": "Hermes Voice Agent",
6 "conversation_config": {
7 "agent": {
8 "language": "en",
9 "first_message": "Hello, how can I help?",
10 "prompt": {
11 "llm": "custom-llm",
12 "prompt": "You are Hermes Agent speaking through ElevenLabs in a live voice conversation. Be warm, conversational, and concise. Use Hermes tools when they are clearly needed, then summarize results naturally.",
13 "custom_llm": {
14 "url": "https://YOUR_NGROK_URL.ngrok-free.app/v1",
15 "api_type": "chat_completions",
16 "api_key": {
17 "secret_id": "RETURNED_SECRET_ID"
18 }
19 }
20 }
21 }
22 }
23 }'

绑定电话号码

这才是最有趣的部分。

如果你使用 Twilio:

  1. 购买一个电话号码。
  2. 复制你的 Twilio 账户 SID 和身份验证令牌。

在 ElevenLabs 中:

  1. 打开你的对话式 AI Agent。
  2. 进入电话部分。
  3. 连接你的 Twilio 账户,或使用你的 ElevenLabs 账户支持的其他电话号码选项。
ElevenLabs Developers - inline image

添加 Twilio 电话号码

  1. 将你的电话号码绑定到 ElevenLabs Agent。

就这样。你的 Hermes Agent 现在可以接电话了。

一键保存

使用 YouMind AI 深度阅读爆款文章

保存原文、追问细节、总结观点,并在一个 AI 工作空间里把爆款文章沉淀成可复用笔记。

了解 YouMind
写给创作者

把你的 Markdown 变成干净的 𝕏 文章

图片上传、表格、代码块,往 𝕏 上手动重排太痛苦。YouMind 把整篇 Markdown 一键转成干净、可直接发布的 𝕏 文章草稿。

试试 Markdown 转 𝕏

更多可拆解样本

近期爆款文章

探索更多爆款文章