2026 — OpenClaw : routage multi-modèles et chaînes de dégradation — répartition par canaux/tâches, 429 vs timeout et fail-over sur passerelle Mac physique distante ZoneMac (openclaw.json + FAQ)

2. Points de douleur

1. Limites masquées derrière « un modèle pour tout le monde ». Partager un modèle coûteux entre canaux transforme les pics de 429 en panne générale ; le trafic interactif vs batch et interne vs externe doit utiliser des profils et budgets de concurrence distincts.
2. Coût caché quand 429 et timeouts sont confondus. Les 429 exigent Retry-After et le respect des quotas ; les timeouts de lecture ou TLS se prêtent à des sauts de chaîne ou à des plafonds stream-idle plus hauts — une politique générique « trois retries » ralentit la file et brouille la cause racine.
3. Stabilité et audit de la configuration. Sur un Mac distant, des modifications non revues de openclaw.json peuvent casser le profil par défaut ou désynchroniser l’ordre de secours du modèle financier. Nommez les profils, documentez l’ordre primaire/secondaire et désignez un propriétaire dans le runbook.

3. Matrice de décision : dimensions × stratégie

Validez ce tableau avant déploiement ; la colonne de gauche est le raccourci tentant, la droite une base saine.

4. Extraits openclaw.json reproductibles

Ce qui suit est une structure illustrative : les clés doivent correspondre à la doc de votre version OpenClaw ; fusionnez dans un fichier existant sans écraser les chemins propres à la prod (canaux, références d’identifiants) et conservez toujours une sauvegarde.

4.1 Profils routeur, canaux et étiquettes de tâche

{
  "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 Retries amont, 429 et timeouts

{
  "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 couvre les longs écarts entre jetons en mode streaming ; garder on429 et onTimeout dans des blocs séparés permet des SLO distincts dans les journaux et tableaux — exportez des compteurs cohérents vers Prometheus ou Grafana et alertez séparément sur la profondeur de secours et le taux de 429.

5. Runbook en sept étapes (Mac physique distant)

1. Geler les dimensions de trafic. Aligner produit et ops sur les ID de canaux et les enums d’étiquettes ; supprimer les défauts anonymes pour que le trafic ne retombe pas silencieusement sur balanced.
2. Sauvegarder le JSON. cp openclaw.json openclaw.json.bak.$(date +%Y%m%d%H%M) ; joindre le diff au ticket.
3. Fusionner les blocs routeur. Ajouter d’abord profiles et fallbackChain, puis routeByChannel / routeByTaskTag.
4. Requête de référence locale. Pour chaque profil, exécuter un curl fixe (ou petit script SDK) vers 127.0.0.1, noter l’ID modèle et la latence.
5. Injecter deux classes de faute. Avec un mock ou un throttle, renvoyer 429 et, séparément, étirer le délai avant le premier octet ; le 429 doit backoff sans consumer toute la chaîne en trois essais, les timeouts doivent avancer le long de la chaîne.
6. Brancher l’observabilité. Exporter au minimum : requêtes par profil, taux de 429, distribution de la profondeur de secours, taux de timeout lecture — aligner les seuils des panneaux sur votre runbook Prometheus/Grafana.
7. Archiver et revue. Commiter extraits JSON, commandes de référence et retour arrière (restaurer le bak + rechargement) à côté de la doc interne.

6. Tri fail-over 429 vs timeout

7. Chiffres prêts à citer (runbooks)

• Départ backoff : baseMs: 400 et maxMs: 8000 comme ordre de grandeur initial pour les 429 ; réconcilier avec les plafonds QPS commerciaux.
• Inactivité de flux : streamIdleMs: 240000 (quatre minutes) convient aux longues réponses ; des valeurs plus courtes favorisent le chat interactif.
• Plafond de secours : maxFallbackHops: 3 limite l’explosion de latence ; au-delà, renvoyer une erreur explicite et pager.

8. FAQ

9. Synthèse et choix de nœud

Le routage multi-modèles déplace coût, latence et disponibilité du bricolage réactif vers un contrat auditable : canaux et tâches sélectionnent les profils, 429 et timeouts ont des sémantiques de fail-over différentes, et les chaînes ordonnées offrent un dernier recours déterministe lorsque les amonts tremblent.

Exécuter la passerelle sur un Mac physique distant ZoneMac ancre ce chemin sur un hôte Unix longue durée et faible gigue : Terminal et SSH natifs, supervision launchd, alignement avec la toolchain macOS — moins de dérive d’environnement qui se traduit par des timeouts « fantômes ». La mémoire unifiée Apple Silicon rend aussi plus réaliste un petit modèle de secours local sur la machine. Un Mac mini M4 — avec environ 4 W en veille, un fonctionnement silencieux et un macOS stable — convient bien à une passerelle 7j/7 ; Gatekeeper et SIP réduisent aussi la surface d’exposition.

Si vous voulez cette pile de routage sur un matériel prévisible avec peu de friction opérationnelle, le Mac mini M4 est l’un des meilleurs rapports performance/prix pour démarrer — louez un Mac physique distant via ZoneMac et posez le trafic multi-modèles sur une configuration de passerelle reproductible.