OpenClaw 429: что делать, если превышен лимит запросов

При OpenClaw 429 — Rate limit exceeded сначала прекратите дополнительные запуски той же задачи и найдите, кто вернул отказ: поставщик модели или ClawHub. Для временного ограничения частоты запросов дождитесь указанного Retry-After и снизьте параллелизм. При исчерпанном дневном, недельном или месячном лимите, ограничении расходов либо недоступных учётных данных короткое ожидание не решает причину: нужен срок восстановления доступа или подходящая резервная модель.

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

Ниже — порядок проверки по документации, актуальной на 5 октября 2026 года. Команды приведены для вашей диагностики; сбой на реальном аккаунте и успешный вызов модели в рамках этого руководства не воспроизводились.

Найдите исходный отказ, а не только последнюю строку

На машине Gateway, от имени пользователя его службы, посмотрите состояние проблемного агента и ограниченный фрагмент журнала. Замените <agentId> его идентификатором:

openclaw models status --agent <agentId> --json
openclaw logs --limit 200 --max-bytes 250000 --plain

В соответствующем чате отдельно проверьте:

/model status

models status показывает настроенную модель, резервную цепочку, источники авторизации и недоступные профили. Он не видит закреплённый выбор модели в конкретной сессии — для этого нужна команда чата. Статус без --probe не доказывает, что поставщик принял запрос. Даже код 0 у --check означает успешную проверку состояния авторизации и среды выполнения, а не успешный ответ модели. --probe выполняет реальные запросы, может расходовать токены и снова задеть лимит; не запускайте его серией во время активного ограничения. Как читать статус.

Не ищите журнал только по старому пути ~/.openclaw/logs/openclaw.log: актуальный CLI выбирает журнал Gateway и учитывает профиль. Если используете отдельный профиль, укажите его перед командой, например openclaw --profile work logs --limit 200 --plain. Для наблюдения за одним согласованным повтором можно использовать openclaw logs --follow, затем завершить просмотр сочетанием Ctrl+C. Переподключение самого потока журнала — отдельное событие; оно не означает новую ошибку модели. После смены источника строки могут перекрываться, поэтому число строк не равно числу оплаченных запросов. Документация logs.

Запишите время отказа, фактическую модель и поставщика, выбранный профиль, текст ошибки, доступный request ID, сведения о повторе и срок восстановления. Перед передачей фрагмента журнала удалите ключи, токены, личные сообщения и другие секретные данные.

Последняя строка о недоступных профилях сама по себе не доказывает нехватку денег, неверный ключ или сбой Gateway. Решение определяется исходным отказом и состоянием соответствующего профиля.

Сколько ждать при ограничении поставщика модели

Соблюдайте срок из ответа поставщика, а не универсальные «одну-две минуты». Retry-After, retry-after-ms и сообщение вида «Please try again in…» задают минимальную паузу. Прекратите другие источники нагрузки на тот же аккаунт: параллельных агентов, фоновые задания и внешние скрипты. Затем дайте текущему восстановлению завершиться либо отложите один следующий запрос до указанного срока.

По текущей политике OpenClaw временные ограничения модели получают до 10 попыток всего, а не десять новых попыток после каждого сообщения. Задержка растёт с небольшой случайной добавкой; обычный предел такой задержки — 30 секунд, но он не разрешает нарушать более длинную паузу поставщика. Отмена и общий срок запуска останавливают восстановление.

Есть две детали, из-за которых видимое поведение может различаться:

• Сохранённая настройка сессии retry.provider.maxRetryDelayMs по умолчанию равна 60 000 мс. Если поставщик просит ждать дольше и настроен резерв, управление переходит к допустимому резерву. Если резерв не настроен, минимальная пауза соблюдается полностью. Значение 0 отключает этот предел. Это не универсальный ключ для вставки в openclaw.json.
• Внутренние повторы SDK имеют отдельный предел ожидания. OpenClaw может вернуть управление из SDK при длинном Retry-After; это не отменяет обязанность соблюдать срок поставщика. Нельзя складывать поверх текущего восстановления бесконечный внешний цикл повторов.

Для других временных отказов документация описывает восемь повторов в пределах 90-секундного окна последовательных сбоев. 90 секунд не являются сроком сброса любого 429. Полностью успешный ответ модели очищает это окно, но не обнуляет общий счётчик повторов; частичный ответ или работа инструмента сами по себе его не очищают.

Когда ожидание нужно заменить другим действием

У OpenAI API ограничения относятся к организации и проекту; число запросов и число токенов имеют отдельные лимиты, а некоторые модели используют общий пул. Дополнительный ключ того же проекта или другая модель из общего пула не создают новую ёмкость. Ошибочные запросы тоже учитываются в минутных лимитах. slow_down с HTTP 429 может означать слишком резкое увеличение нагрузки даже ниже номинального предела — после паузы наращивайте её постепенно. Жёсткий предел расходов, при котором API возвращает 429, отличается от уведомления о расходах. Официальные правила OpenAI.

У Claude API 429 может обозначать частотный лимит, месячный предел расходов уровня доступа или лимит рабочего пространства. При достижении месячного предела уровня доступа retry-after отсутствует, и отказ сохраняется до восстановления доступа. Короткая пауза или замена ключа того же ограниченного аккаунта не являются решением такой причины. Описание ошибок Claude API.

Почему cooldown сохраняется после перезапуска

Период охлаждения профиля хранится в SQLite и переживает перезапуск Gateway. В текущих правилах используются сохранённые поля cooldownUntil и disabledUntil в состоянии авторизации агента. Поэтому перезапуск не восстанавливает квоту поставщика и не служит общей командой очистки ограничения. Состояние профилей и cooldown.

Посмотрите раздел Unavailable auth profiles в models status; в JSON соответствующие сведения находятся в auth.unusableProfiles. Сопоставьте профиль, причину и срок с первым отказом. Если причина — временный лимит, дождитесь восстановления с учётом нагрузки. Если причина — оплата или постоянный отказ авторизации, исправьте именно её, затем проверьте доступность по текущим правилам профиля.

Обычные периоды охлаждения после ошибок сейчас растут от 30 секунд к одной минуте и затем к пяти минутам. Это локальные правила профиля, а не обещание, что любой поставщик восстановится за пять минут. Ограничение может относиться к конкретной модели: другая модель того же поставщика иногда остаётся допустимой. Блокировка по оплате действует на весь профиль; её начальное окно составляет десять минут. Пополнение само по себе не стирает уже сохранённый срок, а очередной отказ оплаты может открыть новое окно. Все эти значения относятся к текущей документации переключения, проверенной 5 октября.

Если все профили уже в cooldown, OpenClaw не обязательно исключает поставщика навсегда: основная модель может получить ограниченную проверку около конца окна, а подходящая соседняя модель — отдельную попытку при ограничении конкретной модели. Такая проверка не гарантирует успеха и не требует циклических перезапусков. Не редактируйте базу состояния вручную и не удаляйте историю задачи ради устранения 429.

Почему резервная модель не запускается

Наличие fallbacks в файле ещё не означает, что текущему запросу разрешено использовать эту цепочку. Сначала проверьте источник выбора модели. Точный выбор пользователем через /model или меню модели строгий: при отказе OpenClaw показывает ошибку вместо скрытого ответа другой модели. Основная модель нативного агента тоже строгая, если у него нет собственной резервной цепочки. Настроенная модель по умолчанию может использовать agents.defaults.model.fallbacks. Правила выбора и отказа.

Практический порядок проверки:

1. Сравните /model status проблемного чата со статусом агента. Узнайте, закреплена ли конкретная модель.
2. Посмотрите глобальную цепочку командой openclaw models fallbacks list; затем проверьте, не использует ли агент свою отдельную цепочку или явно пустой список.
3. Для каждого фактически разрешённого кандидата подтвердите существующий идентификатор модели, подходящие учётные данные, работоспособную среду запуска и доступную квоту. Резерв через тот же ограниченный аккаунт или общий пул может отказать по той же причине.
4. Если вы намеренно хотите вернуть правила настроенной модели по умолчанию, используйте /model default. Сначала убедитесь, что её резервные подключения подходят для данных задачи и разрешены вам.
5. После разрешённого переключения дождитесь одного короткого ответа и посмотрите, какая модель действительно ответила. Только затем продолжайте оставшийся этап.

Подключение нового резерва, настройка отдельного агента и проверка модели с инструментом описаны в руководстве по настройке LLM в OpenClaw. Не копируйте условные идентификаторы вроде claude-current или gpt-current: они не являются названием доступной модели.

Ошибки авторизации, оплаты и подходящий model_not_found могут продвинуть цепочку к допустимому кандидату. Утверждение «fallback никогда не работает при ошибке ключа или оплате» неверно. Однако резерв не исправляет отклонённый аккаунт, недопустимый формат запроса или ограничение ClawHub. Переполнение контекста во встроенном запуске имеет собственный механизм восстановления; модель с меньшим окном может только добавить новый отказ. Границы переключения.

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

ClawHub 429 при поиске или скачивании навыка

429 при установке из ClawHub относится к реестру, а не к квоте модели. Остановите повторные установки, массовые обновления и параллельный поиск. Прочитайте сведения о задержке в ответе именно реестра и повторите только необходимую операцию после этой паузы. Смена ключа Anthropic или OpenAI не меняет лимит скачивания ClawHub.

По HTTP API ClawHub чтение, запись и скачивание имеют отдельные ограничения. Анонимные запросы учитываются по IP; запросы с действительным Bearer-токеном — по пользователю. Отсутствующий или недействительный токен возвращает запрос к учёту по IP. Общий выходной IP офиса, сервера или прокси может исчерпать лимит даже при небольшом числе ваших личных запросов. Авторизуйтесь там, где используемый клиент это поддерживает, но затем всё равно соблюдайте задержку ответа.

У заголовков ClawHub разные единицы:

Если Retry-After отсутствует, используйте срок сброса по этим правилам и небольшую случайную добавку к паузе. Не переносите трактовку Unix-времени на заголовки других поставщиков: например, у OpenAI значения сброса могут быть строками длительности. Отсутствие остатка в успешном ответе ClawHub не означает неограниченный бюджет. Семантика заголовков.

Текущая документация ClawHub разделяет нативные команды openclaw skills и openclaw plugins для установки и отдельный CLI clawhub для операций реестра. Если используете этот CLI, предусмотрены:

clawhub login
clawhub whoami

whoami подтверждает состояние входа данного CLI. Он не доказывает, что нативная установка OpenClaw отправила тот же токен. Сопоставьте клиент, его конфигурацию и ответ реестра; не переустанавливайте всё подряд после успешного входа. Порядок входа и восстановления 429 описан в устранении неполадок ClawHub.

После ожидания повторите одну конкретную установку и проверьте её результат. Если вместо 429 появилась ошибка совместимости, скрытый выпуск или блокировка проверки безопасности, остановитесь и разбирайте новый отказ. Ожидание лимита не разрешает установить недоступный выпуск.

Когда доступ к реестру восстановлен, выберите только навык под нужную работу: какие навыки OpenClaw выбрать и как проверить их зависимости. Это поможет продолжить с одной полезной задачи вместо повторной установки целого набора.

Продолжите оставшуюся работу без повторения выполненного

После восстановления сначала отправьте короткий запрос без большого вложения и лишних инструментов. Проверьте ответ, фактическую модель и отсутствие нового 429 в соответствующей попытке. Такой запрос подтверждает доступ в этот момент, а не длительную ёмкость всего рабочего процесса; облачный ответ может оплачиваться.

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

Проверь текущие результаты и состояние прерванного действия. Не повторяй завершённые изменения. Затем выполни только оставшийся шаг, указанный в сохранённой записи.

Снижайте нагрузку по причине отказа: при лимите частоты уменьшите число одновременных запусков; при давлении на токены передавайте нужные фрагменты журналов и файлов вместо полного содержимого, сократите ненужные результаты инструментов и разделите оставшуюся обработку на последовательные части. Новая сессия не восстанавливает квоту аккаунта. Если требуется сжатие истории или перенос состояния, используйте восстановление после переполнения контекста OpenClaw, сохранив исходную задачу и выполненную работу.

Особый случай — точный ответ Anthropic Extra usage is required for long context requests. Он указывает на доступ к длинному контексту, а не обязательно на слишком частые запросы. Проверьте выбранный маршрут: можно использовать модель со стандартным окном, подходящие учётные данные с нужным доступом либо допустимый резерв. Удаление старого context1m относится только к соответствующей старой настройке модели, не к любому текущему GA-подключению. Не включайте платное использование автоматически и не стирайте историю вместо сохранения состояния. Описание этого 429 в документации Gateway.

Остановите повторные действия, если неизвестно, завершилась ли операция с внешним эффектом. Сначала проверьте независимый результат: файл, запись, идентификатор отправки или состояние задания. Для дальнейшей диагностики достаточно версии, среды запуска, обезличенной последовательности попыток, фактических моделей и сроков ограничения; полный приватный журнал обычно не нужен.

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

Нужно ли создавать новый API-ключ при каждом 429?

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

Можно ли просто перезапустить Gateway и продолжить?

Перезапуск не очищает сохранённые cooldownUntil и disabledUntil и не снимает ограничение поставщика. Найдите причину и срок профиля; дождитесь восстановления или используйте допустимый резерв. Отдельный необязательный кэш пропуска ошибочных резервов хранится в процессе, но это другой механизм. Правила cooldown.

Почему статус выглядит исправным, но запрос опять получает 429?

Статус без пробы подтверждает конфигурацию и состояние доступа, а не успешный вызов модели. Кроме того, сессия может использовать закреплённую модель, отличающуюся от настройки агента. Сравните models status --agent и /model status, затем после разрешённой паузы проверьте один короткий запрос. Документация CLI.

Потеряется ли выполненная работа после 429?

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