OpenClaw Auth-Profile verwalten: Zugriff effizient steuern

Kennst du das? Du jonglierst mit verschiedenen API-Keys für unterschiedliche Projekte oder Accounts und verlierst ständig den Überblick, welcher Key gerade aktiv ist oder warum eine Anfrage fehlschlägt. Das Management von Zugangsdaten kann schnell nervig werden, besonders wenn verschiedene Provider und Abrechnungsmodelle ins Spiel kommen.

Auth Profiles

In diesem Guide erfährst du, wie Auth Profiles funktionieren und wie du deine Credentials effizient verwaltest.

Was ist ein Auth Profile?

Ein Auth Profile ist ein benannter Datensatz für Zugangsdaten (OAuth oder API-Key), der fest mit einem Provider verknüpft ist. Diese Profile werden hier gespeichert:

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

Was sind typische Profile-IDs?

OpenClaw nutzt IDs mit Provider-Präfix, zum Beispiel:

• anthropic:default (oft genutzt, wenn keine E-Mail-Identität vorhanden ist)
• anthropic:<email> für OAuth-Identitäten
• Eigene IDs, die du selbst wählst (z. B. anthropic:work)

Kann ich steuern, welches Auth Profile zuerst versucht wird?

Ja. Die Config unterstützt optionale Metadaten für Profile und eine festgelegte Reihenfolge pro Provider (auth.order.<provider>).

OpenClaw überspringt ein Profil eventuell kurzzeitig, wenn es sich in einem kurzen Cooldown befindet (Rate Limits, Timeouts oder Auth-Fehler). Es kann auch dauerhaft deaktiviert sein, falls Probleme mit der Abrechnung oder zu wenig Guthaben vorliegen.

Um das zu prüfen, führst du openclaw models status --json aus und schaust unter auth.unusableProfiles nach.

Reihenfolge pro Agent festlegen:

# Lock rotation to a single profile
openclaw models auth order set --provider anthropic anthropic:default

# Set an explicit order (fallback within provider)
openclaw models auth order set --provider anthropic anthropic:work anthropic:default

# Clear override
openclaw models auth order clear --provider anthropic

OAuth vs API Key – was ist der Unterschied?

OpenClaw unterstützt beides:

• OAuth nutzt oft bestehende Abonnements (sofern verfügbar).
• API-Keys rechnen nach verbrauchten Token ab (Pay-per-Token).

Der Wizard unterstützt explizit das Anthropic Setup-Token sowie OpenAI Codex OAuth und speichert deine API-Keys sicher ab.

Nächste Schritte

• Modelle konfigurieren
• Agenten-Setup

AI Setup Assistant