12 KiB
12 KiB
| read_when | summary | title | x-i18n | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Anthropic Claude über API-Schlüssel oder die Claude CLI in OpenClaw verwenden | Anthropic |
|
Anthropic entwickelt die Modellfamilie Claude. OpenClaw unterstützt zwei Authentifizierungswege:
- API-Schlüssel — direkter Anthropic-API-Zugriff mit nutzungsbasierter Abrechnung (
anthropic/*-Modelle) - Claude CLI — Wiederverwendung einer vorhandenen Claude CLI-Anmeldung auf demselben Host
Für langlebige Gateway-Hosts sind Anthropic-API-Schlüssel weiterhin der klarste und am besten vorhersehbare Produktionspfad.
Aktuelle öffentliche Anthropic-Dokumentation:
- Claude Code CLI-Referenz
- Claude Agent SDK-Übersicht
- Claude Code mit Ihrem Pro- oder Max-Tarif verwenden
- Claude Code mit Ihrem Team- oder Enterprise-Tarif verwenden
Erste Schritte
**Am besten geeignet für:** Standard-API-Zugriff und nutzungsbasierte Abrechnung.<Steps>
<Step title="API-Schlüssel abrufen">
Erstellen Sie einen API-Schlüssel in der [Anthropic Console](https://console.anthropic.com/).
</Step>
<Step title="Onboarding ausführen">
```bash
openclaw onboard
# choose: Anthropic API key
```
Oder übergeben Sie den Schlüssel direkt:
```bash
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
```
</Step>
<Step title="Prüfen, ob das Modell verfügbar ist">
```bash
openclaw models list --provider anthropic
```
</Step>
</Steps>
### Konfigurationsbeispiel
```json5
{
env: { ANTHROPIC_API_KEY: "sk-ant-..." },
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}
```
<Steps>
<Step title="Sicherstellen, dass die Claude CLI installiert und angemeldet ist">
Prüfen Sie dies mit:
```bash
claude --version
```
</Step>
<Step title="Onboarding ausführen">
```bash
openclaw onboard
# choose: Claude CLI
```
OpenClaw erkennt die vorhandenen Claude CLI-Anmeldedaten und verwendet sie erneut.
</Step>
<Step title="Prüfen, ob das Modell verfügbar ist">
```bash
openclaw models list --provider anthropic
```
</Step>
</Steps>
<Note>
Einrichtung und Laufzeitdetails für das Claude CLI-Backend finden Sie unter [CLI-Backends](/de/gateway/cli-backends).
</Note>
### Konfigurationsbeispiel
Bevorzugen Sie die kanonische Anthropic-Modellreferenz plus eine CLI-Laufzeitüberschreibung:
```json5
{
agents: {
defaults: {
model: { primary: "anthropic/claude-opus-4-7" },
agentRuntime: { id: "claude-cli" },
},
},
}
```
Alte `claude-cli/claude-opus-4-7`-Modellreferenzen funktionieren aus
Kompatibilitätsgründen weiterhin, aber neue Konfigurationen sollten die Provider-/Modellauswahl bei
`anthropic/*` belassen und das Ausführungs-Backend in `agentRuntime.id` angeben.
<Tip>
Wenn Sie den klarsten Abrechnungspfad möchten, verwenden Sie stattdessen einen Anthropic-API-Schlüssel. OpenClaw unterstützt außerdem abonnementartige Optionen von [OpenAI Codex](/de/providers/openai), [Qwen Cloud](/de/providers/qwen), [MiniMax](/de/providers/minimax) und [Z.AI / GLM](/de/providers/glm).
</Tip>
Thinking-Standards (Claude 4.6)
Claude 4.6-Modelle verwenden in OpenClaw standardmäßig adaptive Thinking, wenn keine explizite Thinking-Stufe festgelegt ist.
Überschreiben Sie dies pro Nachricht mit /think:<level> oder in den Modellparametern:
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { thinking: "adaptive" },
},
},
},
},
}
Prompt-Caching
OpenClaw unterstützt Anthropics Prompt-Caching-Funktion für Authentifizierung per API-Schlüssel.
| Wert | Cache-Dauer | Beschreibung |
|---|---|---|
"short" (Standard) |
5 Minuten | Wird automatisch für API-Schlüssel-Authentifizierung angewendet |
"long" |
1 Stunde | Erweiterter Cache |
"none" |
Kein Caching | Prompt-Caching deaktivieren |
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { cacheRetention: "long" },
},
},
},
},
}
```json5
{
agents: {
defaults: {
model: { primary: "anthropic/claude-opus-4-6" },
models: {
"anthropic/claude-opus-4-6": {
params: { cacheRetention: "long" },
},
},
},
list: [
{ id: "research", default: true },
{ id: "alerts", params: { cacheRetention: "none" } },
],
},
}
```
Reihenfolge beim Zusammenführen der Konfiguration:
1. `agents.defaults.models["provider/model"].params`
2. `agents.list[].params` (passende `id`, überschreibt nach Schlüssel)
So kann ein Agent einen langlebigen Cache beibehalten, während ein anderer Agent auf demselben Modell das Caching für stoßartigen Datenverkehr mit geringer Wiederverwendung deaktiviert.
Erweiterte Konfiguration
Der gemeinsame `/fast`-Schalter von OpenClaw unterstützt direkten Anthropic-Datenverkehr (API-Schlüssel und OAuth zu `api.anthropic.com`).| Befehl | Wird abgebildet auf |
|---------|---------|
| `/fast on` | `service_tier: "auto"` |
| `/fast off` | `service_tier: "standard_only"` |
```json5
{
agents: {
defaults: {
models: {
"anthropic/claude-sonnet-4-6": {
params: { fastMode: true },
},
},
},
},
}
```
<Note>
- Wird nur für direkte Anfragen an `api.anthropic.com` injiziert. Proxy-Routen lassen `service_tier` unverändert.
- Explizite `serviceTier`- oder `service_tier`-Parameter überschreiben `/fast`, wenn beide gesetzt sind.
- Bei Konten ohne Priority-Tier-Kapazität kann `service_tier: "auto"` zu `standard` aufgelöst werden.
</Note>
| Eigenschaft | Wert |
| --------------- | -------------------- |
| Standardmodell | `claude-opus-4-6` |
| Unterstützte Eingabe | Bilder, PDF-Dokumente |
Wenn ein Bild oder eine PDF an eine Unterhaltung angehängt wird, leitet OpenClaw sie automatisch
über den Anthropic-Provider für Medienverständnis weiter.
```json5
{
agents: {
defaults: {
models: {
"anthropic/claude-opus-4-6": {
params: { context1m: true },
},
},
},
},
}
```
OpenClaw bildet dies bei Anfragen auf `anthropic-beta: context-1m-2025-08-07` ab.
`params.context1m: true` gilt außerdem für das Claude CLI-Backend
(`claude-cli/*`) für berechtigte Opus- und Sonnet-Modelle und erweitert das Laufzeit-
Kontextfenster für diese CLI-Sitzungen so, dass es dem Verhalten der direkten API entspricht.
<Warning>
Erfordert Langkontextzugriff für Ihre Anthropic-Anmeldedaten. Alte Token-Authentifizierung (`sk-ant-oat-*`) wird für 1M-Kontextanfragen abgelehnt. OpenClaw protokolliert eine Warnung und fällt auf das Standard-Kontextfenster zurück.
</Warning>