Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

openclaw models

• Dostawcy + modele: Modele
• Koncepcje wyboru modelu + polecenie slash /models: Koncepcja modeli
• Konfiguracja uwierzytelniania dostawcy: Pierwsze kroki

​

Typowe polecenia

openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan

• models set <model-or-alias> akceptuje provider/model lub alias.
• models list jest tylko do odczytu: odczytuje konfigurację, profile uwierzytelniania, istniejący stan katalogu oraz wiersze katalogu należące do dostawców, ale nie nadpisuje models.json.
• Kolumna Auth jest na poziomie dostawcy i jest tylko do odczytu. Jest obliczana na podstawie lokalnych metadanych profilu uwierzytelniania, znaczników środowiskowych, skonfigurowanych kluczy dostawcy, znaczników dostawcy lokalnego, znaczników środowiska/profilu AWS Bedrock oraz metadanych syntetycznego uwierzytelniania Plugin; nie ładuje runtime dostawcy, nie odczytuje sekretów z keychaina, nie wywołuje API dostawców ani nie dowodzi dokładnej gotowości wykonania dla poszczególnych modeli.
• models list --all --provider <id> może obejmować należące do dostawcy statyczne wiersze katalogu z manifestów Plugin lub metadanych katalogu dostawców wbudowanych, nawet jeśli nie uwierzytelniono się jeszcze u tego dostawcy. Te wiersze nadal są wyświetlane jako niedostępne, dopóki nie zostanie skonfigurowane pasujące uwierzytelnianie.
• models list utrzymuje responsywność płaszczyzny sterowania, gdy wykrywanie katalogu dostawcy jest wolne. Widoki domyślne i skonfigurowane po krótkim oczekiwaniu wracają do skonfigurowanych lub syntetycznych wierszy modeli i pozwalają wykrywaniu zakończyć się w tle. Użyj --all, gdy potrzebujesz dokładnego, pełnego wykrytego katalogu i możesz poczekać na wykrywanie dostawcy.
• Szerokie models list --all scala wiersze katalogu z manifestu nad wierszami rejestru bez ładowania haków uzupełnień runtime dostawcy. Szybkie ścieżki manifestu filtrowane po dostawcy używają tylko dostawców oznaczonych jako static; dostawcy oznaczeni jako refreshable pozostają oparci na rejestrze/pamięci podręcznej i dołączają wiersze manifestu jako uzupełnienia, natomiast dostawcy oznaczeni jako runtime pozostają przy wykrywaniu rejestru/runtime.
• models list utrzymuje natywne metadane modelu i limity runtime jako osobne wartości. W wyjściu tabelarycznym Ctx pokazuje contextTokens/contextWindow, gdy efektywny limit runtime różni się od natywnego okna kontekstu; wiersze JSON zawierają contextTokens, gdy dostawca ujawnia ten limit.
• models list --provider <id> filtruje według identyfikatora dostawcy, takiego jak moonshot lub openai-codex. Nie akceptuje etykiet wyświetlanych z interaktywnych selektorów dostawców, takich jak Moonshot AI.
• Odwołania do modeli są parsowane przez podział po pierwszym /. Jeśli ID modelu zawiera / (styl OpenRouter), uwzględnij prefiks dostawcy (przykład: openrouter/moonshotai/kimi-k2).
• Jeśli pominiesz dostawcę, OpenClaw najpierw rozwiązuje dane wejściowe jako alias, następnie jako unikalne dopasowanie skonfigurowanego dostawcy dla dokładnie tego identyfikatora modelu, a dopiero potem wraca do skonfigurowanego dostawcy domyślnego z ostrzeżeniem o przestarzałym użyciu. Jeśli ten dostawca nie udostępnia już skonfigurowanego modelu domyślnego, OpenClaw wraca do pierwszego skonfigurowanego dostawcy/modelu zamiast zgłaszać nieaktualną wartość domyślną usuniętego dostawcy.
• models status może pokazywać marker(<value>) w wyjściu uwierzytelniania dla niesekretnych symboli zastępczych (na przykład OPENAI_API_KEY, secretref-managed, minimax-oauth, oauth:chutes, ollama-local) zamiast maskować je jako sekrety.

​

Skanowanie modeli

• --no-probe (tylko metadane; bez wyszukiwania konfiguracji/sekretów)
• --min-params <b>
• --max-age-days <days>
• --provider <name>
• --max-candidates <n>
• --timeout <ms> (żądanie katalogu i limit czasu dla każdej próby)
• --concurrency <n>
• --yes
• --no-input
• --set-default
• --set-image
• --json

​

Stan modeli

• --json
• --plain
• --check (kod wyjścia 1=wygasłe/brakujące, 2=wygasające)
• --probe (aktywna próba skonfigurowanych profili uwierzytelniania)
• --probe-provider <name> (próba jednego dostawcy)
• --probe-profile <id> (powtarzalne lub rozdzielone przecinkami identyfikatory profili)
• --probe-timeout <ms>
• --probe-concurrency <n>
• --probe-max-tokens <n>
• --agent <id> (ID skonfigurowanego agenta; zastępuje OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)

• ok
• auth
• rate_limit
• billing
• timeout
• format
• unknown
• no_model

• excluded_by_auth_order: zapisany profil istnieje, ale jawne auth.order.<provider> go pominęło, więc próba zgłasza wykluczenie zamiast próbować go użyć.
• missing_credential, invalid_expires, expired, unresolved_ref: profil jest obecny, ale nie kwalifikuje się albo nie można go rozwiązać.
• no_model: uwierzytelnianie dostawcy istnieje, ale OpenClaw nie mógł rozwiązać kandydata modelu nadającego się do próby dla tego dostawcy.

​

Aliasy + modele awaryjne

openclaw models aliases list
openclaw models fallbacks list

​

Profile uwierzytelniania

openclaw models auth add
openclaw models auth list [--provider <id>] [--json]
openclaw models auth login --provider <id>
openclaw models auth setup-token --provider <id>
openclaw models auth paste-token

openclaw models auth login --provider openai --set-default
openclaw models auth login --provider openai --method api-key
openclaw models auth list --provider openai

• setup-token i paste-token pozostają ogólnymi poleceniami tokenów dla dostawców, którzy udostępniają metody uwierzytelniania tokenem.
• setup-token wymaga interaktywnego TTY i uruchamia metodę uwierzytelniania tokenem dostawcy (domyślnie metodę setup-token tego dostawcy, gdy ją udostępnia).
• paste-token akceptuje ciąg tokenu wygenerowany gdzie indziej lub przez automatyzację.
• paste-token wymaga --provider, prosi o wartość tokenu i zapisuje ją do domyślnego identyfikatora profilu <provider>:manual, chyba że przekażesz --profile-id.
• paste-token --expires-in <duration> zapisuje bezwzględne wygaśnięcie tokenu na podstawie względnego czasu trwania, takiego jak 365d lub 12h.
• Uwaga dotycząca Anthropic: pracownicy Anthropic poinformowali nas, że użycie Claude CLI w stylu OpenClaw jest ponownie dozwolone, więc OpenClaw traktuje ponowne użycie Claude CLI i użycie claude -p jako sankcjonowane dla tej integracji, chyba że Anthropic opublikuje nową politykę.
• Anthropic setup-token / paste-token pozostają dostępne jako obsługiwana ścieżka tokenu OpenClaw, ale OpenClaw teraz preferuje ponowne użycie Claude CLI i claude -p, gdy są dostępne.

​

Powiązane

• Dokumentacja CLI
• Wybór modelu
• Przełączanie awaryjne modeli