Authentifizierung in OpenClaw einrichten

Authentifizierung ist oft der nervigste Teil beim Setup neuer Tools. Man schlägt sich mit abgelaufenen Tokens herum oder sucht nach Umgebungsvariablen, die der Daemon plötzlich nicht mehr findet. Wenn der Workflow unterbrochen wird, nur weil eine Berechtigung fehlt, kostet das unnötig Zeit.

OpenClaw macht es dir hier einfach, solange du weißt, welchen Weg du wählen musst. Für Anthropic-Accounts empfehle ich dir klar den API Key. Wenn du Claude über eine Subscription nutzt, ist der setup-token Flow die richtige Wahl.

Voraussetzungen

• Claude Max oder Pro Subscription (für claude setup-token)
• Installierte Claude Code CLI (der claude Befehl muss verfügbar sein)

Schnellstart

Wenn du Anthropic direkt nutzt, nimm einen API Key. Das ist der stabilste Weg für deinen Gateway.

1. Erstelle einen API Key in der Anthropic Console.
2. Hinterlege ihn auf dem gateway host (die Maschine, auf der openclaw gateway läuft).

export ANTHROPIC_API_KEY="..."
openclaw models status

Falls dein Gateway unter systemd oder launchd läuft, schreib den Key am besten direkt in die ~/.openclaw/.env, damit der Daemon ihn lesen kann:

cat >> ~/.openclaw/.env <<'EOF'
ANTHROPIC_API_KEY=...
EOF

Starte danach den Daemon (oder deinen Gateway-Prozess) neu und prüfe die Verbindung:

openclaw models status
openclaw doctor

Wenn du keine Lust hast, Umgebungsvariablen manuell zu verwalten, nutzt du einfach den Onboarding-Wizard: openclaw onboard.

Alternative: Anthropic setup-token

Für Claude Subscriptions wird der setup-token Flow unterstützt. Führe diesen Befehl auf dem gateway host aus:

claude setup-token

Kopiere den Token und füge ihn in OpenClaw ein:

openclaw models auth setup-token --provider anthropic

Sollte der Token auf einer anderen Maschine erstellt worden sein, kannst du ihn manuell einfügen:

openclaw models auth paste-token --provider anthropic

Hinweis: Erhältst du eine Fehlermeldung, dass die Credentials nur für Claude Code autorisiert sind, musst du stattdessen einen Anthropic API Key verwenden.

Credentials steuern

Du kannst genau festlegen, welche Credentials für welche Session oder welchen Agent genutzt werden.

Pro Session

Mit dem Chat-Befehl /model <alias-or-id>@<profileId> pinnst du ein Credential für die aktuelle Session (z. B. anthropic:work). Nutze /model status, um die Details zum Provider Endpoint und dem nächsten Auth-Profil zu sehen.

Pro Agent

Du kannst die Reihenfolge der Auth-Profile für einen Agent überschreiben. Dies wird in der auth-profiles.json des Agents gespeichert:

openclaw models auth order get --provider anthropic
openclaw models auth order set --provider anthropic anthropic:default
openclaw models auth order clear --provider anthropic

Fehlerbehebung

„No credentials found“

Wenn das Anthropic-Profil fehlt, führe claude setup-token auf dem gateway host aus. Prüfe danach den Status mit:

openclaw models status

Token läuft ab oder ist abgelaufen

Nutze openclaw models status, um zu sehen, welches Profil betroffen ist. Falls das Profil fehlt, generiere mit claude setup-token einen neuen Token und füge ihn erneut ein.

Für die Automatisierung kannst du den Status-Check nutzen, der Exit-Codes für Monitoring-Scripts liefert:

openclaw models status --check

Du brauchst Hilfe beim Setup? Frag den AI Setup Assistant.

Nächste Schritte

• /concepts/oauth
• /automation/auth-monitoring
• /help