2026: маршрутизация OpenClaw по нескольким моделям и цепи деградации — каналы и задачи, 429 и тайм-ауты fail-over на удалённом физическом Mac ZoneMac (openclaw.json + FAQ)

2. Точки боли

1. Лимиты, спрятанные за «одной моделью для всех». Общая дорогая модель на все каналы превращает пиковые 429 в полный отказ; интерактив и пакет, внутренний и внешний трафик должны иметь разные профили и бюджеты параллелизма.
2. Скрытая цена смешения 429 и тайм-аутов. Для 429 нужны Retry-After и уважение к квоте; для тайм-аутов чтения или TLS — переходы по цепочке или больший stream-idle. Одна политика «повторить три раза» и тормозит очередь, и маскирует первопричину.
3. Стабильность и аудит конфигурации. На удалённом Mac правки openclaw.json без ревью могут сломать профиль по умолчанию или разойтись с финмоделью по порядку отказа. Именуйте профили, фиксируйте порядок primary/secondary и владельцев в runbook.

3. Матрица: измерение × стратегия

Согласуйте таблицу до выката: слева соблазнительный shortcut, справа — разумный baseline.

4. Воспроизводимые фрагменты openclaw.json

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

4.1 Профили маршрутизатора, каналы и теги задач

{
  "gateway": {
    "router": {
      "defaultProfile": "balanced",
      "profiles": {
        "fast": {
          "primaryModel": "gpt-4o-mini",
          "fallbackChain": ["claude-3-5-haiku", "local-qwen-14b"]
        },
        "balanced": {
          "primaryModel": "gpt-4.1",
          "fallbackChain": ["gpt-4o", "gpt-4o-mini"]
        },
        "quality": {
          "primaryModel": "gpt-4.1",
          "fallbackChain": ["claude-3-5-sonnet", "gpt-4o"]
        }
      },
      "routeByChannel": {
        "telegram": { "profile": "fast" },
        "slack_public": { "profile": "balanced" },
        "api_internal": { "profile": "quality" }
      },
      "routeByTaskTag": {
        "ci": { "profile": "fast" },
        "support": { "profile": "quality" },
        "ops_summary": { "profile": "balanced" }
      }
    }
  }
}

4.2 Повторы upstream, 429 и тайм-ауты

{
  "gateway": {
    "upstream": {
      "http": {
        "maxRetries": 4,
        "retryOnStatus": [408, 409, 425, 429, 500, 502, 503, 504],
        "respectRetryAfter": true,
        "backoff": { "baseMs": 400, "maxMs": 8000, "jitter": 0.2 }
      },
      "circuitBreaker": {
        "errorRateThreshold": 0.35,
        "minSampleSize": 40,
        "openDurationMs": 60000
      },
      "timeouts": {
        "connectMs": 8000,
        "requestMs": 180000,
        "streamIdleMs": 240000
      },
      "failover": {
        "onTimeout": "nextInFallbackChain",
        "on429": "retryWithBackoffThenFallback",
        "maxFallbackHops": 3
      }
    }
  }
}

streamIdleMs закрывает длинные паузы между токенами в стриминге; разнесение on429 и onTimeout позволяет строить отдельные SLO в логах и на дашбордах — выгружайте счётчики в Prometheus или Grafana и алертите отдельно по глубине отказа и по доле 429.

5. Семишаговый runbook (удалённый физический Mac)

1. Зафиксировать измерения трафика. Согласовать с продуктом и ops ID каналов и перечень тегов задач; убрать безымянные дефолты, чтобы трафик не уезжал в balanced молча.
2. Резервная копия JSON. cp openclaw.json openclaw.json.bak.$(date +%Y%m%d%H%M); дифф приложить к тикету.
3. Слить блоки router. Сначала profiles и fallbackChain, затем routeByChannel / routeByTaskTag.
4. Локальный золотой запрос. Для каждого профиля — фиксированный curl (или крошечный SDK-скрипт) на 127.0.0.1, записать model ID и задержку.
5. Два класса сбоев. Через mock или throttle вернуть 429 и отдельно растянуть time-to-first-byte: 429 должен уходить в backoff без выжигания всей цепочки за три попытки, тайм-ауты — продвигаться по цепочке.
6. Наблюдаемость. Минимум: запросы на профиль, доля 429, распределение глубины отказа, доля read-timeout — пороги согласовать с runbook Prometheus/Grafana.
7. Архив и ревью. Закоммитить фрагменты JSON, золотые команды и откат (восстановить bak + reload) рядом с внутренней документацией.

6. Разбор 429 и тайм-аутов fail-over

7. Цифры для цитирования (runbook)

• Старт backoff: baseMs: 400 и maxMs: 8000 как порядок величины для 429; сверить с коммерческими лимитами QPS.
• Простой стрима: streamIdleMs: 240000 (четыре минуты) для длинных ответов; короче — для снэппи интерактива.
• Потолок отказа: maxFallbackHops: 3 ограничивает взрыв задержки; дальше — явное тело ошибки и алерт.

8. FAQ

9. Итог и выбор узла

Маршрутизация по нескольким моделям переносит стоимость, задержку и доступность из режима «тушим пожары» в аудируемый контракт: каналы и задачи выбирают профили, 429 и тайм-ауты живут в разной семантике fail-over, упорядоченные цепочки дают предсказуемый последний рубеж, когда upstream дрожит.

Запуск шлюза на удалённом физическом Mac ZoneMac закрепляет этот путь на долгоживущем хосте с низким джиттером: нативный Terminal и SSH, launchd и стек macOS снижают дрейф окружения, который маскируется «таинственными» тайм-аутами. Объединённая память Apple Silicon делает локальный запасной маленькой модели на машине реалистичнее. Mac mini M4 — с порядка 4 Вт в простое, тихой работой и стабильным macOS — удобная площадка для шлюза 7×24; Gatekeeper и SIP снижают риск на безлюдных узлах с открытым периметром.

Если нужна эта схема маршрутизации на предсказуемом железе с минимальным операционным шумом, Mac mini M4 — один из сильных стартов по цене и производительности: арендуйте удалённый физический Mac через ZoneMac и закрепите мультимодельный трафик на воспроизводимой конфигурации шлюза.