OpenClaw invalid beta flag: как найти и исправить причину ошибки

При ошибке invalid beta flag в OpenClaw сначала найдите отклонённую beta-функцию и провайдера, которому ушёл запрос. Если ненужный заголовок anthropic-beta явно задан для несовместимого прокси, исправьте этот заголовок. Если его добавляет OpenClaw для включённой функции или сам прокси перед отправкой поставщику, изменение нужно делать там. Отключение context1m и добавление "beta_features": [] не являются универсальными решениями.

Начните с одного неудачного запроса: зафиксируйте модель, способ подключения, точный текст ошибки и имя beta, если оно указано. Затем меняйте только выявленную причину. Исправление подтверждается полным ответом исходной модели после загрузки новых настроек; успешный запуск Gateway и проверка JSON этого не доказывают.

Ниже описаны действия по официальной документации, проверенной 4 октября 2026 года. Это инструкция для диагностики, а не отчёт о воспроизведении ошибки на вашем аккаунте.

Что означает invalid beta flag и когда это ошибка 400

В прямом API Anthropic заголовок anthropic-beta включает конкретную экспериментальную функцию. Неверное имя beta или отсутствие доступа у организации может привести к HTTP 400 с типом invalid_request_error. Такую причину описывает документация beta-заголовков Anthropic. Похожий текст от прокси или облачного сервиса нужно читать вместе с его собственным ответом: один статус 400 не устанавливает причину.

Сокращённый пример формы ошибки:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "invalid beta flag"
  }
}

Это иллюстрация формата, а не журнал реального вызова. На практике сообщение может назвать отклонённый флаг; сохраните его полностью, включая дату в имени. Если имени нет, сопоставьте список переданных beta с возможностями выбранной модели, API и аккаунта.

Несколько beta могут передаваться через запятую или повторяющиеся заголовки. Поэтому удаление одного поля в настройках не всегда означает, что вся цепочка перестала отправлять флаг: другой заголовок мог добавить клиент или посредник. При этом заголовок, предназначенный для отдельного API, нельзя автоматически переносить в Messages API. У каждой функции есть собственные условия применения.

Отделите похожие симптомы:

Если отказ относится к авторизации, переходите к диагностике OpenClaw 401. Замена токена Gateway не исправляет отклонённую beta-функцию.

Найдите запрос, модель и активную конфигурацию

Проверяйте машину и пользователя службы Gateway, где выполняется проблемный запрос. Настройки в терминале на другом компьютере могут не относиться к работающему процессу.

Сначала выполните команды просмотра состояния:

openclaw --version
openclaw gateway status
openclaw config file
openclaw config validate
openclaw models status --agent main --json

Здесь main — пример ID агента; замените его на проблемного агента. config file показывает используемый путь настроек. config validate проверяет конфигурацию, не запуская Gateway и не вызывая модель. Даже допустимый по схеме параметр может оказаться неподдерживаемым у поставщика. Область этих команд описана в документации config CLI.

В исходном чате отправьте:

/model status

Сопоставьте выбор сессии с настройками агента. Затем в отдельном терминале откройте журнал:

openclaw logs --follow

Повторите один короткий запрос в той же сессии и остановите просмотр журнала сочетанием Ctrl+C. Не запускайте повторно рабочее задание, которое уже могло изменить файлы или вызвать инструменты. Для диагностики достаточно короткого текстового сообщения без личных данных; облачный вызов может расходовать оплачиваемые токены.

Сохраните четыре сведения: провайдер и адрес API, точный ID модели, имя отклонённой beta и кто сформировал ответ об ошибке. Ключи, токены, личные сообщения и полный приватный журнал в отчёт не включайте. Если базовое подключение ещё не настроено, воспользуйтесь руководством по настройке LLM в OpenClaw, затем вернитесь к этому конкретному отказу.

Где добавляется заголовок: настройки, OpenClaw или прокси

Различайте три места добавления beta.

Явный заголовок в настройках. Проверьте models.providers и поле headers у фактического провайдера. Не ограничивайтесь записью с названием anthropic: запрос может идти через другой ID. Если anthropic-beta содержит несколько имён, выясните назначение каждого до изменения.

Автоматическое добавление OpenClaw. В текущей документации совместимых провайдеров описано подавление неявных beta-заголовков для непрямых подключений с api: "anthropic-messages". Учитываются и канонический провайдер anthropic, и адрес API: собственный baseUrl не делает прокси прямым Anthropic. Явный models.providers.<id>.headers["anthropic-beta"] остаётся способом запросить поддерживаемую прокси функцию.

На прямом Anthropic API с ключом OpenClaw может добавлять beta для определённых возможностей: управления сохранёнными блоками рассуждений, обновления контекста во время разговора, серверного переключения при отказе или включённого серверного сжатия истории. Эти условия описаны в руководстве Anthropic для OpenClaw. Отсутствие headers в файле ещё не доказывает отсутствие beta в запросе.

Добавление на стороне прокси. Если локально флаг не задан, попросите администратора посредника сопоставить входящий и исходящий запрос одного обращения: список beta, конечный API, модель и правила подмены. Достаточно очищенных технических полей. Переименование модели или автоматическая отправка одного набора заголовков всем поставщикам может сделать локальное изменение бесполезным. Исправлять нужно конкретное правило посредника, сохраняя нужную авторизацию и остальные функции.

Как исправить явный beta-заголовок у прокси

Удаление заголовка подходит, когда одновременно установлено, что он добавлен явно, не нужен выбранной функции и не поддерживается конечным API. Сначала сохраните копию активной конфигурации, путь которой показал config file. Копию с секретами храните локально.

Для примера ниже предполагается, что ID вашего провайдера — my-proxy и заголовок действительно расположен по указанному пути. Команды просмотра и удаления:

openclaw config get 'models.providers["my-proxy"].headers["anthropic-beta"]'
openclaw config unset 'models.providers["my-proxy"].headers["anthropic-beta"]'
openclaw config validate

Замените my-proxy своим ID. Кавычки вокруг пути нужны, в частности, чтобы оболочка zsh не интерпретировала квадратные скобки. Это удаление всего значения заголовка: не выполняйте его, если там есть другая необходимая и поддерживаемая beta. В таком случае исправьте список, оставив нужные имена по документации конкретного прокси.

По документации config CLI, get читает снимок с замаскированными секретами. Если unset сообщает, что заданного пути нет, и завершается с кодом 1, ничего не изменено. Это повод искать другой источник заголовка, а не удалять другие параметры наугад. В режиме только для чтения или Nix изменять нужно исходную управляемую конфигурацию, а не обходить запрет локальной записью.

Следуйте сообщению CLI о необходимой перезагрузке настроек или перезапуске. Оно описывает ожидаемое действие, но не подтверждает, что работающий Gateway уже применил изменения. Если нужен перезапуск и допустим перерыв в обслуживании:

openclaw gateway restart
openclaw gateway status

После этого выполните проверку ответа, описанную ниже. Если флаг сохранился, вернитесь к источнику его добавления: прокси мог вставить его снова.

Если beta связана с функцией прямого Anthropic API

Исправьте условия конкретной функции: точное имя beta, модель, API, доступ организации и версию клиента. Если функция нужна, простое удаление заголовка может нарушить формат запроса или поведение диалога. Проверьте требования в документации beta-заголовков и соответствующем руководстве функции.

Например, OpenClaw включает серверное сжатие истории через params.anthropicServerCompaction: true и отправляет compact-2026-01-12 вместе с настройками context_management. Если именно эта beta отклонена и серверное сжатие не требуется, можно отключить саму функцию, а не вырезать один заголовок из сформированного запроса. Для уже настроенной модели из примера документации:

openclaw config set 'agents.defaults.models["anthropic/claude-sonnet-4-6"].params.anthropicServerCompaction' false
openclaw config validate

Выполняйте эту команду только при совпадении модели и выявленной причины. Для другой модели нужен её точный путь. Если сжатие необходимо вашему сценарию, сначала выясните условия его поддержки; отключение меняет обработку истории. Источник параметра и условий подключения.

Особенно важно пересмотреть старый совет про context1m. В текущем прямом Anthropic API OpenClaw автоматически использует нативное окно 1M у перечисленных в документации моделей, включая Opus 4.6 и Sonnet 4.6. Для них params.context1m больше не включает beta. Устаревший context-1m-2025-08-07 не отправляется, а старые записи anthropicBeta с этим значением исключаются при формировании заголовков. Текущие условия 1M.

Поэтому context1m: false не является способом исправить любую ошибку 400 и не обязательно уменьшает нативное окно модели. Если этот старый флаг всё же виден в исходящем запросе, проверьте установленную версию, явный заголовок и посредника. У Claude CLI собственные ограничения контекста: доступность окна в API не доказывает такое же поведение CLI. Отказ 429 при длинном контексте разбирайте по условиям доступа и лимитам, а не как подтверждение ошибки beta.

Bedrock и Vertex AI: сохраните выбранное облако

Если вы используете управляемое облако, сначала исправьте соответствие клиента его API. Не меняйте поставщика только ради исчезновения сообщения об ошибке: для команды могут быть существенны аккаунт, регион, разрешения и порядок обработки данных.

Amazon Bedrock. OpenClaw использует выделенного провайдера amazon-bedrock с авторизацией AWS. Современные подключения Claude через Messages API и более ранние подключения через Converse/InvokeModel имеют разные условия. Пример bedrock-converse-stream для конкретной модели не означает, что все модели Bedrock должны использовать Converse. Сверяйте модель и API с руководством Bedrock для OpenClaw.

Соответствующие API Bedrock не принимают стандартный заголовок anthropic-beta. Это не равнозначно отсутствию любых экспериментальных возможностей: важен предусмотренный Bedrock способ включения конкретной функции. Отдельно существует Claude Platform on AWS, которой управляет Anthropic и где поддерживается стандартный beta-заголовок с ограничениями по функциям. Различия сведены в официальном сравнении подключений AWS. Ключ Anthropic не заменяет авторизацию AWS для Bedrock.

Vertex AI. Claude в Vertex использует Google Cloud-авторизацию и собственный формат вызова: модель задаётся в URL, а в теле применяется anthropic_version: "vertex-2023-10-16". Не переносите без проверки запрос прямого Anthropic. Условия модели, региона и функций указаны в руководстве Claude в Vertex AI.

При этом описанный OpenClaw провайдер google-vertex относится к Gemini, а не является готовой заменой для Claude. Документация Google-провайдера OpenClaw. Если Claude подключён через отдельный адаптер или корпоративный прокси, сверяйте его документированное преобразование запросов. Замена Claude на Gemini меняет модель, а не подтверждает исправление исходной ошибки. Объявлять запрет всех beta в Vertex тоже нельзя: проверяйте нужную функцию на выбранном подключении.

Как подтвердить исправление и когда остановиться

Проверка состоит из трёх отдельных результатов:

1. Настройки допустимы. openclaw config validate завершается успешно. Это проверка конфигурации, а не доступности beta у поставщика.
2. Работающий процесс применил изменение. Выполнено требуемое действие по перезагрузке или перезапуску; статус и журнал относятся к нужной службе. Одного сообщения CLI о необходимом перезапуске недостаточно.
3. Исходный запрос работает. Та же модель через тот же провайдер у того же агента полностью отвечает в исходной сессии. В журнале нет отказа beta, а ответ не получен от резервной модели.

Перед последним шагом снова проверьте /model status. Отправьте короткую просьбу, например «Ответь одним словом: готово», и дождитесь окончания ответа. Если в рабочем сценарии нужна исправляемая функция, затем проверьте и её на безопасном небольшом задании. Простой текстовый ответ подтверждает базовый вызов, но не доказывает работу сжатия истории, инструментов или длинного контекста.

Если после изменения остаётся то же сообщение с той же beta, остановите повторные вызовы и найдите оставшийся источник заголовка. Если появляется другая ошибка, переходите к её причине: 401 — авторизация, 429 — доступ или лимиты, другое поле в 400 — формат запроса. Исчезновение одной ошибки не означает, что весь запрос завершился успешно.

При проблеме после обновления сопоставьте версию CLI и запущенного Gateway, путь конфигурации и окружение службы. openclaw doctor полезен для диагностики установки, но doctor --fix не является обязательным лечением отказа beta у поставщика. Не обходите защиту от несовместимой версии и не переустанавливайте всё окружение без выявленной причины. Порядок диагностики службы описан в официальном руководстве по устранению неполадок.

Для передачи проблемы сопровождающим достаточно версии OpenClaw, очищенного фрагмента ответа, точного имени beta, провайдера, ID модели и описания места добавления заголовка. Укажите, какое изменение сделано и дошла ли проверка до полного ответа. Если необходимая функция не поддерживается выбранным API, дальнейшие одинаковые запросы не изменят это условие: согласуйте поддерживаемый вариант с владельцем подключения.

Короткие ответы

Нужно ли добавлять beta_features: []?

Нет, это не универсальное исправление OpenClaw. Сначала найдите конкретный заголовок или параметр, который отклонён. Текущий OpenClaw подавляет неявные Anthropic beta на непрямых совместимых подключениях, но явные заголовки и правила прокси нужно проверять отдельно. Условия преобразования запросов.

Можно ли удалить все beta-заголовки сразу?

Только если вы установили, что ни один из них не нужен выбранному способу авторизации и функциям. Обычно безопаснее исправить одну выявленную несовместимость. Удаление заголовка при сохранении зависимого от него поля запроса может вызвать другую ошибку.

Исправит ли context1m: false ошибку?

Не обязательно. У перечисленных в текущей документации моделей прямого Anthropic API окно 1M нативное, а прежняя beta context-1m-2025-08-07 больше не отправляется OpenClaw. Найдите фактически отклонённый флаг; настройки Claude CLI рассматривайте отдельно. Текущая документация 1M.

Почему после удаления заголовка ошибка сохранилась?

Возможно, его добавляет посредник, автоматическая функция клиента или процесс со старыми настройками. Это направления проверки, а не установленная причина. Сопоставьте активную конфигурацию и исходящий запрос; если config unset сообщил об отсутствующем пути, локального изменения не было.

config validate прошёл — проблема решена?

Нет. Он проверяет настройки без запуска Gateway. Нужны загрузка изменения и полный ответ той же модели через исходное подключение. Ответ резервной модели подтверждает работу резерва, но не устранение первоначального отказа. Область проверки config CLI.