Przejdź do głównej treści

Documentation Index

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

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

Funkcje eksperymentalne w OpenClaw to opcjonalne powierzchnie podglądu. Są ukryte za jawnymi flagami, ponieważ nadal wymagają sprawdzenia w realnym użyciu, zanim zasłużą na stabilne ustawienie domyślne albo długotrwały publiczny kontrakt. Traktuj je inaczej niż zwykłą konfigurację:
  • Pozostaw je domyślnie wyłączone, chyba że powiązana dokumentacja sugeruje ich wypróbowanie.
  • Zakładaj, że ich kształt i zachowanie będą zmieniać się szybciej niż stabilna konfiguracja.
  • Najpierw wybieraj stabilną ścieżkę, jeśli już istnieje.
  • Jeśli wdrażasz OpenClaw szeroko, przetestuj flagi eksperymentalne w mniejszym środowisku, zanim wpiszesz je do współdzielonej konfiguracji bazowej.

Obecnie udokumentowane flagi

PowierzchniaKluczUżyj jej, gdyWięcej
Lokalne środowisko modeliagents.defaults.experimental.localModelLeanMniejszy albo bardziej rygorystyczny lokalny backend dławi się pełną domyślną powierzchnią narzędzi OpenClawModele lokalne
Wyszukiwanie w pamięciagents.defaults.memorySearch.experimental.sessionMemoryChcesz, aby memory_search indeksowało transkrypty poprzednich sesji, i akceptujesz dodatkowy koszt pamięci/indeksowaniaDokumentacja konfiguracji pamięci
Narzędzie planowania strukturalnegotools.experimental.planToolChcesz udostępnić strukturalne narzędzie update_plan do śledzenia pracy wieloetapowej w zgodnych środowiskach uruchomieniowych i interfejsach UIDokumentacja konfiguracji Gateway

Tryb odchudzony modeli lokalnych

agents.defaults.experimental.localModelLean: true to zawór bezpieczeństwa dla słabszych konfiguracji modeli lokalnych. Gdy jest włączony, OpenClaw usuwa trzy domyślne narzędzia — browser, cron i message — z powierzchni narzędzi agenta w każdej turze. Nic innego się nie zmienia.

Dlaczego te trzy narzędzia

Te trzy narzędzia mają najdłuższe opisy i najwięcej kształtów parametrów w domyślnym środowisku uruchomieniowym OpenClaw. W backendzie zgodnym z OpenAI, który ma mały kontekst albo bardziej rygorystyczne limity, to różnica między:
  • Schematami narzędzi mieszczącymi się czysto w prompcie a wypychaniem historii rozmowy.
  • Modelem wybierającym właściwe narzędzie a emitowaniem niepoprawnych wywołań narzędzi, bo istnieje zbyt wiele podobnie wyglądających schematów.
  • Adapterem Chat Completions mieszczącym się w limitach ustrukturyzowanego wyjścia serwera a błędem 400 przez zbyt duży payload wywołania narzędzia.
Usunięcie ich nie przepina OpenClaw po cichu — po prostu skraca listę narzędzi. Model nadal ma dostępne read, write, edit, exec, apply_patch, wyszukiwanie/pobieranie z sieci (gdy skonfigurowane), pamięć oraz narzędzia sesji/agenta.

Kiedy włączyć

Włącz tryb odchudzony, gdy masz już dowód, że model potrafi rozmawiać z Gateway, ale pełne tury agenta działają niepoprawnie. Typowy ciąg sygnałów wygląda tak:
  1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong" kończy się powodzeniem.
  2. Zwykła tura agenta kończy się błędami przez niepoprawnie sformatowane wywołania narzędzi, zbyt duże prompty albo ignorowanie narzędzi przez model.
  3. Przełączenie localModelLean: true usuwa problem.

Kiedy pozostawić wyłączone

Jeśli Twój backend bez problemu obsługuje pełne domyślne środowisko uruchomieniowe, pozostaw tę flagę wyłączoną. Tryb odchudzony jest obejściem, a nie ustawieniem domyślnym. Istnieje, ponieważ niektóre lokalne stosy potrzebują mniejszej powierzchni narzędzi, aby działać poprawnie; modele hostowane i dobrze wyposażone lokalne zestawy tego nie wymagają. Tryb odchudzony nie zastępuje też tools.profile, tools.allow/tools.deny ani awaryjnej ścieżki compat.supportsTools: false modelu. Jeśli potrzebujesz trwale węższej powierzchni narzędzi dla konkretnego agenta, użyj tych stabilnych pokręteł zamiast flagi eksperymentalnej.

Włączanie

{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}
Po zmianie flagi uruchom ponownie Gateway, a następnie potwierdź przyciętą listę narzędzi poleceniem:
openclaw status --deep
Głębokie dane statusu wypisują aktywne narzędzia agenta; gdy tryb odchudzony jest włączony, browser, cron i message powinny być nieobecne.

Eksperymentalne nie oznacza ukryte

Jeśli funkcja jest eksperymentalna, OpenClaw powinien mówić o tym wprost w dokumentacji i w samej ścieżce konfiguracji. Nie powinien natomiast przemycać zachowania podglądowego do stabilnie wyglądającego pokrętła domyślnego i udawać, że to normalne. W ten sposób powierzchnie konfiguracji robią się chaotyczne.

Powiązane