Zum Hauptinhalt springen
OpenClaw ist ein selbst gehosteter, Open-Source-basierter persönlicher KI-Agent, den Sie über WhatsApp, Telegram, Discord sowie weitere Messaging-Plattformen nutzen können; er unterstützt zudem MCP-Tools. Das zu verwendende Modell wird aus der Konfiguration providers ausgewählt – fügen Sie einen benutzerdefinierten OpenAI-kompatiblen Anbieter hinzu, der auf https://api.tokios.com/v1 verweist, und geben Sie dazu Ihren sk-tok-… API-Schlüssel an; daraufhin läuft der Agent auf Ihrer eigenen Hardware.

Voraussetzungen

Connector erfolgreich gekoppelt

Installieren und koppeln Sie tokios-connector neben dem Modell, das OpenClaw nutzen soll.

Modell erfolgreich registriert

Erstellen Sie eine Deployment-Bezeichnung (öffentlicher Name) für dieses Modell.

API-Schlüssel erfolgreich erstellt

Erstellen Sie einen sk-tok-… API-Schlüssel – optional auch auf dieses Deployment beschränkt.

Unterstützte Backends

Stellen Sie sicher, dass Ihre lokale Backend-Instanz (Ollama, llama.cpp, vLLM oder LM Studio) aktiv ist.

Fügen Sie Tokios als Modell-Anbieter hinzu.

1

Öffnen Sie die OpenClaw-Konfiguration.

Bearbeiten Sie die OpenClaw-Einstellungen; dort werden die Modell-Anbieter unter models.providers aufgelistet. Der genaue Dateipfad hängt von Ihrer Installation ab – prüfen Sie bitte Ihre OpenClaw-Konfiguration.
2

Erstellen Sie einen neuen Tokios-Anbieter.

Erstellen Sie einen neuen Eintrag für den Anbieter, wobei Sie api mit openai-completions belegen, baseUrl auf Tokios verweisen lassen und Ihre Deployment-Informationen unter models eintragen:
Der Wert von id unter models entspricht dem öffentlichen Deployment-Namen aus dem Models-Reiter; es handelt sich nicht um die lokale Upstream-Modell-ID Ihres Backends.
3

Weisen Sie dieses Deployment dem Agenten als Modell zu.

Legen Sie im Agenten das Standard-Modell auf den soeben hinzugefügten Anbieter fest, indem Sie die Form <provider>/<model-id> verwenden:
4

Geben Sie nun Ihren API-Schlüssel ein.

Setzen Sie in Ihrer Umgebung die Variable TOKIOS_API_KEY auf Ihren sk-tok-…-Schlüssel; kopieren Sie ihn nicht direkt in die Konfigurationsdatei. Starten Sie anschließend OpenClaw neu, damit die Änderungen übernommen werden.
Ersetzen Sie gemma-tunnel durch den von Ihnen registrierten Deployment-Namen und legen Sie TOKIOS_API_KEY auf Ihren eigenen sk-tok-…-Schlüssel fest. Geben Sie niemals einen echten Schlüssel in die Konfigurationsdatei ein. Falls gewünscht, kann OpenClaw auch die Anthropic-Schnittstelle nutzen; dazu müssen Sie api: "anthropic-messages" mit baseUrl: "https://api.tokios.com" belegen (/v1 ist dabei nicht erforderlich).

Ihr persönlicher Assistent – Ihr Modell

OpenClaw ist der Agent, mit dem Sie über Ihr Handy kommunizieren; Tokios stellt für jedes von Ihnen genutzte Modell einen stabilen, authentifizierten Endpunkt bereit. Der Connector neben dem jeweiligen Modell verbindet sich mit Tokios, und OpenClaw ruft https://api.tokios.com/v1 mithilfe Ihres API-Schlüssels auf – so läuft Ihr persönlicher Assistent auf einem von Ihnen gehosteten Modell, ohne dass ein eingehender Port oder eine VPN-Verbindung erforderlich ist.

Fehlerbehebung

Der von OpenClaw übermittelte API-Schlüssel fehlt, ist fehlerhaft oder wurde widerrufen. Stellen Sie sicher, dass TOKIOS_API_KEY den vollständigen sk-tok-…-Schlüssel enthält, ohne zusätzliche Leerzeichen, und prüfen Sie dessen Status im Bereich Keys.
Die Upstream-Modell-ID stimmt nicht mit einer registrierten Deployment-Instanz überein, oder es fehlt in baseUrl der Eintrag /v1. Vergewissern Sie sich, dass die in models angegebene ID dem öffentlichen Namen im Bereich Models entspricht sowie dass der Wert von baseUrl genau https://api.tokios.com/v1 lautet.
Der Connector für diese Deployment-Instanz ist offline oder hat die maximale Konkurrenzgrenze erreicht. Überprüfen Sie den Bereich Connectors – dort muss der Connector als Online angezeigt werden, und der dafür genutzte Rechner muss weiterhin aktiv sowie erreichbar sein.

Weitere Schritte

Kompatible Clients

Weitere Informationen zur Basis-URL sowie zur Einrichtung des API-Schlüssels für andere OpenAI- und Anthropic-kompatible Clients finden Sie hier.

API-Schlüssel

Erstellen Sie, legen Sie den Gültigkeitsbereich fest und rotieren Sie sk-tok-…-Schlüssel für Teammitglieder sowie Agenten.