Fundamentals

Експериментальні можливості

Експериментальні функції в OpenClaw — це preview-поверхні з явним увімкненням. Вони приховані за явними прапорцями, бо їм ще потрібна перевірка в реальних умовах, перш ніж вони заслуговуватимуть на стабільне значення за замовчуванням або довготривалий публічний контракт.

Ставтеся до них інакше, ніж до звичайної конфігурації:

  • Тримайте їх вимкненими за замовчуванням, якщо відповідна документація не радить спробувати якусь із них.
  • Очікуйте, що форма й поведінка змінюватимуться швидше, ніж у стабільної конфігурації.
  • Спершу віддавайте перевагу стабільному шляху, якщо він уже існує.
  • Якщо ви розгортаєте OpenClaw широко, тестуйте експериментальні прапорці в меншому середовищі, перш ніж закладати їх у спільну базову конфігурацію.

Наразі задокументовані прапорці

Поверхня Ключ Використовуйте, коли Докладніше
Локальне середовище виконання моделі agents.defaults.experimental.localModelLean Менший або суворіший локальний бекенд не справляється з повною стандартною поверхнею інструментів OpenClaw Локальні моделі
Пошук у пам'яті agents.defaults.memorySearch.experimental.sessionMemory Ви хочете, щоб memory_search індексував транскрипти попередніх сесій, і готові прийняти додаткову вартість зберігання/індексації Довідник з конфігурації пам'яті
Інструмент структурованого планування tools.experimental.planTool Ви хочете відкрити структурований інструмент update_plan для відстеження багатокрокової роботи в сумісних середовищах виконання та UI Довідник з конфігурації Gateway

Полегшений режим локальної моделі

agents.defaults.experimental.localModelLean: true — це запобіжний клапан для слабших налаштувань локальних моделей. Коли він увімкнений, OpenClaw прибирає три стандартні інструменти — browser, cron і message — з поверхні інструментів агента для кожного ходу. Більше нічого не змінюється.

Чому саме ці три інструменти

Ці три інструменти мають найбільші описи й найбільше форм параметрів у стандартному середовищі виконання OpenClaw. Для бекенду з малим контекстом або суворішого OpenAI-сумісного бекенду це різниця між:

  • Тим, що схеми інструментів акуратно вміщуються в промпт, і тим, що вони витісняють історію розмови.
  • Тим, що модель вибирає правильний інструмент, і тим, що вона видає неправильно сформовані виклики інструментів через завелику кількість схожих схем.
  • Тим, що адаптер Chat Completions залишається в межах серверних обмежень структурованого виводу, і тим, що він отримує 400 через розмір payload виклику інструменту.

Їх видалення не перемикає OpenClaw непомітно на іншу логіку — воно просто скорочує список інструментів. Модель і далі має доступ до read, write, edit, exec, apply_patch, веб-пошуку/отримання вебданих (коли налаштовано), пам'яті та інструментів сесії/агента.

Коли вмикати

Увімкніть полегшений режим, коли ви вже довели, що модель може спілкуватися з Gateway, але повні агентні ходи поводяться неправильно. Типовий ланцюжок сигналів такий:

  1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong" завершується успішно.
  2. Звичайний агентний хід завершується помилкою через неправильно сформовані виклики інструментів, завеликі промпти або ігнорування інструментів моделлю.
  3. Перемикання localModelLean: true усуває збій.

Коли залишати вимкненим

Якщо ваш бекенд коректно обробляє повне стандартне середовище виконання, залиште це вимкненим. Полегшений режим — це обхідний шлях, а не значення за замовчуванням. Він існує тому, що деяким локальним стекам потрібна менша поверхня інструментів для коректної роботи; hosted-моделям і добре забезпеченим локальним установкам це не потрібно.

Полегшений режим також не замінює tools.profile, tools.allow/tools.deny або аварійний вихід моделі compat.supportsTools: false. Якщо вам потрібна постійно вужча поверхня інструментів для конкретного агента, віддавайте перевагу цим стабільним перемикачам, а не експериментальному прапорцю.

Увімкнення

{
  agents: {
    defaults: {
      experimental: {
        localModelLean: true,
      },
    },
  },
}

Перезапустіть Gateway після зміни прапорця, а потім підтвердьте скорочений список інструментів за допомогою:

openclaw status --deep

Вивід глибокого статусу перелічує активні інструменти агента; browser, cron і message мають бути відсутні, коли полегшений режим увімкнено.

Експериментальне не означає приховане

Якщо функція експериментальна, OpenClaw має прямо сказати про це в документації та в самому шляху конфігурації. Чого він не має робити, так це непомітно протягувати preview-поведінку в перемикач, що виглядає стабільним значенням за замовчуванням, і вдавати, що це нормально. Саме так поверхні конфігурації стають безладними.

Пов'язане