使用 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": "你好,有什麼可以幫你的嗎?",
10 "prompt": {
11 "llm": "custom-llm",
12 "prompt": "你是透過 ElevenLabs 進行即時語音對話的 Hermes Agent。請保持溫暖、健談且簡潔。在明確需要時使用 Hermes 工具,然後自然地總結結果。",
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 和 Auth Token。

在 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 轉 𝕏

更多可拆解樣本

近期爆款文章

探索更多爆款文章