2026 OpenClaw sur Mac Mini loué : webhooks HTTP génériques, Zapier/Make, digest quotidien, backoff et idempotence

Ce guide livre une matrice de choix, six sections opérationnelles et une checklist de sept gestes. Pour les quotas modèles et le 429, croisez avec le HowTo routage et backoff OpenClaw ; pour les pipelines planifiés, le guide GitLab et webhooks ; l’aide RunMini détaille SSH, VNC et console sur le même hôte loué.

Trois freins typiques sur Mac loué

1. Dérive des ports. Listener lancé à la main en SSH sans launchd : après reboot il disparaît alors que VNC suggère une machine « prête ».
2. Espace d’URL plat. Un seul POST absorbe diagnostics et digests ; une charge de test pollue les canaux production.
3. Retries aveugles. Les politiques par défaut no-code rejouent des mutations lentes sans Idempotency-Key stable.

Matrice : Zapier, Make ou appel direct depuis launchd

Passerelle OpenClaw : garde des ports, boucle locale et persistance

Documentez l’adresse d’écoute (loopback ou tailnet), chaque port TCP, et le plist launchd sur le SSD loué. Terminez le TLS sur un reverse proxy avec identifiant de traçage ; séparez UI admin et health des routes modèles coûteuses.

• Noter série, région et ports dans le même runbook que les accès SSH pour l’astreinte.
• Éviter d’exposer la passerelle en clair sur l’Internet public sans filtrage ; privilégier réseau overlay ou allowlist.

Configuration du routage des webhooks HTTP génériques

Attachez par exemple POST /hooks/digest aux résumés planifiés et POST /hooks/alert aux incidents sévères ; répondez 405 aux verbes non prévus et refusez les Content-Type inconnus avant toute logique métier.

{"route":"/hooks/digest","method":"POST","content_type":"application/json","auth":"Bearer"}

Exemples minimaux Zapier et Make pour le digest

Zapier : déclencheur Catch Hook (Webhooks by Zapier), filtre sur severity, puis action Slack ou courriel. Make : module webhook personnalisé, Router sur le préfixe de run_id, module HTTP vers la passerelle uniquement pour accusés réception signés.

Calez la fenêtre amont OpenClaw sur la matrice planification 7×24 afin que le digest ne chevauche pas une maintenance VNC diurne.

Champs du modèle de digest (JSON stable)

Des clés stables permettent aux filtres no-code de survivre aux retouches de template ; émettez toujours du JSON UTF-8 avec fuseau horaire explicite dans les horodatages.

• run_id unique par lot de digest.
• window_start et window_end en ISO-8601 avec offset.
• summary_text limité pour rester sous le plafond des canaux chat.
• severity parmi des valeurs énumérées (info, warn, critical).
• source_host aligné sur le hostname du Mac loué.

HTTP 429 et erreurs 5xx : backoff, jitter et clés d’idempotence

Ne retentez que 429, 500, 502, 503 et 504 ; honorez Retry-After lorsqu’il est présent. Appliquez un backoff exponentiel à partir de deux secondes avec jitter d’environ trente pour cent, plafonnez vers quinze minutes, et arrêtez après huit tentatives automatiques avant pager un humain.

Envoyez l’en-tête Idempotency-Key égal à run_id, ou persistez la paire dans un petit fichier sur le Mac pour que deux tirs Zapier consécutifs n’écrivent qu’une seule mutation aval.

FAQ : échecs d’authentification les plus fréquents

401 côté Zapier alors que curl réussit

Espaces parasites, double préfixe Bearer, ou guillemets ajoutés par le champ UI : comparez octet à octet avec l’en-tête capturé dans les journaux passerelle.

Le HMAC échoue-t-il si l’horloge dérive ?

Au-delà d’environ deux minutes de décalage, oui : synchronisez NTP sur le Mac loué et vérifiez le fuseau du scénario Make.

Rotation simultanée passerelle et coffre no-code

Maintenez deux secrets valides le temps d’une fenêtre de digest, basculez d’abord la passerelle, puis le coffre Zapier/Make, enfin révoquez l’ancienne clé.

Checklist opérateur en sept gestes

1. Consigner adresse d’écoute, ports et chemin launchd sur le volume loué.
2. Déployer TLS et routes séparées digest versus alerte.
3. Créer les URL de capture ; secrets uniquement dans le vault de l’orchestrateur.
4. Émettre le schéma JSON avec run_id et fenêtres obligatoires.
5. Désactiver les retries sur 401 et 403 ; activer jitter sur 429/5xx.
6. Tracer les échecs d’auth avec identifiant de requête pour le support.
7. Après sept jours verts, traiter l’hôte comme production longue durée et aligner renouvellement sur les forfaits.

Repères citables pour revue et astreinte

• Deux secondes de délai initial puis doublement jusqu’au plafond quinze minutes pour les couloirs 429/5xx.
• Huit tentatives automatiques maximum avant escalade humaine.
• Deux minutes de dérive d’horloge tolérée au-delà pour signatures HMAC.