Zum Hauptinhalt springen
NanoClaw ist ein leichtgewichtiges, containerisiertes persönliches KI-Agentenprogramm – eine kompaktere Variante zu OpenClaw – das Verbindungen zu WhatsApp, Telegram, Slack, Discord sowie E-Mail herstellt und über Funktionen wie Speicherverwaltung sowie zeitgesteuerte Aufgaben verfügt. Es nutzt Anthropic’s Claude Agent SDK und verweist daher über die mit Anthropic kompatible Schnittstelle auf Tokios: Setzen Sie ANTHROPIC_BASE_URL auf https://api.tokios.com, sodass der Agent von NanoClaw auf einem Modell an Ihrer eigenen Hardware arbeitet.
NanoClaw nutzt die Anthropic-API-Oberfläche, daher ist die Basis-URL der reine Host https://api.tokios.com ohne /v1 – dieselbe Form wie bei Claude Code. Das ist das Gegenteil der OpenAI-artigen Clients, die /v1 benötigen.

Voraussetzungen

Connector erfolgreich gepaart

Installieren und paaren Sie tokios-connector in der Nähe des Modells, mit dem NanoClaw kommunizieren soll.

Modell erfolgreich registriert

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

API-Schlüssel erfolgreich erstellt

Erstellen Sie einen sk-tok-…-Schlüssel; optional lässt sich dieser auf jene Deployment-Bezeichnung beschränken.

Unterstützte Backends

Stellen Sie sicher, dass Ihr lokales Backend – Ollama, llama.cpp, vLLM oder LM Studio – aktiv läuft.

Richten Sie das Backend von NanoClaw auf Tokios aus.

1

Öffnen Sie die .env-Datei von NanoClaw.

Bearbeiten Sie die Datei .env innerhalb Ihrer NanoClaw-Installation.
2

Geben Sie die Basis-URL sowie den API-Schlüssel von Anthropic ein.

Konfigurieren Sie das Backend des Claude Agent SDK so, dass es Tokios nutzt:
.env
Ihr sk-tok-…-Schlüssel wird in ANTHROPIC_AUTH_TOKEN eingetragen – das ist der Bearer-Token, den das SDK übermittelt. Auf die Basis-URL darf kein /v1 folgen.
3

Wählen Sie Ihre Deployment-Instanz als Modell aus.

Legen Sie als Modellnamen den öffentlichen Deployment-Namen fest, den Sie in der Models-Registerkarte angegeben haben – beispielsweise gemma-tunnel. NanoClaw verwendet standardmäßig die Namen von Claude-Modellen; sobald es auf Tokios verweist, muss der angeforderte Modellname Ihr Deployment-Name sein. Die genaue Konfiguration pro Agentengruppe hängt von der NanoClaw-Version ab – prüfen Sie diese bitte.
4

Starten Sie NanoClaw neu.

Starten Sie NanoClaw – oder dessen Container – erneut, damit die Änderungen an .env übernommen werden. Anschließend läuft der Agent auf Ihrem Modell über Tokios.
NanoClaw kann mittels optionaler Skills auch OpenAI-kompatible oder lokale Backends nutzen – etwa /add-opencode für OpenAI/OpenRouter oder /add-ollama-provider. In solchen Fällen sollte stattdessen die OpenAI-Basis https://api.tokios.com/v1 verwendet werden. Geben Sie niemals einen echten sk-tok-…-API-Schlüssel in das Versionskontrollsystem ein.

Ein privater Agent für ein privates Modell

NanoClaw betreibt seine Claude-Agenten in isolierten Containern auf Ihrem eigenen Rechner; Tokios stellt für jedes genutzte Modell einen stabilen, authentifizierten Endpunkt bereit. Der Connector zu diesem Modell verbindet sich mit Tokios, und NanoClaw erreicht ihn über https://api.tokios.com mittels Ihres Tokens – ein selbstgehosteter Assistent für ein selbstgehostetes Modell, ohne dass dazu eingehende Ports oder VPNs nötig sind.

Fehlerbehebung

Das von NanoClaw gesendete Token fehlt, ist fehlerhaft oder wurde widerrufen. Stellen Sie sicher, dass ANTHROPIC_AUTH_TOKEN den vollständigen sk-tok-…-API-Schlüssel ohne zusätzliche Leerzeichen enthält, und prüfen Sie dessen Status im Reiter Keys.
Das Modell stimmt nicht mit einer registrierten Deployment-Instanz überein, oder es ist versehentlich ein /v1 in die Basis-URL gelangt. Vergewissern Sie sich, dass das Modell exakt dem öffentlichen Deployment-Namen aus dem Reiter Models entspricht und dass ANTHROPIC_BASE_URL lediglich den reinen https://api.tokios.com-Wert ohne jegliche /v1-Angaben enthält.
Der Connector für diese Deployment-Instanz ist offline oder hat seine Konkurrenzgrenze erreicht. Überprüfen Sie den Reiter Connectors – dort muss der Connector als Online angezeigt werden, und der Rechner, auf dem er läuft, muss weiterhin erreichbar sein.

Weitere Schritte

Nutzen Sie Claude Code

Derselbe Basis-URL- und Schlüsselmuster, der mit Anthropic kompatibel ist, für die Claude Code CLI.

API-Schlüssel

Erstellen, definieren und rotieren Sie sk-tok-… API-Schlüssel für Teammitglieder sowie Agenten.