Fundamentals
Funkcje eksperymentalne
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
| Powierzchnia | Klucz | Użyj jej, gdy | Więcej |
|---|---|---|---|
| Lokalne środowisko modeli | agents.defaults.experimental.localModelLean |
Mniejszy albo bardziej rygorystyczny lokalny backend dławi się pełną domyślną powierzchnią narzędzi OpenClaw | Modele lokalne |
| Wyszukiwanie w pamięci | agents.defaults.memorySearch.experimental.sessionMemory |
Chcesz, aby memory_search indeksowało transkrypty poprzednich sesji, i akceptujesz dodatkowy koszt pamięci/indeksowania |
Dokumentacja konfiguracji pamięci |
| Narzędzie planowania strukturalnego | tools.experimental.planTool |
Chcesz udostępnić strukturalne narzędzie update_plan do śledzenia pracy wieloetapowej w zgodnych środowiskach uruchomieniowych i interfejsach UI |
Dokumentacja 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:
openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"kończy się powodzeniem.- 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.
- Przełączenie
localModelLean: trueusuwa 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.