CLI commands
Promocje
openclaw promos
Odkrywaj i odbieraj promocyjne oferty modeli publikowane w ClawHub. Odebranie promocji konfiguruje dostawcę (uwierzytelnianie i Plugin, gdy jest potrzebny) oraz rejestruje modele objęte promocją — bez ponownego przechodzenia procesu wdrażania i bez zmiany modelu domyślnego, chyba że tego zażądasz.
Powiązane:
- Model domyślny i modele zapasowe: Modele
- Konfiguracja uwierzytelniania dostawcy: Pierwsze kroki
Polecenia
openclaw promos listopenclaw promos claim <slug>openclaw promos claim <slug> --api-key <key> --set-defaultopenclaw promos list
Wyświetla aktualnie obowiązujące promocje wraz z ich modelami, sugerowanym
modelem domyślnym, pozostałym czasem oraz dokładnym poleceniem odebrania.
--json wyświetla nieprzetworzone dane.
openclaw promos claim <slug>
Odbiera aktualnie obowiązującą promocję:
- Pobiera promocję z ClawHub i sprawdza, czy mieści się ona w okresie obowiązywania.
- Sprawdza dostawcę promocji, wybraną metodę uwierzytelniania i zadeklarowane pakiety Pluginów pod kątem zgodności z zainstalowaną wersją OpenClaw. Nieznane identyfikatory lub niezgodności pakietów są odrzucane — promocja nigdy nie może sprawić, że CLI uruchomi coś, czego nie potrafi już obsłużyć.
- Ponownie wykorzystuje istniejące dane uwierzytelniające dostawcy, jeśli je
masz. W przeciwnym razie przeprowadza standardowy proces uwierzytelniania
dostawcy (najpierw wyświetlając adres URL rejestracji z promocji, umożliwiający
uzyskanie bezpłatnego klucza).
--api-key <key>kończy uwierzytelnianie kluczem API bez monitów, zgodnie z flagami trybu nieinteraktywnego poleceniaopenclaw onboard; aby nie umieszczać klucza w wierszu poleceń, wyeksportuj zamiast tego zmienną środowiskową dostawcy (na przykładOPENROUTER_API_KEY) — istniejące dane uwierzytelniające ze środowiska są wykrywane automatycznie i żadna flaga nie jest potrzebna. - Rejestruje modele objęte promocją wraz z ich aliasami. Istniejące aliasy nigdy nie są nadpisywane.
- Proponuje ustawienie sugerowanego modelu promocji jako modelu domyślnego —
--set-defaultpomija pytanie; w przeciwnym razie ustawienia domyślne pozostają bez zmian.
Po zakończeniu okresu obowiązywania promocji dostawca przestaje udostępniać
bezpłatne modele; konfiguracja i dane uwierzytelniające pozostają niezmienione.
W dowolnym momencie możesz przełączyć model za pomocą
openclaw models set <model>.
Pasywne wykrywanie w models list
openclaw models list wyświetla również promocje bez bezpośredniego
odpytywania ClawHub:
- Aktualne oferty, których modeli jeszcze nie skonfigurowano, pojawiają się poniżej tabeli w grupie „Dostępne w ramach promocji”, każda z poleceniem odebrania.
- Modele zarejestrowane za pomocą
promos claimmają znacznikpromo, który po zakończeniu okresu obowiązywania oferty zmienia się napromo ended. - Gdy nowa oferta zostanie wykryta po raz pierwszy, jednorazowe powiadomienie
wskazuje polecenie
openclaw promos list. Oferty, które już wyświetlono lub odebrano, nie są ponownie ogłaszane.
Mechanizm odczytuje lokalnie buforowaną kopię hostowanego w ClawHub kanału
promocji (zwykle odświeżaną raz dziennie za pomocą żądania warunkowego lub
wcześniej, gdy buforowany zapis wygaśnie; nieudane próby odświeżenia są po
cichu pomijane). Odświeżanie nieaktualnej kopii trwa najwyżej 2,5 sekundy i
nigdy nie zakłóca wyświetlania listy. Dane wyjściowe --json i --plain
pozostają czyste i przeznaczone do przetwarzania maszynowego: bez sekcji
promocji ani powiadomień. Odebranie promocji zawsze powoduje jej ponowną
weryfikację w aktywnym API ClawHub, dlatego oferta wycofana przed terminem
zostanie odrzucona, nawet jeśli nadal widnieje w buforowanej kopii.