>> OpenClaw sur Mac mini M4 loué en 2026 : guide de dépannage — journaux, launchd, coupures de passerelle et erreurs fournisseurs

Résumé : une fois le guide de déploiement léger terminé, la production se résume souvent à des pannes ennuyeuses qui ressemblent à « l’IA est devenue bête ». Cette page s’adresse aux ingénieurs d’astreinte sur un Mac mini M4 loué avec 16 Go et 256 Go : relier symptômes et lignes de journal ainsi qu’aux codes de sortie launchd, sortir des boucles de reconnexion de passerelle, corriger les erreurs UserName dans les plists, décoder les échecs HTTP des modèles hébergés et cesser d’accuser le réseau lorsque le goulet d’étranglement est le disque ou la mémoire unifiée. À lire avec sécurité et réseau dès que les écouteurs bougent, et avec pile légère UK vs APAC si vous suspectez le RTT régional — pas un bogue de démon.

L’ergonomie SSH générique et le partage d’écran avec consentement sont décrits dans le centre d’aide et le guide VNC ; les tarifs à jour figurent sur la page tarifs.

• Quelqu’un redémarre l’hôte avant qu’on ait capturé le code de sortie ou les fins de journaux — l’incident devient une légende.
• Chaque timeout TLS est étiqueté « réseau cloud » alors que les octets libres sur disque restent sous 25 Go et que la latence du swap explose.
• Les jetons tournent dans les fils de discussion au lieu des blocs d’environnement launchd, donc prod et lab divergent en silence.

Symptôme d’astreinte → signal

Les bons incidents ressemblent à de la télémétrie, pas à de la poésie. Partez du symptôme visible par l’utilisateur, puis enchaînez sur la mesure la moins coûteuse qui infirme une hypothèse. Le tableau ci-dessous est volontairement asymétrique : certaines lignes vous orientent vers des tableaux de bord fournisseurs, d’autres vers df et vm_stat en local — parce que les pannes OpenClaw sont en général un tressage, pas une cause unique.

Symptôme	Premier signal à capturer	Erreur d’interprétation fréquente	Action suivante rapide
Les réponses du chat s’arrêtent au milieu du fil	PID du worker de canal vs PID parent ; 50 dernières lignes stderr	« Modèle dégradé » alors que le worker est bloqué	Redémarrer uniquement l’unité worker si séparée ; sinon recharger la plist après instantané des journaux
Les outils renvoient vide ou expirent	Résolution DNS sortante + curl HTTPS trivial	Accuser SSH quand le DNS vacille	Corriger la config résolveur ; resserrer les budgets de retry dans la config des outils
Interface d’admin inaccessible via tunnel	lsof -nP -iTCP -sTCP:LISTEN pour l’adresse de liaison	Supposer que le port du tunnel a dérivé	Réancrer la carte ssh -L ; vérifier la liaison loopback selon le guide sécurité
Tout est « lent » après de longues exécutions	Disque libre + compteurs de pression mémoire	« RTT réseau » sans chiffres	Purger les journaux, faire tourner les archives, réduire le fan-out concurrent des outils

Où sont les journaux sous launchd

Les démons lancés par launchd perdent souvent l’illusion d’un TTY interactif : stdout et stderr peuvent aller dans les journaux système, des fichiers tournés sous l’utilisateur de service, ou nulle part si vous avez oublié StandardOutPath/StandardErrorPath. Avant de lancer grep sur des chemins au hasard, identifiez quelle plist possède le processus, quel utilisateur macOS l’exécute, et si les filtres de Console.app masqueraient le flux.

Lorsque le volume de journaux explose sur une configuration 256 Go, expédiez les morceaux tournés hors du volume de démarrage chaque nuit ; sinon la prochaine « panne mystérieuse » sera un ENOSPC déguisé en blocage.

Coupures de passerelle, jetons et quotas

Les passerelles de messagerie semblent simples jusqu’à ce que le recul de reconnexion entre en collision avec les réessais humains. Documentez l’intervalle maximal de reconnexion, le nombre maximal d’appels d’outils concurrents et quels canaux partagent une même limite de débit. Lorsque les tableaux fournisseur affichent des pics 429, traitez cela comme une dette de configuration — pas de la malchance — et planifiez un passage de limitation avant de rouvrir le parallélisme.

Si vous avez resserré les écouteurs avec l’article sécurité, revérifiez les tunnels après chaque modification de plist — sinon vous déboguerez une passerelle saine à laquelle personne ne peut joindre.

Plist, UserName et pièges d’autorisations

La faute de frappe la plus coûteuse est de faire tourner la prod sous une session personnelle « juste une semaine ». UserName dans une plist LaunchDaemon doit pointer vers un compte de service avec son propre arbre personnel et trousseau. Les invites d’autorisation qui n’apparaissent qu’en session GUI signifient qu’il vous faut encore une courte fenêtre VNC — même si le quotidien est d’abord SSH.

Schéma d’erreur	Ce que launchd montre	Posture de réparation
Mauvais UserName pour les fichiers sous ~/.openclaw	Sortie 78 ou fichier introuvable répété en stderr	Créer l’utilisateur dédié, migrer l’arborescence, recharger la plist avec des chemins documentés
WorkingDirectory manquant	Les chemins relatifs varient selon le contexte de lancement	Définir un répertoire de travail explicite ; interdire les chemins relatifs ambigus des outils
Consentement GUI jamais finalisé	Blocages silencieux sans crash	Créneau VNC réservé ; finaliser Trousseau/Accessibilité ; retour SSH

Erreurs HTTP des fournisseurs de modèles décodées

Les modèles hébergés échouent comme toute dépendance HTTP : 401 signale une dérive d’identifiants, 403 désigne souvent des listes d’IP ou la politique d’organisation, 429 indique une histoire de concurrence malhonnête, et 5xx doit vous pousser vers un ticket fournisseur avec les identifiants de requête — pas vers un nouveau réglage de température. Journalisez la forme exacte de la requête (pseudonymisée) et l’histogramme de latence pour distinguer une panne côté fournisseur du cas où « notre disque compresse gzip trop lentement pour l’upload ».

Maintenez un seul tableau markdown dans votre wiki qui mappe les codes HTTP au responsable (infra vs app vs fournisseur) pour que la triade de minuit n’invente pas de nouveau folklore.

Disque et RAM déguisés en « réseau »

Sur la mémoire unifiée Apple Silicon, une pression soutenée au-delà d’environ 14 Go résidents pour des charges interactives peut faire ressembler une poignée de main TLS à une perte de paquets parce que le CPU est occupé à récupérer des pages. De même, lorsque l’espace libre tombe sous environ 25 Go, SQLite local ou caches utilisés par les outils peuvent bloquer sur fsync alors que SSH répond encore aux pings.

Avant d’ouvrir un ticket région, exécutez deux fois la même requête lente : une à froid, une à chaud, avec conscience des instantanés diskutil apfs list. Si le second passage est bon, vous poursuivez un mauvais fantôme.

Checklist d’astreinte en huit étapes

1. Geler la configuration : noter le chemin exact de la plist, le SHA Git du dépôt de config et les identifiants de canaux.
2. Instantané des écouteurs avec lsof -nP -iTCP -sTCP:LISTEN dans le ticket.
3. Extraire les 200 dernières lignes de journal par utilisateur de service, pas des flux mélangés.
4. Noter le disque libre et les cinq plus gros répertoires sous le répertoire personnel du service.
5. Tester DNS et HTTPS sortants avec deux cibles indépendantes.
6. Comparer les tableaux fournisseur pour quota et taux d’erreur — pas les impressions.
7. Appliquer le redémarrage minimal (worker seul avant l’hôte entier).
8. Rédiger la cause racine en une ligne et lier la PR de prévention ou la diff du runbook.

Pourquoi le Mac mini M4 reste adapté à la culture du dépannage

Le Mac mini M4 récompense les opérateurs disciplinés : la mémoire unifiée rend les « ralentissements mystérieux » diagnostiquables dès que l’on cesse de prétendre que la RAM est infinie, le Neural Engine permet des embeddings sur appareil en option sans une autre classe de machines, et l’enveloppe énergétique modeste dissuade de « balancer du matériel sur un bogue de journalisation ». Louer via SlimVps permet d’éprouver cette culture à bas coût, puis de monter en mensuel lorsque votre temps moyen de rétablissement progresse vraiment — pas lorsque le marketing dit « saison IA ».

Lorsque les incidents passent du théâtre à la télémétrie, la finance remarque : moins de surclassements d’urgence, moins de bascules de région hasardeuses. Ancrez les tarifs sur la page tarifs, et les réparations sur ce guide ainsi que sur les compagnons déploiement et sécurité.