Clients/Hermes Agent

Wokey API mit Hermes Agent nutzen

Hol dir einen Wokey-API-Key, trag in Hermes Agent die Base URL von Wokey ein und prüf die Verbindung mit einer curl-Anfrage.

Aktualisiert

Auf dieser Seiteexpand_more

API-Key und Base URL bereitlegenlink

Alle Clients nutzen denselben Wokey-API-Key und dieselbe Base URL.

API-Key erstellen

Melde dich an und erstelle auf der API-Seite einen Plattform-Key. Alle Keys eines Kontos teilen sich dessen Guthaben.

API-Key erstellenkey

Base URL von Wokey verwenden

Trag als Base URL des Clients die Gateway-Domain ein; die Konfiguration unten zeigt, ob /v1 angehängt wird.

Client einrichtenlink

Hermes Agent braucht nur die ersten fünf Konfigurationszeilen für Modell, eigenen Provider, Base URL und API-Key. Für GPT-Modelle (etwa gpt-6-sol) ergänze api_mode: codex_responses für die beste Cache-Trefferquote; bei anderen Modellen wie Claude lass es weg.

Hermes Agent
# ~/.hermes/config.yaml
model:
  default: claude-opus-5-5
  provider: custom
  base_url: https://api.wokey.ai
  api_key: YOUR_API_KEY
  # Nur für GPT-Modelle (etwa gpt-6-sol) – für die beste Cache-Trefferquote einkommentieren:
  # api_mode: codex_responses

API-Formate und Base URLslink

Wechselt ein Client das API-Format, kann sich ändern, ob die Base URL auf /v1 endet.

FormatBase URLGeeignet für
OpenAI Chat Completionshttps://api.wokey.aiDeepSeek, GLM, Kimi und andere Modelle

Wo es konfiguriert wird: ~/.hermes/config.yaml

Hermes Agent mit Opus 5.5 als Always-on-Agent betreiben: der Vergleich mit Claude Duetlink

Am 2026-10-21 hat Anthropic die Research Preview von Claude Duet gestartet: ein proaktiver Agent auf Basis von Claude Opus 5.5, der dir morgens ein Briefing schickt, im Hintergrund deine verbundenen Apps im Blick behält und nachfragt, bevor er handelt. Duet funktioniert nur mit der Anmeldung über ein Claude-Konto; es gibt weder einen API-Key noch eine eigene Base URL, über Wokey lässt es sich also nicht betreiben. Hermes Agent ist ein selbst gehosteter Open-Source-Agent, der dauerhaft läuft: Mit Wokey verbunden nutzt er dasselbe Modell Opus 5.5 – ohne Warteliste und ohne regionale Beschränkung.

Claude DuetHermes Agent + Wokey
ModellClaude Opus 5.5, nicht wechselbarclaude-opus-5-5 oder jedes andere Modell auf Wokey
Wer es nutzen kannAbonnenten von Claude Pro und Max in den USA, per Warteliste; Team und Enterprise noch nichtDu installierst es selbst; ein Wokey-API-Key genügt, in jeder Region
KostenWährend der Preview ohne Aufpreis, teilt sich aber die Nutzungslimits deines Tarifs mit Chat und Claude Code – Hintergrundprüfungen eingeschlossenAbrechnung pro Token über dein Wokey-Guthaben; wie oft er prüft, legst du fest
Wo es läuftEine virtuelle Maschine mit eigenem Browser in der Cloud von Anthropic; arbeitet weiter, auch wenn Handy und Laptop aus sindDein eigener Rechner oder Server; für den Betrieb rund um die Uhr auf einer Maschine hosten, die immer läuft
Wie du mit ihm sprichstDie Duet-App (iOS und Android) und claude.aiChat-Apps wie Telegram und Slack
Gedächtnis und ToolsÜbernimmt Gedächtnis, Skills und Konnektoren deines Claude-KontosGedächtnis, Skills und Tools liegen lokal; du installierst und verwaltest sie selbst
Bestätigung vor AktionenFragt nach, bevor er Nachrichten sendet, bezahlt, unterschreibt oder löscht; Wertpapierhandel und Überweisungen zwischen Konten sind grundsätzlich ausgeschlossenBerechtigungen und Bestätigungsregeln legst du fest; gib nur die Konten frei, die er braucht
  • Bei Abrechnung pro Token kosten häufige Prüfungen mehr: Jede Prüfung sendet System-Prompt und Gedächtnis erneut. Nimm für Routineprüfungen ein günstigeres Modell (etwa claude-sonnet-5-5 oder deepseek-v4.1-flash) und wechsle für Entscheidungen und Aktionen zu Opus 5.5.
  • Über Chat Completions denkt Opus 5.5 nach, bevor es schreibt – das erste Token kommt also spät; ein Agent, der im Hintergrund arbeitet, merkt davon kaum etwas.
  • Die Konfiguration oben nutzt bereits standardmäßig claude-opus-5-5; du musst nichts ändern.

Angaben zu Duet geprüft am 2026-10-22 · Quellen zu Duet: Introducing Claude Duet · Claude Duet FAQ

Mit curl prüfenlink

Meldet der Client einen Fehler, schließ zuerst mit curl Probleme mit Key und Base URL aus.

Hermes Agent nutzt standardmäßig das Format OpenAI Chat Completions. Antwortet diese Anfrage mit 200, stimmen Key und Base URL. Ersetze vor dem Senden YOUR_API_KEY durch deinen Key.

cURL
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-sol",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Fehler und Fehlerbehebunglink

Unterscheide zuerst zwischen Authentifizierung, Guthaben, Rate-Limit, nicht verfügbarem Modell und Upstream-Timeout.

401

invalid api key

Der Key fehlt, ist falsch geschrieben oder gelöscht, oder die Header Authorization und x-api-key widersprechen sich.

402

insufficient balance

Das Guthaben des Kontos reicht nicht aus. Lade Guthaben auf, bevor du weitere Anfragen sendest.

403

model_denylisted / account_restricted

Aufrufe des Modells oder aller Modelle des Kontos sind nach wiederholten Verstößen pausiert. Siehe „Bearbeitungsgebühren für Verstöße und Einschränkungen“.

403

request_blocked

Diese Anfrage wurde blockiert, bevor sie den Upstream erreicht hat, und wird nicht berechnet – etwa das unveränderte erneute Senden einer Anfrage, die das Modell gerade abgelehnt hat, oder ein pausierter Endnutzer (X-End-User-Id). Die Fehlermeldung nennt, was blockiert ist; ändere die Anfrage entsprechend oder versuch es später erneut. Andere Anfragen sind nicht betroffen.

429

rate limited

Zu viele Anfragen in kurzer Zeit. Versuch es später erneut oder verringere die Parallelität. Liefert nur ein Modell oder ein Endnutzer (X-End-User-Id) dauerhaft 429, kann das ein vorübergehendes Limit nach Verstößen sein.

499

client disconnected

Der Client hat die Verbindung geschlossen, bevor die Antwort fertig war (Code downstream_aborted). Das ist standardmäßig kostenlos. Hat ein Konto in den letzten 24 Stunden mindestens 50 Client-Abbrüche und machen diese 10 % oder mehr seiner Anfragen aus, werden spätere abgebrochene Anfragen nach der vom Upstream gemeldeten Nutzung berechnet: die verarbeitete Eingabe einschließlich Cache-Lesen und Cache-Schreiben sowie Ausgabe nur, wenn der Upstream sie gezählt hat. Ein Abbruch, bevor der Upstream Nutzung gemeldet hat, bleibt kostenlos. Das Konto wird benachrichtigt, wenn die Berechnung beginnt, und sie endet automatisch innerhalb einer Stunde, sobald die Abbruchquote wieder normal ist. Die übliche Ursache ist ein zu kurzer Timeout im Client oder Proxy oder ein Programm, das Anfragen abbricht, bevor sie fertig sind.

502

upstream unavailable

Der Upstream-Modelldienst ist vorübergehend nicht verfügbar. Wechsle das Modell oder versuch es später erneut.

504

upstream timeout

Die Antwort des Upstreams hat zu lange gedauert. Kürze den Kontext, verringere max_tokens oder versuch es erneut.

529

upstream overloaded

Das Upstream-Modell ist vorübergehend überlastet, und Wokey hat es bereits über andere Routen erneut versucht (Code upstream_overloaded). Mit deinem Guthaben hat das nichts zu tun. Versuch es in Kürze erneut oder wechsle das Modell.

Häufige Fragenlink

Soll die base_url von Hermes Agent auf /v1 enden?
Nein. Setze base_url auf https://api.wokey.ai und provider auf custom.
Wann ergänze ich api_mode: codex_responses?
Nur bei GPT-Modellen wie gpt-6-sol, dort bringt es die beste Cache-Trefferquote. Bei Claude und anderen Modellen lässt du die Zeile weg.
Wohin gehört der API-Key?
In das Feld api_key unter model in ~/.hermes/config.yaml, und zwar nur der Key selbst.