- Home-Pfad-Drift: Zwei Agenten schreiben in dasselbe Verzeichnis, Signaturdateien überschreiben sich und Healthchecks flappen ohne klare PID-Zuordnung.
- Port-Fingerprint: Der Default um 18789 blockiert sekundäre Instanzen, bis Offset oder plist-ProgramArguments konsistent versioniert sind.
- Speicher-Resonanz: Doppelte Caches füllen NVMe schneller als geplant; ohne 1-TB- oder 2-TB-Schwellen entstehen nächtliche Abbrüche mitten im Doctor-Lauf.
01OPENCLAW_HOME: Isolierung paralleler Instanzen auf Bare-Metal
Jede Instanz braucht einen eigenen Stamm für Konfiguration und Telemetrie. Exportieren Sie OPENCLAW_HOME vor jedem Bootstrap und spiegeln Sie den Wert in der LaunchAgent-Umgebung. Region und RAM vor zweiten Agenten im Knotenkonfigurator festhalten.
| Parameter | Instanz A (primär) | Instanz B (sekundär) |
|---|---|---|
| OPENCLAW_HOME | ~/openclaw-a | ~/openclaw-b |
| LaunchAgent-Label | com.kunde.openclaw.primary | com.kunde.openclaw.secondary |
| Logrotation | Eigenes Verzeichnis unter dem Home-Baum | Getrennte Datei-Inodes, kein Symlink auf A |
| Sicherheitsgrenze | TLS-Material nur in A | Keine gemeinsame Keychain-Policy ohne explizites Review |
Vertiefung Gateway und TCC: OpenClaw Gateway Ops.
02Port 18789: Konflikte per launchctl und lsof auflösen
Zuerst Listener per lsof prüfen, PID mit launchctl print dem plist zuordnen. Offsets pro Instanz typisch plus zwanzig oder plus vierzig, im Runbook und Monitoring dokumentieren.
launchctl print gui/$(id -u)/com.kunde.openclaw.primary
launchctl print gui/$(id -u)/com.kunde.openclaw.secondary
| Symptom | Diagnosebefehl | Korrekturpfad |
|---|---|---|
| Doppelter Listen | lsof zeigt zwei PIDs auf 18789 | Sekundären Port in JSON plus Firewall-Regel nachziehen |
| Plist driftet | launchctl print zeigt altes ProgramArguments | launchctl bootout gui/$(id -u)/… dann bootstr mit neuer Env |
| Flapping Health | PID wechselt alle wenige Minuten | Crash-Logs im jeweiligen OPENCLAW_HOME prüfen, RAM-Profil im Tarifrechner erhöhen |
03SSD-Wasserstände 1 TB und 2 TB: Parameterliste für Parallel-Caching
Zwei Homes verdoppeln Cache-Spillover; Matrix mit df -h und rollierendem Fenster prüfen. Speicher-Kauf: APAC vs. US-West.
| Indikator | 1 TB empfohlen ab | 2 TB empfohlen ab |
|---|---|---|
| Median belegt | 420 GB über 30 Tage | 880 GB oder starkes Video-Logging |
| Spitzenlast | 620 GB an Release-Tagen | 1,1 TB mit parallelen Modell-Exports |
| Freier Puffer | Mindestens 12 Prozent frei halten | 15 Prozent frei für macOS-Updates |
| Ops-Hinweis | Doctor-Caches getrennt pro Home löschen | Langzeitarchivierung auf zweitem Host statt Single-Disk |
04APAC versus US-West: Schwellenmatrix für Gateway-Standorte
US-West, wenn über zwei Drittel der Upstreams in Nordamerika liegen; APAC bei ostasiatischen Operatoren und kritischem RTT. TLS vor Vertrag messen, dokumentieren im Hilfe-Center; Status in der Konsole.
| Schwelle | US-West bevorzugen | APAC bevorzugen |
|---|---|---|
| API-Standort | Über 65 Prozent US-Endpunkte | Über 60 Prozent APAC-Endpunkte |
| Operatorzeitzone | US-Shift deckt 70 Prozent der Fenster | APAC-Shift dominiert Business-Hours |
| Compliance | US-Datenresidenz vorgegeben | Ostasiatische Residenz oder niedriger Exportbedarf |
05Sieben operative Schritte inklusive openclaw doctor Merge
- Verzeichnisse anlegen: Zwei getrennte OPENCLAW_HOME-Bäume mit POSIX-Rechten prüfen und Quoten im Auge behalten.
- Ports offsetten: Basis 18789 für primär, sekundär plus zwanzig, tertiär plus vierzig, jeweils in JSON und Monitoring hinterlegen.
- launchctl print: Für jedes Label ProgramArguments und Environment validieren, bevor bootstr ausgeführt wird.
- lsof verifizieren: Nach jedem Deploy Listenerliste speichern und mit erwarteten Ports abgleichen.
- Doctor je Home: In separaten Shells openclaw doctor laufen lassen, Diff gegen Upstream lesen und nur den betroffenen Baum mergen.
- Rollierender Neustart: Zuerst sekundären Agenten bootout, Änderungen testen, dann primären aktualisieren, um Rollback-Pfade kurz zu halten.
- SSD nachmessen: Wenn df -h die Tabellenschwellen erreicht, 1 TB oder 2 TB im Checkout nachziehen und Caches pro Instanz trimmen.
06FAQ: häufige Parallel-Betriebsfragen
Darf ich denselben Git-Clone für beide Instanzen nutzen? Nur wenn Arbeitsverzeichnisse strikt getrennt sind; Konfigurationsartefakte müssen dennoch in unterschiedlichen OPENCLAW_HOME-Bäumen liegen.
Was tun bei divergierenden doctor-Hinweisen? Jede Instanz separat mergen, keine globalen Defaults blind kopieren, sonst überschreiben sich Gateway-JSON-Dateien.
Wie teste ich Offsets ohne Produktionslast? Temporär einen dritten High-Port wählen, Healthcheck anpassen und nach erfolgreichem Canary auf den finalen Offset zurücksetzen.
Wo buche ich zweite Slots? Über Kaufen mit expliziter Regionswahl; technische Grenzen stehen im Hilfe-Center.
Fazit: OPENCLAW_HOME, Port-Offset und doctor-Merge bilden eine Kette. US-West plus saubere Isolation vermeidet Port-Kollisionen und sichert NVMe-Puffer; Gateway-Leitfaden und Speicher-Matrix vor weiteren LaunchAgents lesen.
Zweiten US-West- oder APAC-Slot mit passender SSD buchen
Wählen Sie im Konfigurator Region und Speicher, prüfen Sie Tarife und lesen Sie im Hilfe-Center Grenzwerte zu Ports und Speicher—danach sekundären LaunchAgent ohne Risiko für den Primärpfad ausrollen.