// dokumentacja openclaw

Anthropic w OpenClaw — konfiguracja Claude Opus 4.6

Metody uwierzytelniania

Anthropic oferuje dwie metody uwierzytelniania w OpenClaw:

Opcja A: Klucz API Anthropic (zalecana dla produkcji)

Najlepsza opcja do standardowego dostepu API z rozliczeniem na podstawie zuzycia. Klucze API tworzysz w panelu Anthropic Console.

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Opcja B: Backend Claude CLI

Mozesz ponownie wykorzystac istniejace poswiadczenia logowania z Claude CLI. Ta metoda nie wymaga osobnego klucza API — wykorzystuje token sesji z zainstalowanego CLI.

Uwaga: Starsze profile tokenow (z prefiksem sk-ant-oat-*) nadal dzialaja, ale sa uznawane za przestarzale. Zalecamy migracje do nowych kluczy API.

Przyklad konfiguracji

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-6" }
    }
  }
}

Tryb myslenia (Thinking) — Claude 4.6

Modele Claude 4.6 w OpenClaw domyslnie korzystaja z adaptacyjnego trybu myslenia (thinking: adaptive), gdy nie ustawiono jawnego poziomu. Oznacza to, ze model sam decyduje, kiedy zastosowac rozszerzone rozumowanie.

Mozesz nadpisac ten poziom komenda /think:<poziom> w czacie lub przez parametry modelu w konfiguracji. Dostepne poziomy to m.in.:

  • adaptive — model sam decyduje (domyslne)
  • high — zawsze rozszerzone rozumowanie
  • off — wylaczone myslenie

Tryb szybki (Fast Mode)

OpenClaw obsluguje tryb szybki dla Anthropic, ktory wplywa na priorytet przetwarzania:

  • /fast on — ustawia service_tier: "auto" (automatyczny priorytet)
  • /fast off — ustawia service_tier: "standard_only" (standardowe przetwarzanie)

Tryb szybki dziala tylko przy bezposrednich zapytaniach do api.anthropic.com (nie przez proxy).

Cache promptow

Przy korzystaniu z klucza API Anthropic, OpenClaw automatycznie aktywuje cache promptow z domyslnym krotkim czasem przechowywania (5 minut). Mozesz to skonfigurowac parametrem cacheRetention:

  • "none" — cache wylaczony
  • "short" — 5 minut (domyslne)
  • "long" — 1 godzina

Cache promptow moze znaczaco zmniejszyc koszty przy powtarzajacych sie zapytaniach z dlugim kontekstem systemowym.

Okno kontekstowe 1M tokenow (beta)

Anthropic oferuje eksperymentalne rozszerzone okno kontekstowe do 1 miliona tokenow. Aby je wlaczyc w OpenClaw:

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { context1m: true }
        }
      }
    }
  }
}

To ustawienie mapuje sie na naglowek beta anthropic-beta: context-1m-2025-08-07. Uwaga: Wymaga zatwierdzenia przez Anthropic (allowlist).

Nadpisywanie ustawien per agent

Mozesz dostosowac parametry dla konkretnych agentow. Konfiguracja laczy sie w kolejnosci:

  1. Domyslne ustawienia na poziomie modelu
  2. Parametry specyficzne dla agenta (nadpisuja klucze)
{
  agents: {
    list: [
      {
        id: "alerts",
        params: { cacheRetention: "none" }
      },
      {
        id: "coding-assistant",
        params: { context1m: true }
      }
    ]
  }
}

Dzieki temu agent alerts nie bedzie korzystal z cache, a coding-assistant bedzie mial dostep do rozszerzonego okna kontekstowego.

Rozwiazywanie problemow

Najczestsze problemy z dostawca Anthropic:

  • Wygasniecie tokenu — wygeneruj nowy klucz API w panelu Anthropic Console.
  • Brak poswiadczen per agent — upewnij sie, ze zmienna ANTHROPIC_API_KEY jest dostepna w srodowisku, w ktorym dziala agent.
  • Limity zapytan (rate limits) — OpenClaw automatycznie obsluguje cooldowny. Rozważ uzycie modeli fallback.
  • Blad profilu — jesli uzywasz starego tokenu sk-ant-oat-*, przemigruj do nowego klucza API.