# 策展 · X (Twitter) 🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：ElevenLabs Developers (@ElevenLabsDevs) · 平台：X (Twitter) · 日期：2026-06-05

> 原始來源：https://x.com/ElevenLabsDevs/status/2062561944385519801

## 中文摘要

# 使用 ElevenAgents 透過電話呼叫你的 Hermes Agent

如果你將這篇文章複製給你的程式開發 Agent，它就能為你執行其中的許多步驟。

如果你的程式開發 Agent 可以接聽電話，那會怎麼樣？當你不在電腦前，卻想知道昨晚的測試執行是否順利通過，或者你想啟動一個重構任務，並在開車時讓它在背景運作，這時該怎麼辦？

Hermes 本身已經內建了 ElevenLabs 的語音轉文字（Speech to Text）與文字轉語音（Text to Speech）支援，但要讓它真正具備對話能力，你需要 ElevenAgents。

將兩者串接起來，Hermes 就能幫你接聽電話。

---

## 架構說明

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780620970062-diaHJtSoHXIAAFIOfjpg.jpg)

ElevenLabs Agents 負責處理對話輪次（turn taking）、語音合成與辨識、電話整合以及其他與語音相關的事務。

OpenClaw 則負責處理工具、記憶與 skill。

這兩個系統透過標準的 OpenAI 相容 Chat Completions 協定進行通訊。ElevenLabs 會透過以下方式將每一輪對話傳送給 Hermes：

```
POST /v1/chat/completions
```

Hermes 會像一個 OpenAI 相容的 LLM 一樣回應，但該端點背後運作的是完整的 Hermes Agent 執行環境。

---

## 先決條件

- 一個 ElevenLabs 帳號
- 一個已設定好運作中模型/供應商的 Hermes Agent
- 已安裝並完成驗證的 ngrok
- 一個 Twilio 帳號，或是其他 ElevenLabs 支援的電話號碼設定（如果你想連接真實電話號碼的話）

---

## 設定 Hermes

Hermes 透過其閘道（gateway）公開一個 OpenAI 相容的 API 伺服器。請在 `~/.hermes/.env` 中加入以下數值來啟用它：

```bash
API_SERVER_ENABLED="true"
API_SERVER_HOST="127.0.0.1"
API_SERVER_PORT="8642"
API_SERVER_KEY="YOUR_RANDOM_HERMES_API_SERVER_KEY"
API_SERVER_MODEL_NAME="hermes-agent"
```

請產生一組強密碼作為 API Key，不要直接使用預留位置。接著安裝並啟動 Hermes 閘道：

```bash
hermes gateway install
hermes gateway start
```

驗證本地 API 伺服器是否運作正常：

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

你應該會看到類似這樣的輸出：

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

---

## 使用 ngrok 公開 Hermes

啟動一個通往 Hermes API 伺服器的通道（tunnel）：

```bash
ngrok http 8642
```

ngrok 會給你一個公開的 HTTPS URL，例如：

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

請保持 ngrok 執行中。ElevenLabs 將會透過此 URL 呼叫 Hermes。

---

## 設定 ElevenLabs

在 ElevenLabs Agent 儀表板中：

1. 建立或開啟一個 ElevenLabs Conversational AI Agent。
2. 前往 LLM 設定。
3. 選擇 Custom LLM。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780620970071-diaHJuRcDXUAAaFxqjpg.jpg)

4. 將 Custom LLM URL 設定為你的 ngrok 端點：`https://your-ngrok-subdomain.ngrok-free.app/v1`
5. 使用 Hermes API 伺服器 Key 設定驗證。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780620970080-diaHJucc6XoAEFJhnjpg.jpg)

設定完成後，ElevenLabs 就會將對話輪次路由至 Hermes。Hermes 會將其視為一般的 Agent 訊息進行處理，並能存取你的閘道/API 伺服器平台所允許的任何工具與 skill。

---

## 使用你的 Agent 來設定 ElevenLabs

你也可以不使用儀表板，直接讓你的程式開發 Agent 為你發送這些 API 請求。

步驟 1：建立 ElevenLabs 密鑰（secret）

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

這會回傳一個包含 `secret_id` 的回應：

```bash
{
  "type": "stored",
  "secret_id": "abc123...",
  "name": "hermes_gateway_token"
}
```

步驟 2：建立 ElevenLabs Agent

```bash
curl -X POST <https://api.elevenlabs.io/v1/convai/agents/create> \\\\
  -H "xi-api-key: YOUR_ELEVENLABS_API_KEY" \\\\
  -H "Content-Type: application/json" \\\\
  -d '{
    "name": "Hermes Voice Agent",
    "conversation_config": {
      "agent": {
        "language": "en",
        "first_message": "Hello, how can I help?",
        "prompt": {
          "llm": "custom-llm",
          "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.",
          "custom_llm": {
            "url": "https://YOUR_NGROK_URL.ngrok-free.app/v1",
            "api_type": "chat_completions",
            "api_key": {
              "secret_id": "RETURNED_SECRET_ID"
            }
          }
        }
      }
    }
  }'
```

---

## 掛載電話號碼

這才是最有趣的部分。

如果你使用 Twilio：

1. 購買一個電話號碼。
2. 複製你的 Twilio Account SID 與 Auth Token。

在 ElevenLabs 中：

1. 開啟你的 Conversational AI Agent。
2. 前往 Phone 區塊。
3. 連接你的 Twilio 帳號，或是使用你 ElevenLabs 帳號支援的其他電話號碼選項。

![](https://pub-75d4fe1e4e80421b9ecb1245a7ae0d1a.r2.dev/curated/1780620970282-diaHJu5uVWsAAijYVjpg.jpg)

4. 將你的電話號碼掛載到 ElevenLabs Agent 上。

這樣就完成了。現在，你的 Hermes Agent 可以幫你接聽電話了。

## 標籤

Agent, Hermes Agent, TTS, STT, 自動化, ElevenLabs, Hermes Agent