2026 OpenClaw auf gemietetem Mac Mini: Primär-/Fallback-Modellrouting, API-Quota und automatische Degradation

Drei typische Brüche vor dem Agentenfehler

1. Einspurigkeit: Ein teures Cloud-Modell ohne Degradation verwandelt jeden Anbieter-Incident in einen Totalausfall für Jobs, die ohne Aufsicht laufen müssen.
2. Fehlklassifikation: Wer erschöpfte Quota wie generische Timeouts behandelt, erzeugt Retry-Schleifen, die Kontingente schneller verbrennen und Warteschlangen auf dem Mac Mini blockieren.
3. Undurchsichtige Logs: Ohne strukturierte Felder für Spur, Versuchszähler und Breaker-Zustand lässt sich im Postmortem nicht trennen, ob der Host oder die API schuld ist.

Entscheidungsmatrix: Modellspuren vor Konfigurationsänderung

Priorisieren Sie nach Geschäftskritikalität, dann mappen Sie Ausfälle auf eine Spur, die Ihr OpenClaw-Stack vom Miet-Host aus zuverlässig erreicht.

HTTP- und Kontingentfehler: operative Klassifikation

Resilienzparameter: Startwerte für Miet-Macs

Kalibrieren Sie an Vertrag und SLO; speichern Sie Zahlen versioniert neben dem OpenClaw-Deployment, damit jeder Mac-Mini-Tenant identisch reagiert.

Reproduzierbare Konfigurationsfragmente

Versionieren Sie die Fragmente im Tenant-Repo, injizieren Sie Geheimnisse über Ihren Vault und symlinken Sie die gerenderte Datei in die OpenClaw-Startumgebung auf dem Mac Mini. Schlüsselnamen sind illustrativ.

Fragment A — Spurdefinitionen

router:
  primary_model: gpt-4.1-mini
  fallback_model: qwen2.5:7b-local
  classify_quota_http: [429, 402]
  quota_body_tokens: ["insufficient_quota", "rate_limit"]

Fragment B — Retry und Breaker

resilience:
  backoff: exponential_full_jitter
  initial_ms: 250
  max_ms: 30000
  max_attempts: 3
  breaker:
    open_after: 5
    half_open_probes: 1
    cooldown_s: 120

HowTo: sechs operative Schritte

1. Legen Sie Spur-YAML und Provider-Basis-URLs unter Versionskontrolle ab; API-Schlüssel nur via Vault auf den gemieteten Mac Mini rendern, niemals Klartext im Template.
2. Implementieren Sie eine Fehlerklassifikation, die 429, 402 und typische Quota-JSON-Körper in sofortigen Modellrouting-Fallback lenkt statt in Endlosschleifen.
3. Verdrahten Sie exponentielles Backoff mit vollem Jitter, schlafen Sie mit monotonischer Zeit, und brechen Sie ab, wenn die nutzungsseitige SLA ohnehin verletzt wäre.
4. Führen Sie Breaker-Zustand pro Provider-Region; bei offenem Kreis neue Arbeit auf die Sekundärspur legen und optionale Tools zuerst degradieren.
5. Drosseln Sie Parallelität und Token-Obergrenzen während Degradation, analog zu den cgroup- oder launchd-Kappen im Ressourcenleitfaden, damit Unified Memory vorhersagbar bleibt.
6. Probieren Sie monatlich Failover in Staging: erzwungenes 429, prüfen Sie Log-Felder und Breaker-Übergänge, dann Primärspur wiederherstellen und Halb-offen-Schließen verifizieren.

Logs, Metriken und Observability

Strukturierte JSON-Zeilen pro LLM-Versuch verkürzen Postmortems und erfüllen Auditfragen zu Quota und Degradation.

• model_lane — primary, secondary oder local für Dashboards zum Modellrouting.
• provider_http_status — Rohstatus zur Korrelation mit Anbieter-Statusseiten und API-Quota-Vorfällen.
• backoff_ms und attempt — Nachweis, dass Drosselung eingehalten wurde.
• breaker_state — closed, open, half_open erklärt plötzliche Traffic-Verschiebungen auf dem Miet-Host.
• request_id und tenant_id — End-to-End-Spur für Mehrmandanten-Setups ohne PII im Klartext zu duplizieren.