> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Anthropic

# Anthropic (Claude)

Anthropic builds the **Claude** model family and provides access via an API.
In OpenClaw you can authenticate with an API key or a **setup-token**.

## विकल्प A: Anthropic API कुंजी

**Best for:** standard API access and usage-based billing.
Create your API key in the Anthropic Console.

### CLI सेटअप

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard
# choose: Anthropic API key

# or non-interactive
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
```

### कॉन्फ़िग स्निपेट

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
```

## प्रॉम्प्ट कैशिंग (Anthropic API)

OpenClaw supports Anthropic's prompt caching feature. This is **API-only**; subscription auth does not honor cache settings.

### कॉन्फ़िगरेशन

अपने मॉडल विन्यास में `cacheRetention` पैरामीटर का उपयोग करें:

| मान     | कैश अवधि   | Description                        |
| ------- | ---------- | ---------------------------------- |
| `none`  | No caching | Prompt caching अक्षम करें          |
| `short` | 5 minutes  | API Key प्रमाणीकरण के लिए डिफ़ॉल्ट |
| `long`  | 1 hour     | विस्तारित कैश (beta फ़्लैग आवश्यक) |

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}
```

### Defaults

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.

### Legacy parameter

पुराना `cacheControlTtl` पैरामीटर पिछड़े अनुकूलन के लिए अभी भी समर्थित है:

* `"5m"` का मैपिंग `short` से होता है
* `"1h"` का मैपिंग `long` से होता है

हम नए `cacheRetention` पैरामीटर पर माइग्रेट करने की अनुशंसा करते हैं।

OpenClaw में Anthropic API अनुरोधों के लिए `extended-cache-ttl-2025-04-11` beta फ़्लैग शामिल है; यदि आप प्रदाता हेडर ओवरराइड करते हैं तो इसे बनाए रखें (देखें [/gateway/configuration](/gateway/configuration))।

## विकल्प B: Claude setup-token

**उपयुक्त:** अपनी Claude सब्सक्रिप्शन का उपयोग करने के लिए।

### setup-token कहाँ प्राप्त करें

Setup-tokens are created by the **Claude Code CLI**, not the Anthropic Console. You can run this on **any machine**:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
claude setup-token
```

टोकन को OpenClaw में पेस्ट करें (विज़ार्ड: **Anthropic token (paste setup-token)**), या इसे Gateway होस्ट पर चलाएँ:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth setup-token --provider anthropic
```

यदि आपने टोकन किसी दूसरी मशीन पर बनाया है, तो उसे पेस्ट करें:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth paste-token --provider anthropic
```

### CLI सेटअप (setup-token)

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
# Paste a setup-token during onboarding
openclaw onboard --auth-choice setup-token
```

### Config snippet (setup-token)

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
```

## Notes

* `claude setup-token` के साथ setup-token जनरेट करें और उसे पेस्ट करें, या Gateway होस्ट पर `openclaw models auth setup-token` चलाएँ।
* If you see “OAuth token refresh failed …” on a Claude subscription, re-auth with a setup-token. See [/gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription](/gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription).
* प्रमाणीकरण विवरण + पुनः उपयोग नियम [/concepts/oauth](/concepts/oauth) में हैं।

## Troubleshooting

**401 त्रुटियाँ / टोकन अचानक अमान्य**

* Claude subscription auth can expire or be revoked. Re-run `claude setup-token`
  and paste it into the **gateway host**.
* यदि Claude CLI लॉगिन किसी दूसरी मशीन पर है, तो Gateway होस्ट पर
  `openclaw models auth paste-token --provider anthropic` का उपयोग करें।

**प्रदाता "anthropic" के लिए कोई API कुंजी नहीं मिली**

* Auth is **per agent**. New agents don’t inherit the main agent’s keys.
* उस एजेंट के लिए onboarding पुनः चलाएँ, या Gateway होस्ट पर setup-token / API कुंजी पेस्ट करें,
  फिर `openclaw models status` के साथ सत्यापित करें।

**प्रोफ़ाइल `anthropic:default` के लिए कोई क्रेडेंशियल नहीं मिले**

* यह देखने के लिए `openclaw models status` चलाएँ कि कौन-सा auth प्रोफ़ाइल सक्रिय है।
* onboarding पुनः चलाएँ, या उस प्रोफ़ाइल के लिए setup-token / API कुंजी पेस्ट करें।

**कोई उपलब्ध auth प्रोफ़ाइल नहीं (सभी cooldown/अनुपलब्ध)**

* `openclaw models status --json` में `auth.unusableProfiles` की जाँच करें।
* कोई अन्य Anthropic प्रोफ़ाइल जोड़ें या cooldown समाप्त होने की प्रतीक्षा करें।

और अधिक: [/gateway/troubleshooting](/gateway/troubleshooting) और [/help/faq](/help/faq)।