13 KiB
13 KiB
| read_when | summary | title | x-i18n | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Składnia dyrektyw dla `/think`, `/fast`, `/verbose`, `/trace` oraz widoczności rozumowania | Poziomy myślenia |
|
Co to robi
- Dyrektywa inline w dowolnej treści przychodzącej:
/t <level>,/think:<level>lub/thinking <level>. - Poziomy (aliasy):
off | minimal | low | medium | high | xhigh | adaptive | max- minimal → „think”
- low → „think hard”
- medium → „think harder”
- high → „ultrathink” (maksymalny budżet)
- xhigh → „ultrathink+” (modele GPT-5.2+ i Codex oraz poziom effort Anthropic Claude Opus 4.7)
- adaptive → zarządzane przez dostawcę myślenie adaptacyjne (obsługiwane dla Claude 4.6 w Anthropic/Bedrock, Anthropic Claude Opus 4.7 oraz dynamic thinking Google Gemini)
- max → maksymalne rozumowanie dostawcy (obecnie Anthropic Claude Opus 4.7)
x-high,x_high,extra-high,extra highiextra_highsą mapowane naxhigh.highestjest mapowane nahigh.
- Uwagi dotyczące dostawców:
- Menu i selektory myślenia są sterowane przez profile dostawców. Plugin dostawcy deklarują dokładny zestaw poziomów dla wybranego modelu, w tym etykiety takie jak binarne
on. adaptive,xhighimaxsą ogłaszane tylko dla profili dostawca/model, które je obsługują. Wpisane dyrektywy dla nieobsługiwanych poziomów są odrzucane wraz z poprawnymi opcjami dla danego modelu.- Istniejące zapisane nieobsługiwane poziomy są przemapowywane według rangi profilu dostawcy.
adaptiveprzechodzi namediumw modelach nieadaptacyjnych, axhighimaxprzechodzą na najwyższy obsługiwany poziom inny niżoffdla wybranego modelu. - Modele Anthropic Claude 4.6 domyślnie używają
adaptive, gdy nie ustawiono jawnego poziomu myślenia. - Anthropic Claude Opus 4.7 nie domyślnie nie używa myślenia adaptacyjnego. Domyślna wartość effort w jego API pozostaje zarządzana przez dostawcę, chyba że jawnie ustawisz poziom myślenia.
- Anthropic Claude Opus 4.7 mapuje
/think xhighna myślenie adaptacyjne plusoutput_config.effort: "xhigh", ponieważ/thinkjest dyrektywą myślenia, axhighjest ustawieniem effort dla Opus 4.7. - Anthropic Claude Opus 4.7 udostępnia także
/think max; jest ono mapowane na tę samą ścieżkę maksymalnego effort zarządzaną przez dostawcę. - Modele OpenAI GPT mapują
/thinkprzez obsługę effort specyficzną dla modelu w Responses API./think offwysyłareasoning.effort: "none"tylko wtedy, gdy model docelowy to obsługuje; w przeciwnym razie OpenClaw pomija ładunek wyłączonego rozumowania zamiast wysyłać nieobsługiwaną wartość. - Google Gemini mapuje
/think adaptivena dynamic thinking zarządzane przez dostawcę Gemini. Żądania Gemini 3 pomijają stałethinkingLevel, a żądania Gemini 2.5 wysyłająthinkingBudget: -1; stałe poziomy nadal są mapowane do najbliższegothinkingLevellub budżetu Gemini dla tej rodziny modeli. - MiniMax (
minimax/*) na ścieżce strumieniowania zgodnej z Anthropic domyślnie używathinking: { type: "disabled" }, chyba że jawnie ustawisz thinking w parametrach modelu lub żądania. Zapobiega to wyciekom deltreasoning_contentz nienatywnego formatu strumienia Anthropic w MiniMax. - Z.AI (
zai/*) obsługuje tylko binarne myślenie (on/off). Każdy poziom inny niżoffjest traktowany jakoon(mapowany dolow). - Moonshot (
moonshot/*) mapuje/think offnathinking: { type: "disabled" }, a każdy poziom inny niżoffnathinking: { type: "enabled" }. Gdy thinking jest włączone, Moonshot akceptuje tylkotool_choiceauto|none; OpenClaw normalizuje niezgodne wartości doauto.
- Menu i selektory myślenia są sterowane przez profile dostawców. Plugin dostawcy deklarują dokładny zestaw poziomów dla wybranego modelu, w tym etykiety takie jak binarne
Kolejność rozwiązywania
- Dyrektywa inline w wiadomości (dotyczy tylko tej wiadomości).
- Nadpisanie sesji (ustawiane przez wysłanie wiadomości zawierającej wyłącznie dyrektywę).
- Domyślna wartość dla agenta (
agents.list[].thinkingDefaultw konfiguracji). - Globalna wartość domyślna (
agents.defaults.thinkingDefaultw konfiguracji). - Fallback: wartość domyślna zadeklarowana przez dostawcę, jeśli jest dostępna; w przeciwnym razie modele zdolne do rozumowania przyjmują
mediumlub najbliższy obsługiwany poziom inny niżoffdla danego modelu, a modele bez rozumowania pozostają przyoff.
Ustawianie domyślnej wartości sesji
- Wyślij wiadomość, która zawiera wyłącznie dyrektywę (dozwolone są białe znaki), np.
/think:mediumlub/t high. - To ustawienie pozostaje dla bieżącej sesji (domyślnie per nadawca); jest czyszczone przez
/think:offlub reset bezczynności sesji. - Wysyłana jest odpowiedź potwierdzająca (
Thinking level set to high./Thinking disabled.). Jeśli poziom jest nieprawidłowy (np./thinking big), polecenie zostaje odrzucone z podpowiedzią, a stan sesji pozostaje bez zmian. - Wyślij
/think(lub/think:) bez argumentu, aby zobaczyć bieżący poziom myślenia.
Zastosowanie według agenta
- Osadzony Pi: rozstrzygnięty poziom jest przekazywany do środowiska wykonawczego agenta Pi działającego w procesie.
Tryb szybki (/fast)
- Poziomy:
on|off. - Wiadomość zawierająca wyłącznie dyrektywę przełącza nadpisanie trybu szybkiego dla sesji i odpowiada
Fast mode enabled./Fast mode disabled.. - Wyślij
/fast(lub/fast status) bez trybu, aby zobaczyć bieżący efektywny stan trybu szybkiego. - OpenClaw rozwiązuje tryb szybki w następującej kolejności:
- Inline / zawierające wyłącznie dyrektywę
/fast on|off - Nadpisanie sesji
- Domyślna wartość dla agenta (
agents.list[].fastModeDefault) - Konfiguracja dla modelu:
agents.defaults.models["<provider>/<model>"].params.fastMode - Fallback:
off
- Inline / zawierające wyłącznie dyrektywę
- Dla
openai/*tryb szybki mapuje się na przetwarzanie priorytetowe OpenAI przez wysłanieservice_tier=priorityw obsługiwanych żądaniach Responses. - Dla
openai-codex/*tryb szybki wysyła tę samą flagęservice_tier=priorityw Codex Responses. OpenClaw utrzymuje jedno wspólne przełączenie/fastdla obu ścieżek uwierzytelniania. - Dla bezpośrednich publicznych żądań
anthropic/*, w tym ruchu uwierzytelnianego przez OAuth wysyłanego doapi.anthropic.com, tryb szybki mapuje się na poziomy service tier Anthropic:/fast onustawiaservice_tier=auto, a/fast offustawiaservice_tier=standard_only. - Dla
minimax/*na ścieżce zgodnej z Anthropic/fast on(lubparams.fastMode: true) przepisujeMiniMax-M2.7naMiniMax-M2.7-highspeed. - Jawne parametry modelu Anthropic
serviceTier/service_tiermają pierwszeństwo przed domyślną wartością trybu szybkiego, gdy ustawione są oba. OpenClaw nadal pomija wstrzykiwanie service tier Anthropic dla nieanthropicowych bazowych adresów URL proxy. /statuspokazujeFasttylko wtedy, gdy tryb szybki jest włączony.
Dyrektywy szczegółowości (/verbose lub /v)
- Poziomy:
on(minimalny) |full|off(domyślnie). - Wiadomość zawierająca wyłącznie dyrektywę przełącza szczegółowość sesji i odpowiada
Verbose logging enabled./Verbose logging disabled.; nieprawidłowe poziomy zwracają podpowiedź bez zmiany stanu. /verbose offzapisuje jawne nadpisanie sesji; wyczyść je w interfejsie Sessions, wybierającinherit.- Dyrektywa inline dotyczy tylko tej wiadomości; w przeciwnym razie stosowane są domyślne ustawienia sesji/globalne.
- Wyślij
/verbose(lub/verbose:) bez argumentu, aby zobaczyć bieżący poziom szczegółowości. - Gdy szczegółowość jest włączona, agenci emitujący uporządkowane wyniki narzędzi (Pi, inni agenci JSON) wysyłają każde wywołanie narzędzia z powrotem jako osobną wiadomość zawierającą wyłącznie metadane, z prefiksem
<emoji> <tool-name>: <arg>, jeśli jest dostępny (ścieżka/polecenie). Te podsumowania narzędzi są wysyłane, gdy tylko każde narzędzie się uruchomi (osobne dymki), a nie jako delty strumieniowe. - Podsumowania błędów narzędzi pozostają widoczne w trybie normalnym, ale surowe sufiksy ze szczegółami błędów są ukryte, chyba że
verbosema wartośćonlubfull. - Gdy
verbosema wartośćfull, wyjścia narzędzi są także przekazywane po zakończeniu (osobny dymek, obcięty do bezpiecznej długości). Jeśli przełączysz/verbose on|full|off, gdy przebieg jest w toku, kolejne dymki narzędzi uwzględnią nowe ustawienie.
Dyrektywy śledzenia Plugin (/trace)
- Poziomy:
on|off(domyślnie). - Wiadomość zawierająca wyłącznie dyrektywę przełącza wyjście śledzenia Plugin dla sesji i odpowiada
Plugin trace enabled./Plugin trace disabled.. - Dyrektywa inline dotyczy tylko tej wiadomości; w przeciwnym razie stosowane są domyślne ustawienia sesji/globalne.
- Wyślij
/trace(lub/trace:) bez argumentu, aby zobaczyć bieżący poziom śledzenia. /tracejest węższe niż/verbose: ujawnia tylko linie śledzenia/debugowania należące do Plugin, takie jak podsumowania debugowania Active Memory.- Linie śledzenia mogą pojawiać się w
/statusoraz jako kolejna wiadomość diagnostyczna po zwykłej odpowiedzi asystenta.
Widoczność rozumowania (/reasoning)
- Poziomy:
on|off|stream. - Wiadomość zawierająca wyłącznie dyrektywę przełącza to, czy bloki myślenia są pokazywane w odpowiedziach.
- Gdy ta opcja jest włączona, rozumowanie jest wysyłane jako osobna wiadomość z prefiksem
Reasoning:. stream(tylko Telegram): strumieniuje rozumowanie do dymka szkicu Telegram podczas generowania odpowiedzi, a następnie wysyła ostateczną odpowiedź bez rozumowania.- Alias:
/reason. - Wyślij
/reasoning(lub/reasoning:) bez argumentu, aby zobaczyć bieżący poziom rozumowania. - Kolejność rozwiązywania: dyrektywa inline, następnie nadpisanie sesji, potem domyślna wartość dla agenta (
agents.list[].reasoningDefault), a następnie fallback (off).
Powiązane
- Dokumentacja trybu Elevated znajduje się w Tryb Elevated.
Heartbeat
- Treść sondy Heartbeat to skonfigurowany prompt heartbeat (domyślnie:
Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.). Dyrektywy inline w wiadomości heartbeat działają jak zwykle (ale unikaj zmieniania domyślnych ustawień sesji z heartbeatów). - Dostarczanie Heartbeat domyślnie obejmuje tylko końcowy ładunek. Aby wysyłać także osobną wiadomość
Reasoning:(gdy jest dostępna), ustawagents.defaults.heartbeat.includeReasoning: truelub per-agentagents.list[].heartbeat.includeReasoning: true.
Interfejs czatu webowego
- Selektor myślenia w czacie webowym odzwierciedla zapisany poziom sesji z magazynu/konfiguracji sesji przychodzącej podczas ładowania strony.
- Wybranie innego poziomu zapisuje nadpisanie sesji natychmiast przez
sessions.patch; nie czeka na następne wysłanie i nie jest jednorazowym nadpisaniemthinkingOnce. - Pierwsza opcja to zawsze
Default (<resolved level>), gdzie rozstrzygnięta wartość domyślna pochodzi z profilu myślenia dostawcy dla aktywnego modelu sesji oraz z tej samej logiki fallbacku, której używają/statusisession_status. - Selektor używa
thinkingLevelszwracanych przez wiersz/domyślne wartości sesji gateway, athinkingOptionspozostaje starszą listą etykiet. Interfejs przeglądarkowy nie utrzymuje własnej listy regexów dostawców; Plugin są właścicielami zestawów poziomów specyficznych dla modelu. /think:<level>nadal działa i aktualizuje ten sam zapisany poziom sesji, więc dyrektywy czatu i selektor pozostają zsynchronizowane.
Profile dostawców
- Plugin dostawcy mogą udostępniać
resolveThinkingProfile(ctx), aby definiować obsługiwane poziomy modelu i wartość domyślną. - Każdy poziom profilu ma zapisany kanoniczny
id(off,minimal,low,medium,high,xhigh,adaptivelubmax) i może zawierać wyświetlanąlabel. Dostawcy binarni używają{ id: "low", label: "on" }. - Opublikowane starsze hooki (
supportsXHighThinking,isBinaryThinkingiresolveDefaultThinkingLevel) pozostają adapterami zgodności, ale nowe niestandardowe zestawy poziomów powinny używaćresolveThinkingProfile. - Wiersze/domyślne wartości Gateway udostępniają
thinkingLevels,thinkingOptionsithinkingDefault, aby klienci ACP/czatu renderowali te same identyfikatory i etykiety profili, których używa walidacja środowiska wykonawczego.