Перейти к основному содержанию
Экспериментальные функции в OpenClaw — это предварительные поверхности с явным включением. Они находятся за явными флагами, потому что им еще нужен реальный опыт использования, прежде чем они заслужат стабильное значение по умолчанию или долгоживущий публичный контракт. Относитесь к ним иначе, чем к обычной конфигурации:
  • Держите их выключенными по умолчанию, если связанная документация не предлагает попробовать одну из них.
  • Ожидайте, что форма и поведение будут меняться быстрее, чем у стабильной конфигурации.
  • Сначала предпочитайте стабильный путь, если он уже существует.
  • Если вы широко развертываете OpenClaw, тестируйте экспериментальные флаги в меньшей среде, прежде чем закреплять их в общей базовой конфигурации.

Сейчас документированные флаги

ПоверхностьКлючИспользуйте, когдаПодробнее
Локальная среда выполнения моделиagents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLeanМеньший или более строгий локальный бэкенд не справляется с полной стандартной поверхностью инструментов OpenClawЛокальные модели
Поиск в памятиagents.defaults.memorySearch.experimental.sessionMemoryВы хотите, чтобы memory_search индексировал стенограммы предыдущих сеансов, и готовы принять дополнительные расходы на хранение/индексациюСправочник по конфигурации памяти
Оснастка Codexplugins.entries.codex.config.appServer.experimental.sandboxExecServerВы хотите, чтобы нативный app-server Codex 0.132.0 или новее использовал exec-server OpenClaw на основе песочницы вместо отключения Code ModeСправочник по оснастке Codex
Инструмент структурированного планированияtools.experimental.planToolВы хотите открыть структурированный инструмент update_plan для отслеживания многошаговой работы в совместимых средах выполнения и UIСправочник по конфигурации Gateway

Облегченный режим локальной модели

agents.defaults.experimental.localModelLean: true — это предохранительный клапан для более слабых локальных модельных настроек. Когда он включен, OpenClaw убирает три стандартных инструмента — browser, cron и message — из поверхности инструментов агента на каждом ходе. Он также по умолчанию переводит такой запуск на структурированные элементы управления Tool Search, когда tools.toolSearch не настроен явно, чтобы более крупные каталоги Plugin, MCP или клиентских инструментов оставались за tool_search, tool_describe и tool_call, а не выгружались в промпт. Запуски, которым требуется прямая доставка message, оставляют этот инструмент прямым вместо включения стандартного Tool Search для облегченного режима. Используйте agents.list[].experimental.localModelLean, чтобы включить или отключить то же поведение для одного настроенного агента.

Почему эти три инструмента

У этих трех инструментов самые большие описания и больше всего форм параметров в стандартной среде выполнения OpenClaw. На бэкенде с малым контекстом или более строгом OpenAI-совместимом бэкенде это разница между:
  • Схемы инструментов чисто помещаются в промпт, а не вытесняют историю разговора.
  • Модель выбирает правильный инструмент, а не выдает некорректные вызовы инструментов из-за слишком большого числа похожих схем.
  • Адаптер Chat Completions остается в пределах ограничений структурированного вывода сервера, а не натыкается на 400 из-за размера полезной нагрузки вызова инструмента.
Их удаление не перенастраивает OpenClaw незаметно — оно просто сокращает список прямых инструментов. У модели все еще доступны read, write, edit, exec, apply_patch, веб-поиск/получение страниц (если настроено), память и инструменты сеанса/агента. Дополнительные каталоги остаются вызываемыми через Tool Search, если вы явно не зададите tools.toolSearch: false.

Когда включать

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

Когда оставлять выключенным

Если ваш бэкенд чисто обрабатывает полную стандартную среду выполнения, оставьте это выключенным. Облегченный режим — это обходной путь, а не значение по умолчанию. Он существует потому, что некоторым локальным стекам нужна меньшая поверхность инструментов для корректной работы; размещенным моделям и хорошо обеспеченным локальным установкам он не нужен. Облегченный режим также не заменяет tools.profile, tools.allow/tools.deny или аварийный выход модели compat.supportsTools: false. Если вам нужна постоянная более узкая поверхность инструментов для конкретного агента, предпочитайте эти стабильные регуляторы экспериментальному флагу. Если вы уже настраиваете Tool Search глобально, OpenClaw не трогает эту операторскую конфигурацию. Задайте tools.toolSearch: false, чтобы отказаться от стандартного Tool Search облегченного режима.

Включение

{
  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 должен прямо говорить об этом в документации и в самом пути конфигурации. Чего он не должен делать — это протаскивать предварительное поведение в регулятор, который выглядит стабильным, и притворяться, что это нормально. Именно так поверхности конфигурации становятся беспорядочными.

Связанное