Gastgehostete Agenten | EmpirioLabs AI Docs

Hosted Agents bieten Ihnen eine private Agent-Laufzeit, die mit Ihren Tools verbunden ist und auf EmpirioLabs-Modellen läuft. Jeder Agent ist isoliert, behält seinen eigenen persistenten Speicher und ist über die EmpirioLabs-API oder über Ihre angeschlossenen Kanäle erreichbar.

Warum Gastgeber-Agenten

Lebt in Ihren Apps

Verbinde Telegram, Discord, Slack, Matrix, Teams, WhatsApp und mehr.

Verwendet vernetzte Werkzeuge

Füge Gmail, Drive, GitHub, Notion, Slack, benutzerdefinierte MCP-Anschlüsse und mehr hinzu.

Führt Code sicher aus

Führe Python, Pakete, Befehle und generierte Dateien in isolierten Sandboxen aus.

Visuell durchsuchen

Webseiten öffnen, klicken, tippen, scrollen und Screenshots speichern.

Medien erzeugen

Erstellen Sie Bilder, Videos, Sprache, Musik, 3D-Assets, Transkriptionen und mehr.

Modelle, verwaltet

Nutze EmpirioLabs Modelle, Poe oder deinen eigenen kompatiblen Anbieter.

OpenClaw und Hermes

OpenClaw

Ein beliebter Allround-Assistent. Ein starker Standard, wenn man sofort einen fähigen Generalagenten haben möchte.

Hermes

Ein Agent, der lernt und sich im Laufe der Zeit erinnert, sodass es für dein Team umso nützlicher wird, je mehr du es nutzt.

Pläne

Grundlegend

Eine Startlaufzeit für einen einzelnen Agenten zu 15 USD pro Monat.

Pro

Mehr Laufzeitressourcen und Headroom bei 30 USD pro Monat.

Quickstart

Setzen Sie einen Agenten ein

Wähle eine Laufzeit (openclaw oder hermes) und einen Plan und deploye dann. Die Antwort umfasst einen Agenten id und einen status.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "name": "My Assistant",
>     "agent_type": "openclaw",
>     "plan_slug": "hosted-agent-basic"
>   }'

Warten Sie, bis es läuft

Befragen Sie den Agenten, bis sein status running ist.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Verbinden und Verwenden

Senden Sie dem Agenten eine Nachricht über die API oder verbinden Sie einen Kanal und sprechen Sie von dort aus mit ihm.

Deployen und verwalten Sie mit der API

Alle Anfragen verwenden Ihren EmpirioLabs API-Schlüssel als Inhabertoken. Die Basis-URL ist https://api.empiriolabs.ai, und jeder Agent-Endpunkt befindet sich unter /v1/hosted-agents.

Setzen Sie einen Agenten ein

agent_type ist openclaw oder hermes; plan_slug ist hosted-agent-basic oder hosted-agent-pro. Standardmäßig läuft der Agent auf EmpirioLabs-Modellen; Stellen Sie default_model ein, um eine bestimmte auszuwählen, oder default_provider poe oder custom, sie auf Ihren eigenen Anbieter zu richten.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "name": "My Assistant",
>     "agent_type": "openclaw",
>     "plan_slug": "hosted-agent-basic",
>     "default_model": "qwen3-7-plus"
>   }'

Listen Sie Ihre Makler auf

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Hol dir einen Agenten

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Senden Sie eine Nachricht

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/message \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "messages": [{ "role": "user", "content": "What is on my calendar today?" }]
>   }'

Start, stopp, Neustart

Die Aktion ist das letzte Pfadsegment: start, stop, restart oder refresh.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/restart \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Einen Agenten umbenennen

$ curl -X PATCH https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "name": "Renamed Assistant" }'

Lösche einen Agenten

$ curl -X DELETE https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Konfigurieren Sie jede Einstellung aus der API

Alles, was du im Dashboard ändern kannst, ist ebenfalls über die API steuerbar, sodass du Agenten komplett programmatisch verwalten kannst.

Wechsel des Modells oder Anbieters

Ändere das Modell des Agenten (kein Redeploy). provider ist empirio, poe oder custom.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/model \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "provider": "empirio", "model": "qwen3-7-plus" }'

Fähigkeiten

Fähigkeiten sind wiederverwendbare Spielbücher, denen der Agent folgt. Durchsuche die offizielle Registry (OpenClaw nutzt ClawHub, Hermes nutzt skills.sh) und füge eine Fähigkeit anhand ihrer Referenz hinzu oder füge deine eigene ein.

$ # List installed skills
$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
$ 
$ # Add an official skill (OpenClaw: clawhub:<slug>, Hermes: hermes:<id>)
$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "slug": "hermes:openai/skills/pdf" }'
$ 
$ # Add your own pasted skill
$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "custom": { "name": "House Style", "body": "Always answer in a concise, friendly tone." } }'
$ 
$ # Remove a skill
$ curl -X DELETE "https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills?slug=hermes:openai/skills/pdf" \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Steckverbinder (MCP)

Verbinde einen entfernten MCP-Server, um dem Agenten Werkzeuge und Daten bereitzustellen.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/mcp \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "name": "my-tools", "url": "https://example.com/mcp" }'

Kanäle

Verbinden Sie einen tokenbasierten Nachrichtenkanal (zum Beispiel telegram, discord oder slack), damit die Leute mit dem Agenten dort sprechen können. Telegram, Discord, Slack und Matrix funktionieren auf OpenClaw- und Hermes-Agenten. Mattermost und Microsoft Teams sind ausschließlich OpenClaw. WhatsApp wird vom Dashboard aus mit einem QR-Code gekoppelt, anstatt mit diesem Token-Endpunkt.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/integrations \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "kind": "telegram", "secret": "YOUR_BOT_TOKEN" }'

Das Kanalverhalten steuert kleine Chat-Signale an jedem Stecker. Standardmäßig sind Tippindikatoren und minimale Verarbeitungsreaktionen aktiviert, Lesebestätigungen sind deaktiviert und Live-Antwortvorschau ist ausgeschaltet. Live-Antwortvorschau nutzt, wo verfügbar, plattformnativen Bearbeitungs- oder Entwurfsvorschauen; es ist getrennt vom Modell-API-Streaming.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/integrations/telegram/behavior \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "behavior": {
>       "reaction_level": "minimal",
>       "typing": true,
>       "read_receipts": false,
>       "streaming": false
>     }
>   }'

Wer kann dem Bot eine Nachricht schicken?

mode ist open (jeder) oder restricted (nur die Nachrichten-IDs, die du erlaubst). Mit restricted und ohne Ausweise wird die erste Person, die eine Nachricht schickt, zum Eigentümer. Fügen Sie kind hinzu, um die Regel für einen verbundenen Kanal festzulegen.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/access \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "kind": "telegram", "mode": "restricted", "allow": { "telegram": ["123456789"] } }'

Preisgestaltung

Gehostete Agenten werden pro Agent monatlich berechnet, basierend auf dem von Ihnen gewählten Plan. Basic kostet 15 USD pro Monat und Pro 30 USD pro Monat. Der Plan deckt die Laufzeit des Agenten ab. Modelle, die der Agent verwendet, werden separat zu Standard-Modellpreisen abgerechnet.

Grenzen

Jedes Konto kann eine begrenzte Anzahl von eingesetzten Agenten gleichzeitig ausführen. Ihre Dashboard-Einstellungen zeigen Ihr effektives Limit an. Kontaktieren Sie us, um Ihr Limit zu erhöhen.

White-Labeling

Du kannst gehostete Agenten in dein eigenes Produkt integrieren und sie vollständig unter deiner eigenen Marke betreiben. Die API ist unbranded: Sie rufen /v1/hosted-agents/* mit Ihrem EmpirioLabs API-Schlüssel auf und stellen den Agenten nach Belieben zur Oberfläche, sodass Ihre Endnutzer mit Ihrem Produkt interagieren, nicht mit unseren. Es gibt kein EmpirioLabs-Branding in den API-Antworten oder in den Antworten des Agenten. Für höhere Agentenbegrenzungen, eine dedizierte Kapazität oder eine individuelle kommerzielle Vereinbarung senden Sie eine E-Mail an support@empiriolabs.ai.

Nächste Schritte

Hosted Agents API Referenz

Vollständige Anfrage- und Antwortschemata für jeden gehosteten Agenten-Endpunkt.

Modelle und Preise

Durchsuchen Sie die Modelle, die Ihr Makler verwenden kann.