Anthropic builds the Claude model family and provides access via an API and Claude CLI. In OpenClaw, Anthropic API keys and Claude CLI reuse are both supported. Existing legacy Anthropic token profiles are still honored at runtime if they are already configured.
Option A: Anthropic API key
Best for: standard API access and usage-based billing. Create your API key in the Anthropic Console.
CLI setup
openclaw onboard # choose: Anthropic API key # or non-interactive openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
Anthropic config snippet
{ env : { ANTHROPIC_API_KEY : "sk-ant-..." } , agents : { defaults : { model : { primary : "anthropic/claude-opus-4-6" } } } , }
Thinking defaults (Claude 4.6)
Anthropic Claude 4.6 models default to adaptive thinking in OpenClaw when no explicit thinking level is set.
thinking in OpenClaw when no explicit thinking level is set. You can override per-message ( /think:<level> ) or in model params: agents.defaults.models["anthropic/<model>"].params.thinking .
) or in model params: . Related Anthropic docs: Adaptive thinking Extended thinking
Fast mode (Anthropic API)
OpenClaw’s shared /fast toggle also supports direct public Anthropic traffic, including API-key and OAuth-authenticated requests sent to api.anthropic.com .
/fast on maps to service_tier: "auto"
maps to /fast off maps to service_tier: "standard_only"
maps to Config default:
{ agents : { defaults : { models : { "anthropic/claude-sonnet-4-6" : { params : { fastMode : true } , } , } , } , } , }
Important limits:
OpenClaw only injects Anthropic service tiers for direct api.anthropic.com requests. If you route anthropic/* through a proxy or gateway, /fast leaves service_tier untouched.
requests. If you route through a proxy or gateway, leaves untouched. Explicit Anthropic serviceTier or service_tier model params override the /fast default when both are set.
or model params override the default when both are set. Anthropic reports the effective tier on the response under usage.service_tier . On accounts without Priority Tier capacity, service_tier: "auto" may still resolve to standard .
Prompt caching (Anthropic API)
OpenClaw supports Anthropic’s prompt caching feature. This is API-only; legacy Anthropic token auth does not honor cache settings.
Use the cacheRetention parameter in your model config:
Value Cache Duration Description none No caching Disable prompt caching short 5 minutes Default for API Key auth long 1 hour Extended cache
{ agents : { defaults : { models : { "anthropic/claude-opus-4-6" : { params : { cacheRetention : "long" } , } , } , } , } , }
When using Anthropic API Key authentication, OpenClaw automatically applies cacheRetention: "short" (5-minute cache) for all Anthropic models. You can override this by explicitly setting cacheRetention in your config.
Per-agent cacheRetention overrides
Use model-level params as your baseline, then override specific agents via agents.list[].params .
{ agents : { defaults : { model : { primary : "anthropic/claude-opus-4-6" } , models : { "anthropic/claude-opus-4-6" : { params : { cacheRetention : "long" } , // baseline for most agents } , } , } , list : [ { id : "research" , default : true } , { id : "alerts" , params : { cacheRetention : "none" } } , // override for this agent only ] , } , }
Config merge order for cache-related params:
agents.defaults.models["provider/model"].params agents.list[].params (matching id , overrides by key)
This lets one agent keep a long-lived cache while another agent on the same model disables caching to avoid write costs on bursty/low-reuse traffic.
Bedrock Claude notes
Anthropic Claude models on Bedrock ( amazon-bedrock/*anthropic.claude* ) accept cacheRetention pass-through when configured.
) accept pass-through when configured. Non-Anthropic Bedrock models are forced to cacheRetention: "none" at runtime.
at runtime. Anthropic API-key smart defaults also seed cacheRetention: "short" for Claude-on-Bedrock model refs when no explicit value is set.
1M context window (Anthropic beta)
Anthropic’s 1M context window is beta-gated. In OpenClaw, enable it per model with params.context1m: true for supported Opus/Sonnet models.
{ agents : { defaults : { models : { "anthropic/claude-opus-4-6" : { params : { context1m : true } , } , } , } , } , }
OpenClaw maps this to anthropic-beta: context-1m-2025-08-07 on Anthropic requests.
This only activates when params.context1m is explicitly set to true for that model.
Requirement: Anthropic must allow long-context usage on that credential.
Note: Anthropic currently rejects context-1m-* beta requests when using legacy Anthropic token auth ( sk-ant-oat-* ). If you configure context1m: true with that legacy auth mode, OpenClaw logs a warning and falls back to the standard context window by skipping the context1m beta header while keeping the required OAuth betas.
Claude CLI backend
The bundled Anthropic claude-cli backend is supported in OpenClaw.
Anthropic staff told us this usage is allowed again.
OpenClaw therefore treats Claude CLI reuse and claude -p usage as sanctioned for this integration unless Anthropic publishes a new policy.
usage as sanctioned for this integration unless Anthropic publishes a new policy. Anthropic API keys remain the clearest production path for always-on gateway hosts and explicit server-side billing control.
Setup and runtime details are in /gateway/cli-backends.
Anthropic’s public Claude Code docs still document direct CLI usage such as claude -p , and Anthropic staff told us OpenClaw-style Claude CLI usage is allowed again. We are treating that guidance as settled unless Anthropic publishes a new policy change.
, and Anthropic staff told us OpenClaw-style Claude CLI usage is allowed again. We are treating that guidance as settled unless Anthropic publishes a new policy change. Anthropic setup-token remains available in OpenClaw as a supported token-auth path, but OpenClaw now prefers Claude CLI reuse and claude -p when available.
when available. Auth details + reuse rules are in /concepts/oauth.
401 errors / token suddenly invalid
Anthropic token auth can expire or be revoked.
For new setup, migrate to an Anthropic API key.
No API key found for provider “anthropic”
Auth is per agent . New agents don’t inherit the main agent’s keys.
. New agents don’t inherit the main agent’s keys. Re-run onboarding for that agent, or configure an API key on the gateway host, then verify with openclaw models status .
No credentials found for profile anthropic:default
Run openclaw models status to see which auth profile is active.
to see which auth profile is active. Re-run onboarding, or configure an API key for that profile path.
No available auth profile (all in cooldown/unavailable)