01Trois modes de défaillance lorsque plusieurs piles partagent un hôte
Le parallélisme coûte cher dès que deux agents partagent arbre, jetons ou caches : l'extérieur voit alors des « pannes réseau » fantômes.
- OPENCLAW_HOME partagé : journaux et bundles temporaires se mélangent ; le second boot hérite d'un état à moitié câblé.
- Port 18789 : plist dupliqués → port occupé ou TLS intermittent.
- Disque : au-delà d'environ 95 % sur 1 To, la latence grimpe même si le CPU est libre.
02Seuils de location : APAC contre ouest des États-Unis
SaaS US dense → ouest USA. Opérateurs APAC avec RTT < 120 ms → Singapour ou Japon ; vérifiez l'aide. Documentez la décision dans le ticket pour éviter les arbitrages tacites en astreinte.
| Signal | Favoriser l'APAC | Favoriser l'ouest USA |
|---|---|---|
| RTT médian opérateur → passerelle | Moins de quatre-vingt-dix ms depuis l'Asie de l'Est | Moins de quatre-vingt-dix ms depuis la côte Pacifique US |
| Géographie des API amont | CDN APAC ou données soumises à résidence régionale | Edges SaaS US East ou US West majoritaires |
| Nombre d'instances parallèles sur un Mac | Deux maximum si le disque est 2 To et la rotation des journaux est nocturne | Même règle, plus vérification des plafonds de sortie indiqués en console |
03Matrice d'isolation OPENCLAW_HOME
Exportez OPENCLAW_HOME avant install ou openclaw doctor. N'associez pas deux foyers par lien symbolique vers un même dossier.
| Instance | Motif de chemin conseillé | Intérêt opérationnel |
|---|---|---|
| Passerelle alpha | ~/openclaw-alpha |
Profil stable pour le trafic proche de la production |
| Bêta canary | ~/openclaw-beta |
Isole les modèles expérimentaux sans toucher aux caches alpha |
| Rafales CI | ~/openclaw-ci |
Permet de supprimer tout l'arbre entre deux jobs sans gratter les préférences utilisateur |
04Collisions sur le port 18789 : launchctl print et lsof
Listez d'abord les écouteurs. Feuille de décalage : +20 bêta, +40 CI, lisible au grep.
Lister les processus en écoute
lsof -nP -iTCP:18789 -sTCP:LISTEN
lsof -nP -iTCP:18809 -sTCP:LISTENAfficher le job launchd propriétaire
sudo launchctl print system/com.exemple.openclaw.alpha
launchctl print gui/$(id -u)/com.exemple.openclaw.betaCroisez environment dans launchctl print avec lsof. Écart ports ↔ plist : corrigez OPENCLAW_HOME et ports avant reload.
05Paramètres de garde-fou disque : 1 To contre 2 To
Pression disque ≈ timeouts TLS : df hebdo et respect des seuils du tableau.
| Paramètre | Palier 1 To | Palier 2 To |
|---|---|---|
| Plancher d'espace libre confortable | Conserver au moins cent vingt Go libres avant d'activer deux passerelles | Viser deux cents Go libres avec trois flux journaux lourds |
| Cadence de rotation | Compression quotidienne et purge hebdomadaire | Compression hebdomadaire et archive froide mensuelle hors machine |
| Budget cache modèle | Un gros bundle actif plus un emplacement de rechange | Bundles alpha et bêta en parallèle sans partage de chemins |
06Fusionner openclaw doctor par foyer
openclaw doctor par shell avec OPENCLAW_HOME exporté ; fusionnez les nouvelles clés dans le json de ce foyer seulement, puis un LaunchAgent à la fois pour rollback simple.
07Six étapes avant d'autoriser une seconde instance
- Région : matrice puis achat ou page régionale.
- Foyers : arbres séparés, pas de symlink croisé.
- Ports : décalages dans plist + configs, puis restart.
- Sockets :
lsofpar port, sortie dans le ticket. - launchd : extrait
launchctl print+ hash plist. - Doctor : fusion +
dfsigné.
08Repères réutilisables dans une note d'architecture
09FAQ pour les responsables plateforme
Un seul foyer pour un agent ? OK en séquentiel si arrêt propre ; dès qu'il y a du parallèle, séparez les arbres (démons résiduels).
Egress / TLS ? Comparez à la matrice régionale avant de blâmer OpenClaw. SKU : ouest USA ou hub APAC (HK, KR) + blog.
10Liste de contrôle prête à coller dans un ticket
- Foyers : valeur OPENCLAW_HOME unique par instance dans l'en-tête du ticket.
- Ports : une ligne de tableau par plist, plus pièce jointe
lsof. - launchd : extrait
launchctl printadjacent au hachage du plist. - Disque : instantané
dfet palier 1 To ou 2 To cosigné. - Doctor : transcriptions fusionnées avec les deltas surlignés.
Tarifs pour le disque ; aide pour SSH et passerelle.