Praktyczny przewodnik — dwie ścieżki, rzeczywiste błędy i jak je naprawić.

Testowane na OpenClaw 2026.5.27 (WSL2/Linux) · Wtyczka OrcaRouter wymaga OpenClaw ≥ 2026.5.12 · Lipiec 2026

Claude Fable 5 to pierwszy publicznie wydany przez Anthropic Mythos-class model — poziom znajdujący się powyżej Opus, stworzony do długotrwałej, wieloetapowej, autonomicznej pracy. Taki profil czyni go naturalnym wyborem dla frameworku agentowego takiego jak OpenClaw, gdzie model nie tylko odpowiada na pytania, ale planuje, korzysta z narzędzi i utrzymuje spójność przez wiele kroków.

Ten przewodnik opisuje dwa sposoby podłączenia Fable 5 do agenta OpenClaw: bezpośrednio przez klucz API Anthropic (Ścieżka A) oraz przez OrcaRouter używając jednego klucza zgodnego z OpenAI (Ścieżka B). Oba prowadzą do tego samego modelu — różnią się konfiguracją, kontrolą kosztów i elastycznością routingu.

Uwaga na temat weryfikacji: Ścieżka B została przetestowana od końca do końca na OpenClaw 2026.5.27 — każdy blok poleceń i komunikat o błędzie w tej sekcji to rzeczywisty zapis z tego uruchomienia. Ścieżka A jest zgodna z oficjalną dokumentacją Anthropica i OpenClawa.

Po pierwsze, to, co większość poradników pomija: zabezpieczenie przekierowania w Fable 5.

Dla chatbota byłby to przypis. Dla frameworku agentowego jest to najważniejsza sekcja w przewodniku, więc idzie jako pierwsza.

Fable 5 jest dostarczany z dodatkowymi środkami bezpieczeństwa. Zgodnie z oficjalną stroną Anthropic, model zawiera solidne zabezpieczenia dla cyberbezpieczeństwa i biologii: wiele zapytań w tych dziedzinach jest automatycznie kierowanych do kolejnego najbardziej zaawansowanego modelu Anthropic, Claude Opus 4.8, jeśli zostaną oznaczone przez te zabezpieczenia — a ty jesteś nie płacisz cen Fable za przekierowane zapytania. Anthropic szczegółowo opisuje działanie awaryjne w tym artykule pomocy.

Co to oznacza dla twojego agenta OpenClaw

• Odmowy przychodzą jako udana odpowiedź, a nie błąd. W Claude API, odrzucone żądanie zwraca normalną odpowiedź z powodem zatrzymania odmowy zamiast błędu HTTP. Twoja pętla agenta musi traktować to jako “ponów próbę na innym modelu”, a nie “API padło”.

• To, co otrzymasz, może nie być Fable 5. Jeśli porównujesz modele wewnątrz OpenClaw i odpowiedź wydaje się nieprawidłowa, zabezpieczenie przekierowujące do Opus 4.8 może być tego powodem. To oczekiwane zachowanie, nie błąd — poza tymi ograniczonymi domenami model zachowuje się normalnie.

Wszystko inne w tym przewodniku jest mechaniczne; to jest część, która wymaga twojej uwagi.

0. Wymagania wstępne

• OpenClaw ≥ 2026.5.12 zainstalowany i zainicjalizowany (openclaw --version, aby sprawdzić — ten przewodnik testowano na 2026.5.27).

•    Działająca brama (status openclaw pokazuje, że jest osiągalna).

• Node 22.19+ lub 24.

• Jeżeli jesteś za siecią, która wymaga proxy, aby dotrzeć do Anthropic / OrcaRouter, upewnij się, że sama usługa bramy może z niego korzystać — to zaskakuje prawie każdego raz (zob. §2.3).

Zasada bezpieczeństwa kluczy: samodzielnie generujesz i wklejasz klucze API. Nigdy nie udostępniaj klucza na zrzucie ekranu, w czacie ani w publicznym repozytorium. Przechowuj klucze w pliku dostępnym tylko dla Ciebie (chmod 600) i odwołuj się do nich stamtąd — nigdy nie koduj klucza na sztywno w pliku, który możesz zatwierdzić.

Którą ścieżkę powinieneś wybrać?

Anthropic oficjalny klucz

klucz OrcaRouter

Prefiks klucza

sk-ant-

sk-orca

Osiągalne modele

Tylko modele Anthropic

Fable 5 + GPT / Gemini / GLM / DeepSeek…

Ustawienia w OpenClaw

Wbudowany dostawca

Najpierw zainstaluj wtyczkę ClawHub.

Routing / polityka wydatków

Konfiguracja na agenta

Centralna konsola

Odmowa natywna / fallback

Pierwszorzędne (własne API Anthropica)

Zależy, jak router to udostępnia.

Rozliczenia

Konto Anthropic

Konto OrcaRouter (pojedyncze saldo)

Obie ścieżki docierają do tego samego modelu. Żadna z nich nie jest “lepsza” — to różne kompromisy. Jeśli Fable 5 jest jedynym modelem granicznym, na którym ci zależy i chcesz mieć najczystszy dostęp do jego natywnego zachowania, idź bezpośrednio. Jeśli kierujesz wiele modeli i chcesz mieć jeden klucz plus centralne sterowanie, router się opłaca.

2. Ścieżka A — oficjalny klucz API Anthropic

Najbardziej bezpośrednia trasa: OpenClaw rozmawia bezpośrednio z Anthropic, bez pośrednika. Otrzymujesz model dokładnie tak, jak serwuje go Anthropic, włączając natywną odmowę i semantykę zapasową.

2.1 Wygeneruj klucz

•    Zaloguj się na console.anthropic.com.

• Otwórz Klucze API → Utwórz klucz. Skopiuj ciąg sk-ant- (pokazany raz).

• W sekcji Billing, dodaj kredyt i ustaw miesięczny limit, aby niekontrolowany agent nie wyczerpał Twojego konta. Fable 5 jest wyceniony na $10 za milion tokenów wejściowych i $50 za milion tokenów wyjściowych, z 90% zniżką na tokeny wejściowe za buforowanie promptu (źródło).

2.2  Przechowuj klucz bezpiecznie

Przechowuj to w chronionym pliku tajemnic, zamiast wklejać go bezpośrednio w dowolnym miejscu:

touch ~/.openclaw_secrets && chmod 600 ~/.openclaw_secrets

nano ~/.openclaw_secrets

Dodaj tę linię, a następnie zapisz:

eksportuj ANTHROPIC_API_KEY="sk-ant-..."

Załaduj to i potwierdź (wyświetla tylko prefiks, nigdy pełnego klucza):

source ~/.openclaw_secrets

echo "załadowano: ${ANTHROPIC_API_KEY:0:10}..."

Częsty błąd: export: '=': nieprawidłowy identyfikator → wstawiłeś spacje wokół = lub użyłeś krzywych „inteligentnych cudzysłowów”. Użyj dokładnie KEY="value" — bez spacji, prostych cudzysłowów ASCII.

2.3 Spraw, by brama widziała klucz (krytyczny)

To jest największy haczyk. W systemie Linux, brama OpenClaw zwykle działa jako systemd user service. Zmienna eksportowana w powłoce istnieje tylko w tej powłoce — usługa w tle jest uruchamiana osobno i nie może jej zobaczyć. Więc nawet jeśli twój terminal ma klucz, brama może go nie mieć.

Daj usłudze własną kopię za pomocą pliku drop-in:

mkdir -p ~/.config/systemd/user/openclaw-gateway.service.d/

nano ~/.config/systemd/user/openclaw-gateway.service.d/anthropic.conf

Spis treści — uwaga: składnia Environment= w systemd przyjmuje dosłowne KEY=value, bez exportu, i musisz napisać prawdziwy klucz, ponieważ odniesienie $VAR nie zostanie tutaj rozwiązane:

Serwis

Środowisko="ANTHROPIC_API_KEY=sk-ant-..."

Zabezpiecz to, przeładuj, uruchom ponownie:

chmod 600 ~/.config/systemd/user/openclaw-gateway.service.d/anthropic.conf

systemctl --user daemon-reload

systemctl --user restart openclaw-gateway

Potwierdź, że usługa faktycznie je załadowała (wyświetla tylko prefiks):

systemctl --user show openclaw-gateway --property=Environment \

| grep -o 'ANTHROPIC_API_KEY=sk-ant-....'

2.4 Skonfiguruj Fable 5 jako model

Najpierw wykonaj kopię zapasową swojej konfiguracji (tanie ubezpieczenie), a następnie sprawdź dokładne odniesienie modelu, które ujawnia twoja kompilacja:

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

lista modeli openclaw | grep -i fable

Ustaw to jako domyślne, używając dokładnego odniesienia, które widziałeś powyżej (tutaj pokazane jako anthropic/claude-fable-5):

openclaw config set agents.defaults.model.primary "anthropic/claude-fable-5"

openclaw config waliduj

systemctl --user restart openclaw-gateway

Uwaga dotycząca listy dozwolonych:  niektóre konfiguracje wymuszają listę dozwolonych modeli jako zabezpieczenie kosztów/bezpieczeństwa. Jeśli Twoja tak robi, najpierw zarejestruj anthropic/claude-fable-5 pod agents.defaults.models, w przeciwnym razie przełączenie modelu zostanie odrzucone z błędem „not allowed” (rzeczywisty tekst błędu zobaczysz w Path B, §3.4 — to ten sam mechanizm).

2.5  Przetestuj to

openclaw agent --agent main --model "anthropic/claude-fable-5" \

Opracuj trzyetapowy plan migracji starszej usługi. Zachowaj zwięzłość.

Prompt w stylu planowania to dobry pierwszy test — wykorzystuje on moc Fable 5 (długoterminowe, wieloetapowe rozumowanie), a nie jednowierszowiec, gdzie ledwo zauważyłbyś różnicę w stosunku do tańszego modelu.

Ścieżka A — błędy, które możesz napotkać

Objaw

Przyczyna

Napraw

401 / błąd uwierzytelnienia

Gateway nie widzi klucza.

Dodaj go do pliku drop-in systemd (§2.3), uruchom ponownie

nie znaleziono modelu

Błędny ref Fable 5

Skopiuj dokładny ref z listy modeli

niedozwolone dla agenta

Model nie znajduje się na liście dozwolonych agentów.

Zarejestruj to pod agents.defaults.models

Błąd kredytu / przydziału

Brak salda lub obciążenia limitu

Doładuj / zwiększ limit w konsoli Anthropic

Działa w terminalu, nie działa w bramie

Zmienna powłoki vs. środowisko usługi

Zobacz §2.3 — usługa potrzebuje własnego środowiska.

Najlepsze dla: pozostawania blisko sprzętu — chcesz mieć model bez pośredników, jesteś już w ekosystemie Anthropic i chcesz mieć dostęp pierwszej klasy do natywnej obsługi odmowy/wycofania.

3. Ścieżka B — OrcaRouter API key (zweryfikowane end-to-end)

OrcaRouter to kompatybilny z OpenAI router LLM: jeden klucz sk-orca- daje dostęp do Fable 5 oraz modeli od wielu innych dostawców, z politykami routingu po stronie serwera. W OpenClaw jest dostarczany jako plugin ClawHub, więc wymaga jednego dodatkowego kroku instalacji w porównaniu z Path A. Poniżej znajduje się prawdziwy zapis z OpenClaw 2026.5.27.

3.1  Zainstaluj wtyczkę

openclaw plugins install clawhub:@continuum-ai-corp/openclaw-orcarouter

openclaw lista wtyczek | grep -i orca

Zanim zaufasz jakiemukolwiek wtyczce zewnętrznej, sprawdź, co może zrobić:

sailt@savor:~$ openclaw plugins inspect orcarouter

OrcaRouter Provider

id: orcarouter

OrcaRouter - adaptacyjne routowanie pomiędzy wieloma LLM-ami przez pojedynczy

API zgodne z OpenAI

Status: załadowano

Wersja: 0.1.0

Tryb możliwości: zwykły

Starszy before_agent_start: nie

Możliwości:

wnioskowanie tekstowe: orcarouter

Zainstaluj:

clawhub

Spec: clawhub:@continuum-ai-corp/openclaw-orcarouter

Kanał ClawHub: społeczność

Integralność npm: sha512-Gpu6fC30zZ8iNiEliLEj6Qbr...

Przeczytaj ten blok dotyczący możliwości przed przejściem dalej: wtyczka deklaruje pojedynczą zdolność wnioskowania tekstowego i nie zawiera haka before_agent_start — to tylko forwarder modelu, nic więcej. Nie czyta twoich plików ani nie uruchamia poleceń powłoki. (Strona wtyczki: ClawHub.)

Możesz również zauważyć to ostrzeżenie przy następnym uruchomieniu:

[plugins] plugins.allow jest puste; odkryte niepakietowane wtyczki mogą

automatyczne ładowanie: orcarouter (/home/sailt/.openclaw/extensions/orcarouter/)

dist/index.js). Ustaw plugins.allow na jawne zaufane identyfikatory.

To jest OpenClaw mówiący ci, że nie ustawiono listy dozwolonych wtyczek, więc każda znaleziona wtyczka może automatycznie się załadować. Wycisz to — i wyraźnie okaż swoje zaufanie — za pomocą:

openclaw config set plugins.allow '["orcarouter"]'

3.2  Pobierz i przechowaj klucz

Wygeneruj klucz sk-orca- z konsoli OrcaRouter, a następnie zapisz go w taki sam sposób jak Path A:

# w ~/.openclaw_secrets

export ORCAROUTER_API_KEY="sk-orca-..."

3.3  Przekaż klucz bramie

Ta sama krytyczna reguła co w Ścieżce A — usługa systemd potrzebuje własnej kopii. Zachowaj ją w osobnym pliku drop-in dla porządku:

# ~/.config/systemd/user/openclaw-gateway.service.d/orcarouter.conf

Serwis

Środowisko="ORCAROUTER_API_KEY=sk-orca-..."

chmod 600 ~/.config/systemd/user/openclaw-gateway.service.d/orcarouter.conf

systemctl --user daemon-reload

systemctl --user restart openclaw-gateway

Potwierdź, że usługa faktycznie to widzi:

sailt@savor:~$ systemctl --user show openclaw-gateway --property=Environment \

| grep -o 'ORCAROUTER_API_KEY=sk-orca-....'

ORCAROUTER_API_KEY=sk-orca-****

3.4  Zarejestruj i wybierz Fable 5

Odnośniki OrcaRouter są zgodne z orcarouter/<vendor>/<model>. Sprawdź dokładny odnośnik dla Fable 5:

sailt@savor:~$ openclaw models list | grep -i fable

orcarouter/anthropic/claude-fable-5 tekst 195k nie tak skonfigurowane

Więc referencją jest orcarouter/anthropic/claude-fable-5, z oknem kontekstu 195 tys. tokenów, jak udostępnione przez router. (Strona modelu: orcarouter.ai/models/anthropic/claude-fable-5.)

Oto co się dzieje, jeśli pominiesz rejestrację i po prostu spróbujesz użyć modelu — prawdziwy zapis:

sailt@savor:~$ openclaw agent --agent main --model "orcarouter/z-ai/glm-5.2" \

Opowiedz mi żart.

GatewayClientRequestError: Błąd: Nadpisanie modelu "orcarouter/z-ai/glm-5.2"

nie jest dozwolone dla agenta "main".

OpenClaw wymusza listę dozwolonych modeli dla każdego agenta jako zabezpieczenie kosztów/bezpieczeństwa. Najpierw zarejestruj model:

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

openclaw config set agents.defaults.models.'orcarouter/anthropic/claude-fable-5' '{}'

Uwaga — kropki w nazwach modeli. Jeśli odwołanie zawiera kropkę wersji, config set traktuje kropkę jako separator ścieżki i odrzuca je. Prawdziwy zapis, używając GLM-5.2 jako przykładu:

sailt@savor:~$ openclaw config set \

agenci.domyślne.modele.'orcarouter/z-ai/glm-5.2' '{}'

Błąd: walidacja konfiguracji nie powiodła się.

agents.defaults.models.orcarouter/z-ai/glm-5: Nieprawidłowe dane wejściowe

Zwróć uwagę, że referencja została obcięta przy .2. Referencja Fable 5 nie ma kropki, więc nie jest to dotknięte — ale w przypadku referencji z kropką, edytuj ręcznie ~/.openclaw/openclaw.json, aby dodać wpis, a następnie uruchom openclaw config validate.

Następnie ustaw go jako domyślny (lub po prostu podaj --model przy każdym uruchomieniu), zatwierdź, uruchom ponownie:

openclaw ustaw konfigurację agents.defaults.model.primary "orcarouter/anthropic/claude-fable-5"

openclaw config waliduj

systemctl --user restart openclaw-gateway

3.5 Przetestuj to

Prawdziwa transkrypcja:

sailt@savor:~$ openclaw agent --agent main \

--model "orcarouter/anthropic/claude-fable-5" --message "opowiedz mi żart"

OpenClaw 2026.5.27 (27ae826) — Widziałem twoje komunikaty commitów.

Popracujemy nad tym razem.

Żona programisty pyta go: „Czy mógłbyś pójść do sklepu i kupić bochenek?”

chleba? A jeśli mają jajka, weź tuzin.

Wraca z 12 bochenkami chleba.

Dlaczego, u licha, kupiłeś 12 bochenków?!

Oni mieli jajka.

Fable 5, odpowiadając przez OrcaRouter, w jednym poleceniu. (Także: model ma lepsze komediowe wyczucie czasu niż większość z nas.)

Path B — błędy, które możesz napotkać

Objaw

Przyczyna

Napraw

plugins.allow jest puste (ostrzeżenie)

Nie ustawiono listy dozwolonych wtyczek

ustaw konfigurację plugins.allow '["orcarouter"]'

Nie wybrano sesji docelowej

Brak --agent

Dodaj --agent main

niedozwolone dla agenta "main"

Model niezarejestrowany

Dodaj do agents.defaults.models (§3.4)

Nieprawidłowe dane wejściowe przy ustawianiu konfiguracji

Kropka w nazwie modelu parsowana jako ścieżka

Edytuj openclaw.json ręcznie, następnie zweryfikuj.

401 nieautoryzowany

Brama nie otrzymała klucza.

Sprawdź drop-in systemd (§3.3)

nie znaleziono modelu

Błędny odnośnik / nie w katalogu

Zweryfikuj referencję na stronie modeli

Najlepsze dla: jeden klucz u wielu dostawców, zarządzanie routingiem i polityką wydatków centralnie w konsoli routera, a nie w konfiguracji poszczególnych agentów, lub testy A/B modelu Fable 5 przeciwko modelom innych dostawców bez żonglowania oddzielnymi kluczami dostawców.

4. Używanie Fable 5 na co dzień

4.1  Trzy sposoby wyboru modelu

Cel

Polecenie

Zakres

Wypróbuj na jednym połączeniu

openclaw agent --model <ref> --message ...

pojedyncze uruchomienie

Przełącz w trakcie rozmowy

/model <ref>  (wewnątrz TUI)

bieżąca sesja

Ustaw jako domyślne

config set agents.defaults.model.primary <ref>

wszystkie nowe sesje

4.2 Kontekst i uwagi dotyczące kosztów

Fable 5 jest drogi za tokeni łakomym na tokeny przy długich zadaniach — to natura modelu stworzonego do pracy przez wiele godzin. Kilka nawyków utrzymuje rachunek w rozsądnych granicach:

• Zarezerwuj go dla zadań, które go uzasadniają. Używaj tańszego modelu jako domyślnego dla swojego agenta i przełączaj się na Fable 5 w przypadku naprawdę trudnych, długoterminowych zadań — z opcją --model na przebieg, lub poprzez politykę routingu, jeśli jesteś na ścieżce B.

• Rozpoczynaj nowe sesje między niezwiązanymi ze sobą zadaniami (/new w TUI), aby nie wysyłać ponownie długiej historii przy każdej turze. Przełączanie modeli zachowuje spójność rozmowy — OpenClaw ponownie wysyła historię tekstu do nowego modelu — a koszt śledzi długość kontekstu, a nie to, czy przełączyłeś.

• Obserwuj licznik tokenów. OpenClaw pokazuje użycie tokenów na sesję; jeśli trywialna wymiana spala dziesiątki tysięcy tokenów, to zazwyczaj stały narzut promptu (twój plik tożsamości + opisy umiejętności), a nie model — warto wyciąć osobno.

• Jeśli odpowiedź kiedykolwiek wydaje się niezgodna ze stylem, przypomnij sobie sekcję zabezpieczeń na górze — niektóre zapytania w domenach objętych ograniczeniami są celowo odpowiadane przez Opus 4.8, a za nie nie jesteś rozliczany według stawek Fable.

5. Końcowa lista kontrolna

•    Klucz przechowywany w pliku secrets z uprawnieniami chmod 600; nigdy nie wklejany do zatwierdzonego pliku.

•    Klucz również obecny w pliku drop-in systemd gatewaya — to właśnie sprawia, że to działa.

•    Fable 5 zarejestrowany w agents.defaults.models i ustawiony jako główny.

• openclaw config validate przechodzi pomyślnie; brama jest restartowana po każdej zmianie konfiguracji.

•    Miesięczny limit wydatków ustawiony na koncie, które obciążyłeś.

•    (Ścieżka B) plugins.allow ustawione tak, aby żadna wtyczka nie ładowała się automatycznie po cichu.

Jedna rzecz, którą ludzie pomijają: twoje działanie z kluczem w terminalu nie oznacza, że brama go ma. Krok systemd drop-in (§2.3 / §3.3) sprawia, że Fable 5 faktycznie odpowiada. Jeśli otrzymasz błąd 401 z kluczem, który wiesz, że jest ważny, to prawie zawsze jest to przyczyna.

Często zadawane pytania

Czy Claude Fable 5 jest dostępny przez interfejsy API zgodne z OpenAI?

Nie bezpośrednio od Anthropic — Anthropic udostępnia go przez Claude API jako claude-fable-5. Aby uzyskać do niego dostęp przez punkt końcowy zgodny z OpenAI, użyj routera takiego jak OrcaRouter, gdzie ref to orcarouter/anthropic/claude-fable-5 (ścieżka B powyżej).

Dlaczego moje zapytanie dotyczące Fable 5 zwróciło inny model?

Fable 5 zawiera zabezpieczenia dotyczące cyberbezpieczeństwa i biologii. Zapytania oznaczone w tych dziedzinach są automatycznie kierowane do Claude Opus 4.8, a za przekierowane zapytania nie są naliczane ceny Fable. Zobacz wyjaśnienie Anthropica.

Ile kosztuje Claude Fable 5 za milion tokenów?

$10 za milion tokenów wejściowych i $50 za milion tokenów wyjściowych, z 90% zniżką na tokeny wejściowe dla buforowania promptów (Anthropic). Przez router sprawdź bieżącą stawkę na stronie modelu.

Dlaczego OpenClaw mówi, że mój model jest „niedozwolony dla agenta”?

OpenClaw wymusza listę dozwolonych modeli dla każdego agenta. Zarejestruj odniesienie pod agents.defaults.models przed jego wybraniem (§3.4) — i uważaj na pułapkę parsowania kropki w wersji, jeśli odniesienie zawiera kropkę.

🦞  Daj swojemu homarowi mózg klasy Mythos.