IA / Automatisation 21 avril 2026

2026-04-21 — OpenClaw sous-agents & liaisons de canaux sur Mac cloud sans tête loué

Équipe ingénierie MacXCode 21 avril 2026 ~16 min de lecture

Quand les fils Discord n’atteignent plus les sous-agents ou que Telegram se tait alors que la passerelle écoute 127.0.0.1:18789, c’est un problème de liaison + session, pas une panne modèle. Sur Apple Silicon loué avec seulement SSH, pas de clic GUI pour réparer les cartes. Ce runbook du 2026-04-21 enchaîne openclaw doctor, sondes de canaux, vérification des répertoires de session, redémarrage contrôlé, puis renvoie vers sondes de santé, nginx et upgrade/rollback passerelle pour une histoire de récupération partagée HK / JP / KR / SG / US, distincte de l’article Skills & ClawHub centré sur la mise en page des paquets.

Symptômes à classifier

Ce que vous voyez Couche probable Premier geste
Passerelle OK, canaux silencieux Jeton, webhook ou appairage Statut canal + liste d’appairage
Erreurs sous-agents mentionnant sessions Validation de chemin disque Droits et config du dossier sessions
Flapping après upgrade npm Install globale obsolète vs processus Arrêter la passerelle, comparer openclaw --version

Doctor, statut, corrélation journaux

Commencez par openclaw doctor vers votre pipeline. Croisez LaunchAgents dupliqués.

openclaw doctor 2>&1 | tee /tmp/openclaw-doctor-$CI_BUILD_ID.log

Couplage upgrade : si vous venez de changer de mineur npm, alignez-vous d’abord sur onboard & démon.

Liaisons & barrières de mention

Vérifiez que openclaw.json mappe les IDs de canal aux IDs d’agent. requireMention peut silencieusement filtrer. Pour l’ingress public, TLS sur nginx avec limites de débit prudentes.

Sessions & stockage sous-agents

Les releases resserrent : les fichiers de session doivent vivre sous la racine sessions. Après upgrade, diff contre les notes de version ; ajustez OPENCLAW_STATE_DIR selon secrets & launchd plutôt que chmod aveugle.

Sécurité : répertoires d’état au service user ; pas de sessions lisibles par tous.

Rebond sans ruée

  1. Pause ingress — 503 avec Retry-After en amont.
  2. Arrêt passerelle (CLI ou launchctl).
  3. Démarrage puis santé locale avant le monde extérieur.

Nginx, santé, bascule régionale

Après curl local, réactivez nginx et surveillez. Si un Mac régional est malade, basculez vers un second nœud listé dans tarifs au lieu de rebooter en boucle.

Accès mesh : Tailscale. Docker vs npm natif : comparatif. Champs journaux : journalisation structurée.

FAQ

Question Réponse
Partager l’utilisateur passerelle ? Mieux vaut des états séparés par environnement — même sur un seul Mac.
Automatiser les approbations d’appairage ? Seulement selon la tolérance au risque ; documentez le propriétaire.
Suivi d’incident ? Corrélez journaux passerelle et tableaux fournisseur ; semver + SHA dans le ticket.

En bref : traitez les liaisons comme des règles pare-feu — IDs explicites, chemins explicites, redémarrages explicites — et gardez des archives rollback quand vous touchez aux npm globaux.

Passerelles M4 dédiées OpenClaw

SSH d’abord · HK · JP · KR · SG · US