Naar hoofdinhoud gaan

​
Authenticatie

OpenClaw ondersteunt OAuth en API-sleutels voor modelproviders. Voor Anthropic- accounts raden we aan een API-sleutel te gebruiken. Voor toegang via een Claude-abonnement gebruik je het langlevende token dat is aangemaakt door claude setup-token. Zie /concepts/oauth voor de volledige OAuth-flow en opslagindeling.

​
Aanbevolen Anthropic-installatie (API-sleutel)

Als je Anthropic rechtstreeks gebruikt, gebruik dan een API-sleutel.
  1. Maak een API-sleutel aan in de Anthropic Console.
  2. Plaats deze op de Gateway-host (de machine waarop openclaw gateway draait).
export ANTHROPIC_API_KEY="..."
openclaw models status
  1. Als de Gateway onder systemd/launchd draait, plaats de sleutel bij voorkeur in ~/.openclaw/.env zodat de daemon deze kan lezen:
cat >> ~/.openclaw/.env <<'EOF'
ANTHROPIC_API_KEY=...
EOF
Herstart daarna de daemon (of herstart je Gateway-proces) en controleer opnieuw: 
openclaw models status
openclaw doctor
Als je liever niet zelf omgevingsvariabelen beheert, kan de onboarding-wizard API-sleutels opslaan voor gebruik door de daemon: openclaw onboard. Zie Help voor details over env-overerving (env.shellEnv, ~/.openclaw/.env, systemd/launchd).

​
Anthropic: setup-token (abonnementsauthenticatie)

Voor Anthropic is het aanbevolen pad een API-sleutel. Als je een Claude-abonnement gebruikt, wordt de setup-token-flow ook ondersteund. Voer dit uit op de Gateway-host: 
claude setup-token
Plak het vervolgens in OpenClaw: 
openclaw models auth setup-token --provider anthropic
Als het token op een andere machine is aangemaakt, plak het handmatig: 
openclaw models auth paste-token --provider anthropic
Als je een Anthropic-fout ziet zoals: 
This credential is only authorized for use with Claude Code and cannot be used for other API requests.
…gebruik dan in plaats daarvan een Anthropic API-sleutel. Handmatige tokeninvoer (elke provider; schrijft auth-profiles.json + werkt de config bij): 
openclaw models auth paste-token --provider anthropic
openclaw models auth paste-token --provider openrouter
Automatiseringsvriendelijke controle (exit 1 bij verlopen/ontbrekend, 2 bij bijna verlopen): 
openclaw models status --check
Optionele ops-scripts (systemd/Termux) zijn hier gedocumenteerd: /automation/auth-monitoring
claude setup-token vereist een interactieve TTY.

​
Controleren van modelauthenticatiestatus

openclaw models status
openclaw doctor

​
Controleren welke referenties worden gebruikt

​
Per sessie (chatopdracht)

Gebruik /model <alias-or-id>@<profileId> om een specifieke provider-inloggegevens vast te zetten voor de huidige sessie (voorbeeldprofiel-id’s: anthropic:default, anthropic:work). Gebruik /model (of /model list) voor een compacte keuzelijst; gebruik /model status voor de volledige weergave (kandidaten + volgend authenticatieprofiel, plus provider-endpointdetails indien geconfigureerd).

​
Per agent (CLI-override)

Stel een expliciete volgorde-override voor authenticatieprofielen in voor een agent (opgeslagen in de auth-profiles.json van die agent): 
openclaw models auth order get --provider anthropic
openclaw models auth order set --provider anthropic anthropic:default
openclaw models auth order clear --provider anthropic
Gebruik --agent <id> om een specifieke agent te targeten; laat dit weg om de geconfigureerde standaardagent te gebruiken.

​
Problemen oplossen

​
“Geen inloggegevens gevonden”

Als het Anthropic-tokenprofiel ontbreekt, voer claude setup-token uit op de Gateway-host en controleer daarna opnieuw: 
openclaw models status

​
Token verloopt/verlopen

Voer openclaw models status uit om te bevestigen welk profiel verloopt. Als het profiel ontbreekt, voer claude setup-token opnieuw uit en plak het token opnieuw.

​
Provideropties

  • Claude Max- of Pro-abonnement (voor claude setup-token)
  • Claude Code CLI geïnstalleerd (claude-opdracht beschikbaar)