Fundamentals
Експериментальні функції
Експериментальні функції в OpenClaw — це preview-поверхні з явним увімкненням. Вони приховані за явними прапорцями, бо їм ще потрібна реальна перевірка в користуванні, перш ніж вони заслуговуватимуть на стабільне значення за замовчуванням або довготривалий публічний контракт.
Ставтеся до них інакше, ніж до звичайної конфігурації:
- Тримайте їх вимкненими за замовчуванням, якщо пов’язана документація не пропонує спробувати одну з них.
- Очікуйте, що форма й поведінка змінюватимуться швидше, ніж у стабільної конфігурації.
- Спочатку віддавайте перевагу стабільному шляху, якщо він уже існує.
- Якщо ви широко впроваджуєте OpenClaw, тестуйте експериментальні прапорці в меншому середовищі, перш ніж вбудовувати їх у спільну базову конфігурацію.
Наразі задокументовані прапорці
| Поверхня | Ключ | Коли використовувати | Докладніше |
|---|---|---|---|
| Локальне виконання моделі | agents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLean |
Менший або суворіший локальний бекенд не справляється з повною стандартною поверхнею інструментів OpenClaw | Локальні моделі |
| Пошук у пам’яті | agents.defaults.memorySearch.experimental.sessionMemory |
Ви хочете, щоб memory_search індексував стенограми попередніх сеансів, і приймаєте додаткову вартість зберігання/індексації |
Довідник конфігурації пам’яті |
| Обв’язка Codex | plugins.entries.codex.config.appServer.experimental.sandboxExecServer |
Ви хочете, щоб нативний app-server Codex 0.132.0 або новіший націлювався на exec-server OpenClaw із sandbox-підтримкою замість вимкнення Code Mode | Довідник обв’язки Codex |
| Інструмент структурованого планування | tools.experimental.planTool |
Ви хочете відкрити структурований інструмент update_plan для відстеження багатоетапної роботи в сумісних runtime і UI |
Довідник конфігурації Gateway |
Економний режим локальної моделі
agents.defaults.experimental.localModelLean: true — це клапан скидання тиску для слабших налаштувань локальних моделей. Коли він увімкнений, OpenClaw прибирає три стандартні інструменти — browser, cron і message — з поверхні інструментів агента для кожного ходу. Також для цього запуску за замовчуванням використовуються структуровані елементи керування Пошуком інструментів, коли tools.toolSearch не налаштовано явно, тож більші каталоги інструментів Plugin, MCP або клієнта залишаються за tool_search, tool_describe і tool_call замість того, щоб потрапляти безпосередньо в prompt. Запуски, яким потрібна пряма доставка message, залишають цей інструмент прямим замість увімкнення стандартного Пошуку інструментів економного режиму. Використовуйте agents.list[].experimental.localModelLean, щоб увімкнути або вимкнути ту саму поведінку для одного налаштованого агента.
Чому саме ці три інструменти
Ці три інструменти мають найбільші описи й найбільше форм параметрів у стандартному runtime OpenClaw. На бекенді з малим контекстом або суворішою OpenAI-сумісністю це різниця між:
- Схемами інструментів, що акуратно вміщуються в prompt, і витісненням історії розмови.
- Тим, що модель вибирає правильний інструмент, і тим, що вона видає некоректно сформовані виклики інструментів через забагато схожих схем.
- Тим, що адаптер Chat Completions залишається в межах обмежень структурованого виводу сервера, і помилкою 400 через розмір payload виклику інструменту.
Їх вилучення не перемонтовує OpenClaw непомітно — воно лише скорочує прямий список інструментів. Модель усе ще має доступні read, write, edit, exec, apply_patch, вебпошук/отримання (коли налаштовано), пам’ять та інструменти сеансу/агента. Додаткові каталоги залишаються доступними для виклику через Пошук інструментів, якщо ви явно не задасте tools.toolSearch: false.
Коли його вмикати
Увімкніть економний режим, коли ви вже довели, що модель може спілкуватися з Gateway, але повні ходи агента працюють некоректно. Типовий ланцюг сигналів:
openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"успішно виконується.- Звичайний хід агента завершується помилкою через некоректно сформовані виклики інструментів, завеликі prompts або ігнорування інструментів моделлю.
- Перемикання
localModelLean: trueусуває збій.
Коли залишати його вимкненим
Якщо ваш бекенд коректно обробляє повний стандартний runtime, залиште це вимкненим. Економний режим — це обхідний шлях, а не стандарт. Він існує, бо деяким локальним стекам потрібна менша поверхня інструментів для коректної роботи; розміщеним моделям і добре забезпеченим локальним конфігураціям це не потрібно.
Економний режим також не замінює tools.profile, tools.allow/tools.deny або аварійний вихід compat.supportsTools: false моделі. Якщо вам потрібна постійно вужча поверхня інструментів для конкретного агента, віддавайте перевагу цим стабільним перемикачам замість експериментального прапорця.
Якщо ви вже глобально налаштовуєте Пошук інструментів, OpenClaw залишає цю операторську конфігурацію без змін. Задайте tools.toolSearch: false, щоб відмовитися від стандартного Пошуку інструментів економного режиму.
Увімкнення
{ agents: { defaults: { experimental: { localModelLean: true, }, }, },}Лише для одного агента:
{ agents: { list: [ { id: "local", model: "lmstudio/gemma-4-e4b-it", experimental: { localModelLean: true, }, }, ], },}Перезапустіть Gateway після зміни прапорця, а потім підтвердьте скорочений список інструментів за допомогою:
openclaw status --deepГлибокий вивід статусу перелічує активні інструменти агента; browser, cron і message мають бути відсутніми, коли економний режим увімкнений, якщо поточний режим доставки не примушує прямі відповіді message.
Експериментальне не означає приховане
Якщо функція експериментальна, OpenClaw має прямо казати про це в документації та в самому шляху конфігурації. Чого він не має робити — це протягувати preview-поведінку в перемикач за замовчуванням, що виглядає стабільним, і вдавати, ніби це нормально. Саме так конфігураційні поверхні стають безладними.
