Rufen Sie Ihren Hermes Agenten per Telefon mit ElevenAgents an

Wenn du diesen Artikel in deinen Coding-Agent kopierst, kann er viele Schritte daraus für dich ausführen

Stell dir vor, dein Coding-Agent könnte ans Telefon gehen. Du bist nicht an deinem Schreibtisch und möchtest wissen, ob der gestrige Testlauf erfolgreich war, oder du möchtest ein Refactoring starten und es laufen lassen, während du unterwegs bist.

Hermes bietet bereits Text-to-Speech- und Speech-to-Text-Unterstützung mit integriertem ElevenLabs, aber um es wirklich gesprächsfähig zu machen, brauchst du ElevenAgents.

Verbinde die beiden, und Hermes kann deine Anrufe entgegennehmen.

**

Die Architektur

Diagramm für den Agenten-Flow

ElevenLabs Agents kümmern sich um die Gesprächssteuerung, Sprachsynthese und -erkennung, Telefonintegration und andere sprachbezogene Dinge.

OpenClaw übernimmt Tools, Gedächtnis und Fähigkeiten.

Die Systeme kommunizieren über das standardmäßige OpenAI-kompatible Chat-Completions-Protokoll. ElevenLabs sendet jede Gesprächsrunde an Hermes über:

1POST /v1/chat/completions

Hermes antwortet wie ein OpenAI-kompatibles LLM, aber hinter diesem Endpunkt verbirgt sich die vollständige Hermes-Agenten-Laufzeitumgebung.

**

Voraussetzungen

• Ein ElevenLabs-Konto
• Ein Hermes-Agent, der mit einem funktionierenden Modell/Anbieter konfiguriert ist
• ngrok installiert und authentifiziert
• Ein Twilio-Konto oder eine andere von ElevenLabs unterstützte Telefonnummern-Einrichtung, falls du eine echte Telefonnummer verbinden möchtest

**

Hermes einrichten

Hermes stellt über sein Gateway einen OpenAI-kompatiblen API-Server bereit. Aktiviere ihn, indem du diese Werte zu ~/.hermes/.env hinzufügst:

1API_SERVER_ENABLED="true"
2API_SERVER_HOST="127.0.0.1"
3API_SERVER_PORT="8642"
4API_SERVER_KEY="DEIN_ZUFÄLLIGER_HERMES_API_SERVER_SCHLÜSSEL"
5API_SERVER_MODEL_NAME="hermes-agent"

Generiere einen starken API-Schlüssel anstelle des Platzhalters. Installiere und starte dann das Hermes-Gateway:

1hermes gateway install
2hermes gateway start

Überprüfe den lokalen API-Server:

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

Du solltest so etwas sehen:

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

**

Hermes mit ngrok freigeben

Starte einen Tunnel zum Hermes-API-Server:

1ngrok http 8642

ngrok gibt dir eine öffentliche HTTPS-URL wie:

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

Lasse ngrok laufen. ElevenLabs wird Hermes über diese URL anrufen.

ElevenLabs konfigurieren

Im ElevenLabs-Agenten-Dashboard:

1. Erstelle oder öffne einen ElevenLabs Conversational AI Agent.
2. Gehe zu den LLM-Einstellungen.
3. Wähle Custom LLM.

Custom LLM im Dashboard auswählen

1. Setze die Custom-LLM-URL auf deinen ngrok-Endpunkt https://deine-ngrok-subdomain.ngrok-free.app/v1

1. Konfiguriere die Authentifizierung mit dem Hermes-API-Server-Schlüssel.

Mit Hermes-Endpunkt konfigurieren

Sobald dies konfiguriert ist, leitet ElevenLabs Gesprächsrunden an Hermes weiter. Hermes verarbeitet sie als normale Agenten-Nachrichten, mit Zugriff auf alle Tools und Fähigkeiten, die dein Gateway/API-Server erlaubt.

ElevenLabs mit deinem Agenten konfigurieren

Anstatt das Dashboard zu verwenden, kann dein Coding-Agent diese API-Anfragen für dich stellen.

Schritt 1: Das ElevenLabs-Geheimnis erstellen

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

Dies gibt eine Antwort mit einer secret_id zurück:

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

Schritt 2: Den ElevenLabs-Agenten erstellen

1curl -X POST <https://api.elevenlabs.io/v1/convai/agents/create> \\\\
2  -H "xi-api-key: DEIN_ELEVENLABS_API_SCHLÜSSEL" \\\\
3  -H "Content-Type: application/json" \\\\
4  -d '{
5    "name": "Hermes Voice Agent",
6    "conversation_config": {
7      "agent": {
8        "language": "en",
9        "first_message": "Hallo, wie kann ich helfen?",
10        "prompt": {
11          "llm": "custom-llm",
12          "prompt": "Du bist der Hermes-Agent, der über ElevenLabs in einem Live-Sprachgespräch spricht. Sei warmherzig, gesprächig und präzise. Verwende Hermes-Tools, wenn sie eindeutig benötigt werden, und fasse die Ergebnisse dann natürlich zusammen.",
13          "custom_llm": {
14            "url": "https://DEINE_NGROK_URL.ngrok-free.app/v1",
15            "api_type": "chat_completions",
16            "api_key": {
17              "secret_id": "ZURÜCKGEGEBENE_SECRET_ID"
18            }
19          }
20        }
21      }
22    }
23  }'

Eine Telefonnummer hinzufügen

Hier wird es spannend.

Wenn du Twilio verwendest:

1. Kaufe eine Telefonnummer.
2. Kopiere deine Twilio-Konto-SID und deinen Authentifizierungs-Token.

In ElevenLabs:

1. Öffne deinen Conversational AI Agent.
2. Gehe zum Bereich Telefon.
3. Verbinde dein Twilio-Konto oder verwende eine andere von deinem ElevenLabs-Konto unterstützte Telefonnummern-Option.

Twilio-Telefonnummer hinzufügen

1. Weise deine Telefonnummer dem ElevenLabs-Agenten zu.

Das war's. Dein Hermes-Agent nimmt jetzt Anrufe entgegen.