Vom Solo-PoC zu einer teamfähigen Installation ist die Hürde selten „können wir OpenClaw installieren?“ — sondern eine Gateway, die Telegram, Discord, Slack und Web Chat gleichzeitig hält, deterministisches Routing zu verschiedenen Agents und der sichere Zugang von Kollegen-Handys und -Laptops als Nodes für Gerätebefehle. Dieser Leitfaden nutzt einen gemieteten Vuncloud-M4-Mac-Cloud-Host als 7×24-Gateway-Anker und verknüpft Multi-Agent-Routing, Gateway-eigenes Node-Pairing und Kanal-Routing mit US-Ost / US-West / APAC, M4 16 GB/24 GB, 1 TB/2 TB und parallelen Splits. Fakten verankern auf docs.openclaw.ai; Install-Baseline im Mitmach-Runbook OpenClaw auf Mac-Cloud-Host; Fernzugriff im SSH-Tunnel vs. Direct (wss) (nur für Web Chat/Pairing-Abnahme zitiert — nicht die volle Link-Geschichte).
Suchintention: sechs Fragen → Entscheidungsmatrix
„Multi-Kanal, Multi-Agent, Node-Pairing, Region, Konfiguration, Mietdauer“ in einer Tabelle bündeln — dann openclaw.json bearbeiten.
| Ihre Frage | Zuerst prüfen | Nächster Schritt |
|---|---|---|
| Telegram und Discord brauchen verschiedene „Personas“ | agents.list + bindings |
Pro Kanal/Bot ein accountId, unterschiedliche agentId |
| Kollegen-Handys sollen Kamera/System-Befehle ausführen | openclaw nodes pending |
Gateway-Pairing-Freigabe abschließen (ab 2026.3.31 Pflicht) |
| Traffic landet immer bei main — „Routing kaputt“ | agents list --bindings |
Peer-Regelreihenfolge und fehlendes accountId |
| Gateway in US-Ost oder APAC? | Kanal-API-Egress + Bereitschafts-Zeitzone | Heißen Bot-Pfad mit Gateway co-lokalisieren; APAC-Node/VNC-Fallback |
| Reichen 16 GB für vier Kanäle? | Parallele Sitzungen + Workspace-Größe | 24 GB bei Multi-Agent + Plugins/skills parallel |
| State bei Mietdauer- oder Maschinenwechsel migrieren | OPENCLAW_STATE_DIR |
openclaw backup create --verify, dann offizielles migrating |
Architektur: Gateway-Kontrollebene vs. Node-Ausführung vs. Kanal-Rückschreiben
Drei Sätze für das mentale Modell:
- Gateway (resident Mac-Cloud-Host): einzige Kontrollebene; hält
~/.openclaw/openclaw.json, Kanal-Credentials,bindingsund Pairing-Store (nodes/paired.json). - Agent: isoliertes „Gehirn“ — eigenes
agentDir, Workspace, Session-Store; das Modell wählt nicht Ihren Kanal; eingehendes Routing sindbindings. - Node: Telefon, Laptop, headless Mac als Peripherie per WS zur Gateway, exponiert
node.invoke; keine zweite Gateway.
Eingehend: Kanal → Gateway-Route → gewählte Agent-Sitzung → Modell → Rückschreiben auf dasselbe Kanal-Konto. Ausgehende Gerätebefehle: Agent/Tool → Gateway → gepaarter Node.
Checkliste Remote-Mac-Umgebung
Bevor Sie Kanäle anfassen: „Gateway kann State zuverlässig schreiben“ muss stimmen:
- Node.js 22+ und vorhersagbares nicht-interaktives
PATH(launchd = SSH — Exit 127 vermeiden). OPENCLAW_STATE_DIRauf lokalem Datenträger (besonders 1 TB/2 TB-Mount), nicht auf dem System-Root-Volume.- Residenz:
openclaw onboard --install-daemon+pmsetgegen Schlaf; nach Reboot sofortopenclaw gateway status. - SSH: Automatisierung, Backup, Freigabe-CLI; VNC: GUI-Kanal-Logins oder Systemberechtigungsdialoge.
- Berechtigungen: Laufbenutzer darf State, Workspace,
credentials/schreiben;paired.jsonvertraulich behandeln.
US-Ost vs. US-West vs. APAC: Gateway-Platzierung
| Dimension | US-Ost-Gateway | US-West-Gateway | APAC-Gateway / Node |
|---|---|---|---|
| Kanal-API-Egress | Tendenz US-Ost-Upstream | Tendenz US-West-Upstream | APAC-Upstream; grenzüberschreitende Bots live testen |
| WebSocket / Ops-SSH | Geringere RTT für US-Ost-Teams | Geringere RTT für US-West-Teams | APAC-Bereitschaft; NA-Gateway bleibt trans-Pazifik |
| Parallel-Rollen-Hinweis | Primäre Gateway + öffentlicher Discord | Schwerer Node / Builds | VNC-Mensch-Fallback, regionaler Node |
| Auswahl-Hinweis | Artefakte/Modell-APIs heiß in US-Ost | Eine US-Küste wählen — keine zwei Gateways auf einem State-Dir | Leute in APAC, „Gehirn“ in NA: NA-Gateway + APAC-Node |
Regionen und Mietdauer im Detail: Regions-Handbuch; hier gilt: eine Produktions-Gateway → ein State-Verzeichnis.
M4 16 GB vs. 24 GB: Multi-Kanal + Multi-Agent-Schwelle
| Lastprofil | 16 GB | 24 GB |
|---|---|---|
| Einzel-Agent + 1–2 Kanäle PoC | Meist ausreichend | Mehr Reserve, ruhigeres Health |
| ≥3 Agent-Workspaces + Plugins/skills | Swap-Risiko — „Kanal hängt“ | Empfohlener Produktions-Default |
| Multi-Kanal parallele Sitzungen + Indizes | Enges Log-/Session-Retention | Besser für 7×24-Gateway |
1 TB/2 TB und State-Dir: Backup und Migration
State standardmäßig ~/.openclaw (Override mit OPENCLAW_STATE_DIR); Pairing in nodes/paired.json, pending.json. Vor Maschinenwechsel oder Mietdauerwechsel:
openclaw gateway stop
openclaw backup create --verify --output ~/Backups
# Auf neuer Instanz OPENCLAW_STATE_DIR einheitlich, dann gateway restart
Siehe backup CLI und migrating. Große Workspaces: --no-include-workspace verkleinert das Archiv — Workspace-Bäume danach selbst synchronisieren.
Mitlaufen: Gateway → Kanäle → Agent-Bindings → Node-Pairing
Schritte entsprechen dem HowTo-JSON-LD auf der Seite; Ports und Felder folgen Ihrer openclaw doctor-Ausgabe.
- Gateway installieren: Install-Abhängigkeiten;
openclaw onboard --install-daemon. - Kanäle konfigurieren: in
channels.telegram.accounts/channels.discord.accountspro Bot einaccountId;openclaw channels status --probe. - Multi-Agent:
openclaw agents add alerts,openclaw agents add social; nicht dasselbeagentDirwiederverwenden. - bindings-Beispiel (Telegram + Discord getrennt):
{
agents: {
list: [
{ id: "main", workspace: "~/.openclaw/workspace-main" },
{ id: "alerts", workspace: "~/.openclaw/workspace-alerts" },
],
},
bindings: [
{ agentId: "main", match: { channel: "discord", accountId: "default" } },
{ agentId: "alerts", match: { channel: "telegram", accountId: "alerts" } },
],
channels: {
telegram: {
accounts: {
alerts: { botToken: "…", dmPolicy: "pairing" },
},
},
discord: {
accounts: {
default: { token: "…" },
},
},
},
}
- Node-Pairing: nach Geräteverbindung zur Gateway auf der Ops-Maschine:
openclaw nodes pending openclaw nodes approve <requestId> openclaw nodes status
Ab 2026.3.31 laufen Node-Befehle erst nach freigegebenem Node-Pairing (Warteschlangen-Befehle werden verworfen). Nach Freigabe gelten weiterhin gateway.nodes.allowCommands und zugehörige Policy.
- Abnahme:
openclaw gateway restart→agents list --bindings→ Testnachricht pro Kanal → Web Chat stichprobenartig.
Parallel-Topologie: US-Ost-Gateway + US-West-Node + APAC-VNC
| Instanz | Rolle | Trägt |
|---|---|---|
| US-Ost M4 24 GB / 1 TB | Einzige Gateway | Telegram+Discord+Web Chat; alle bindings |
| US-West M4 16 GB | Schwerer Node | Kompilieren, Batch — keine zweite Gateway |
| APAC M4 + VNC | Menschlicher Fallback-Node | GUI-Logins/Berechtigungen; kurze Bereitschaftsfenster |
Parallel-Nutzen ist weniger Konkurrenz, nicht die Kontrollebene duplizieren. Tokens, OPENCLAW_STATE_DIR und Kanal-Credentials dürfen nur einen Schreiber haben.
Matrix Kanal × Agent × Region
| Kanal | account-Strategie | Typisches Agent-Binding | Gateway-Platzierung |
|---|---|---|---|
| Telegram | BotFather: ein Bot → ein accountId |
Alerts/Bereitschaft → alerts |
Gleiche Region wie NA-API-Hot-Path |
| Discord | Ein Bot-Token pro Persona | Community/Engineering → main / coding |
Message Content Intent beachten |
| Slack | Binding auf teamId-Ebene |
Agents pro Workspace | Mit Unternehmens-Egress-Policy co-lokalisieren |
| Web Chat | Gleiche Origin wie Gateway | Default main oder dedizierter Agent |
Browser-Origin muss zur Gateway passen |
FAQ: Pairing, Routing, Kanal-Login
Form: Symptom → Diagnose → Maßnahme (entspricht FAQPage oben).
- Kanal-Logout / Probe fail → Token-Rotation oder Gateway-Neustart →
channels status --probe; ggf.accountIderneut anmelden. - Falscher Agent (Binding) → Binding-Reihenfolge oder fehlendes
accountId→agents list --bindings; Peer-Regeln zuerst. - Pairing abgelaufen → pending 5-Minuten-Timeout → Node neu verbinden +
nodes approve. - Node-Befehle nicht freigegeben → Policy ab 2026.3.31 → Pairing abschließen; Geräte-Pairing allein reicht nicht.
- state_dir-Konflikt → zwei Gateways auf ein Verzeichnis → nur ein Schreiber; mit Backup migrieren.
- Voller Datenträger → Sitzungen/Logs → Datenträger erweitern + periodisches Backup;
dfbeobachten. - exit 127 → launchd-PATH → absolute Pfade; Install-Artikel.
- Health fail → gateway/config/Ressourcen → doctor + Vierer-Pack-Status.
- Web Chat stumm → Origin/WS → Link-Pfad-Artikel; hier kein vollständiges wss-Narrativ.
- Mietdauer-Migration → stop, backup →
OPENCLAW_STATE_DIRauf neuer Instanz → bindings und Pairing erneut testen.
paired.json enthält Node-Tokens — nie in Git committen. autoApproveCidrs nur in explizit vertrauenswürdigen Netzen gemäß offizieller Pairing-Doku aktivieren.
Mac kaufen vs. mieten
Kauf prüfen, wenn Kanalzahl, Agent-Zahl und Node-Skala langfristig stabil sind und Sie Hardware betreiben können. Die meisten Teams in Multi-Kanal-Iteration passen zu Tages-/Wochen-/Monatsmiete mit paralleler Rollenaufteilung. Keine erfundenen SLA- oder Absolut-Performance-Zahlen.
Abschluss und weiterführende Links
Empfohlene Reihenfolge: Gateway-Region und Residenz festlegen → Kanäle und Agent-Bindings → Node-Pairing-Abnahme → dann M4/Datenträger/Mietdauer oder Parallel-Topologie. Pakete: https://vuncloud.com/de/mac-mini-mieten.html; Regionen: https://vuncloud.com/de/index.html; Hilfe: https://vuncloud.com/de/help-center.html; Blog: https://vuncloud.com/de/blog/index.html.
Multi-Kanal in ein auditierbares Runbook schreiben
In Produktion bindings-Tabellen und Node-Pairing-Protokolle mit Change-Tickets versionieren. Diesen Artikel mit Install- und Link-Pfad-Beiträgen in der internen Wiki ablegen — weniger Wiederholung bei „falscher Agent“ und „Node nicht freigegeben“.
Über die Startseite Footprint prüfen, Budget an Paketen und Preisen ausrichten und das Hilfecenter für Bereitstellung nutzen.