OpenClaw Rate Limit Exceeded 429: provider, ClawHub, cooldown и fallback fixes

Ошибки OpenClaw 429 не означают одно и то же. Перед исправлением разделите failing surface: provider quota или token-per-minute limit, ClawHub skill download limit, Gateway cooldown после повторных retries, отсутствующая fallback chain или слишком большой agent session/context, который превращает одну задачу во множество provider calls.

Самый быстрый путь восстановления — прочитать исходную ошибку до изменения настроек. Если в тексте есть OpenAI organization, Anthropic request id, Gemini RESOURCE_EXHAUSTED, TPM/RPM или retry-after, это обычно provider-side limit. Если есть clawhub, /api/v1/download или skill install, это ClawHub download/auth branch. Если cooldown становится длинным или OpenClaw не переходит к следующему provider, проверьте fallback и cooldown state.

Быстрая диагностика: сначала выбрать ветку

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

bash

openclaw models status

# Recent 429, retry-after, resource exhausted, clawhub errors
grep -i "429\|rate.limit\|resource_exhausted\|retry-after\|clawhub" ~/.openclaw/logs/openclaw.log | tail -40

openclaw models status показывает, cooling down ли provider, есть ли fallback, и не застряли ли запросы на одном exhausted provider. Raw log line решает, нужно ли идти в provider dashboard, ClawHub login, ждать retry-after, уменьшать context или добавлять fallback.

Если ошибка содержит authentication_error, invalid api key или missing auth, это не 429 branch. Начните с ошибки Anthropic API key или OpenClaw API key error.

Краткое содержание

• Provider 429: уважайте retry-after, проверьте provider dashboard, уменьшите context/concurrency и настройте fallback до нового трафика.
• ClawHub 429: если ошибка появляется при skill download или hub access, не меняйте model keys. Остановите retry loop, авторизуйтесь в текущем ClawHub/OpenClaw flow или ждите rolling window.
• Cooldown / fallback issue: OpenClaw может поставить provider в cooldown. Без протестированной fallback chain он не обязан автоматически спасать запрос.
• Context pressure: длинная история, background polling, subagents и повторные tool calls могут превратить одну видимую задачу во много provider calls.
• Ключевое доказательство: openclaw models status плюс raw log line.

Немедленное восстановление

1. Следуйте retry-after и остановите retry storm

Если provider вернул retry-after, используйте это значение. Не повторяйте тот же большой запрос каждые несколько секунд: так можно продлить cooldown и потратить ещё больше quota.

Если provider dashboard уже показывает quota или billing exhausted, короткое ожидание не поможет. Нужны меньший context, меньшая concurrency, более высокий provider tier или проверенный fallback route.

2. ClawHub download 429: не меняйте model key

Если ошибка содержит clawhub, skill или /api/v1/download, failing surface — не Anthropic, OpenAI или Gemini. Остановите повторные installs/downloads, выполните актуальный login/auth flow ClawHub/OpenClaw, если он доступен, или дождитесь восстановления anonymous window.

3. Перезапускайте gateway только при stale cooldown

Если реальный provider retry-after уже истёк, но OpenClaw всё ещё держит старый cooldown, перезапустите gateway:

bash
openclaw stop
openclaw start

systemctl restart openclaw
brew services restart openclaw

Это не первый шаг. Если provider всё ещё возвращает 429, restart только замаскирует симптом и может усилить retry storm.

4. Переключайтесь только на проверенный fallback provider

Fallback помогает, если backup provider уже авторизован, model name протестирован и quota доступна:

bash
openclaw models status

Ищите available provider. При Anthropic limit можно временно перейти на OpenAI, Gemini или enterprise gateway. Но fallback не исправит ClawHub limits, auth errors, invalid headers или бесконечный local agent loop.

Owner-based 429 diagnosis

Anthropic / Claude: проверьте Claude Console, request id, rate-limit headers, spend limit и retry-after. Claude 429 может быть RPM, input-token, output-token или spend-limit проблемой.

OpenAI: найдите owning organization и project. OpenAI-style 429 часто упоминает org, project, model, requests, tokens, quota или billing. Локальная замена OpenClaw config не исправит exhausted org quota.

Google Gemini: RESOURCE_EXHAUSTED обычно указывает на project quota, model quota, daily free-tier или billing. Исправление находится в Google Cloud / AI Studio, не в OpenClaw router.

ClawHub: 429 при skill download или hub access — отдельная ветка. Нужны auth, снижение download rate или ожидание окна quota.

Fallback boundaries

Fallback — защита от provider 429, а не универсальное решение всех 429. Он работает только когда проблема действительно в model provider и backup provider имеет валидный key, существующее model name и quota. Он не исправляет ClawHub download limits, bad API keys, invalid beta headers, billing exhaustion или зацикленный agent.

Пример должен выражать strategy, а не устаревшие model ids:

yaml
agents:
  defaults:
    model:
      primary: "anthropic/claude-current"
      fallbacks:
        - "openai/gpt-current"
        - "google/gemini-current"

Проверяйте fallback заранее. Не ждите, пока primary provider упадёт, чтобы узнать, что backup key не имеет доступа или идёт через тот же exhausted proxy.

Context pressure тоже вызывает 429

Многие OpenClaw 429 появляются не из-за одного слишком быстрого запроса, а потому что agent workflow умножает число calls. Long history увеличивает каждый запрос; large tool output возвращается в модель снова и снова; subagents повышают concurrency; failed retries добавляют новые requests.

Практический порядок снижения нагрузки:

1. Используйте /clear или новый session.
2. Сначала суммируйте большие logs/files/pages, потом передавайте в модель.
3. Ограничьте concurrent tasks и background polling.
4. Сузьте scope вместо запроса на весь repo.
5. Наблюдайте cooldown через openclaw models status.

Prevention

• Настройте fallback через другой provider и регулярно тестируйте его.
• Поставьте billing и quota alerts в provider dashboard.
• Делите длинные tasks на batches.
• Логируйте owner каждого 429: provider, ClawHub, gateway cooldown, fallback miss, context pressure.
• В team docs укажите, когда ждать retry-after, когда проверять ClawHub, а когда переключать provider.

FAQ

OpenClaw 429 всегда означает нехватку API quota?

Нет. Это может быть provider quota, ClawHub download limit, cooldown state, missing fallback или context pressure. Сначала читайте raw log.

Сколько ждать?

Если есть retry-after, ждите его. Если нет, остановите retries и проверьте provider dashboard плюс openclaw models status.

Помогает ли restart OpenClaw?

Только если cooldown уже stale. Если provider всё ещё ограничивает запросы, restart повторит ошибку.

Почему fallback не сработал?

Частые причины: fallback не настроен, backup key invalid, model name unavailable, все providers идут через один exhausted proxy, или ошибка вообще не provider 429.

Что делать с ClawHub 429?

Остановите повторные downloads, выполните текущий login/auth flow или дождитесь восстановления anonymous window. Не чините ClawHub limit model API key.