OpenClaw Multi-Agent-Orchestrierung: Gateway-Guide 2026
Ein einzelner KI-Assistent reicht für schnelle Fragen. Produktionsarbeit — Coding, Ops-Alerts, Familienchat, Recherche — braucht mehrere Personas ohne geteilte Sessions, Credentials oder Tool-Berechtigungen. OpenClaw Multi-Agent-Orchestrierung löst das mit einem Gateway und vielen isolierten Agents.
OpenClaw ist ein local-first Personal Assistant (375k+ GitHub-Stars 2026). Offizielles Multi-Agent-Routing: eingehende Nachrichten treffen die Binding-Tabelle und landen am richtigen agentId ohne Cross-Talk.
Dieser Guide behandelt:
- Was ein OpenClaw-Agent auf der Festplatte ist
- Routage per Bindings (Peer, Account, Channel)
- Zweiten Agent in 7 Schritten hinzufügen
- Orchestrierung jenseits des Routings
- Native Gateway-Routing vs externe Orchestratoren
Sie nutzen bereits Obra Superpowers oder Understand Anything? OpenClaw ist eine andere Schicht: Always-on-Assistent + Kanal-Routing. Siehe auch die besten Claude Code Plugins 2026.
Einleitung
In Produktion ist Persona-Trennung Pflicht. Details folgen unten.
Was ein OpenClaw-Agent umfasst
~/.openclaw/agents/<agentId>/.| Komponente | Pfad | Zweck |
|---|---|---|
| Workspace | ~/.openclaw/workspace-<name> | cwd; SOUL.md, skills |
| Agent dir | ~/.openclaw/agents/<agentId>/agent | Auth, Modelle, Config |
| Sessions | ~/.openclaw/agents/<agentId>/sessions | Chat + Routing-State |
| Config | ~/.openclaw/openclaw.json | Gateway, agents.list, bindings |
Wichtig: Niemals denselben agentDir für zwei Agents.
Quelle: OpenClaw Multi-Agent-Docs.
agentId · accountId · binding
| Konzept | Bedeutung |
|---|---|
agentId | Ein Gehirn (Workspace + Sessions + Auth) |
accountId | Ein Kanal-Login |
binding | Match-Regel → agentId |
Routing ist deterministisch — spezifischste Regel gewinnt.
Gateway-Architektur
Inbound → Gateway → Bindings → agentId → Workspace + Session → LLM + Tools pro Agent.
Der Gateway ist Router und Session-Manager. tools.agentToAgent ist standardmäßig aus.
Einrichtung: zweiten Agent hinzufügen
Schritt 1 — Install/Update
Offizieller Installer, openclaw --version.
Schritt 2 — Agent anlegen
openclaw agents add coding
Schritt 3 — Auflisten
openclaw agents list --bindings
Schritt 4 — Kanal verbinden
openclaw channels login --channel whatsapp --account work
Schritt 5 — Bindings bearbeiten
Peer-Regeln über accountId: "*".
Schritt 6 — Neustart & Probe
openclaw gateway restart · openclaw channels status --probe
Schritt 7 (optional) — Modell pro Kanal
model: pro Agent unabhängig setzen.
Orchestrierungsmuster
Routing: welcher Agent? Orchestrierung: wie kooperieren mehrere Agents?
Muster A — Nur natives Routing (zuerst)
| Szenario | Binding |
|---|---|
| Work vs privat WhatsApp | accountId → agentId |
| DM großes Modell | peer.kind: "direct" + E.164 |
| Discord Coding | guildId + channel |
| Familiengruppe | eigener Agent + Mentions |
Muster B — Agent-zu-Agent
tools.agentToAgent mit allowlist.
Muster C — Externe Orchestratoren
| Projekt | Stil | Für |
|---|---|---|
| openclaw-orchestrator | LLM-Planner | offene Ziele |
| visueller Orchestrator | Graph, Freigaben | Compliance |
| open-claw-code | hierarchische Coding-Agents | Multi-Repo |
- Nur Kanal-Identitäten trennen → Muster A
- Multi-Step-Projekte → B oder C
- IDE-TDD → Obra Superpowers
Sicherheit
Nicht vertrauenswürdige Agents: Sandbox + Tool-deny. tools.elevated ist global.
Wo der Gateway läuft
OpenClaw ist local-first (macOS, Linux, WSL2). Gateway für Webhooks online halten.
Teams betreiben den Gateway manchmal auf einem dedizierten Mac mit 24/7-Betrieb statt auf einem Laptop — wie ein Heimserver, mit SSH für die Verwaltung. Siehe unseren Mac mini M4 SSH-Zugang Guide für Remote-Grundlagen.
Fehlerbehebung
Falscher Agent antwortet
openclaw agents list --bindings — Regelreihenfolge, dann openclaw gateway restart.
Auth/Session vermischt
Einzigartiger agentDir pro Agent; ggf. openclaw channels login.
Probe schlägt fehl
Credentials, Firewall, Tokens laut Kanal-Guides.
FAQ
agentId.install.sh openclaw.Fazit
OpenClaw Multi-Agent-Orchestrierung beginnt am Gateway: deterministische Bindings, isolierte Agents. Dann optional agent-to-agent oder externe Orchestratoren.
Gateway dauerhaft betreiben
Für einen dedizierten Mac mit OpenClaw finden Sie SSH- und Betriebsgrundlagen in der Hilfe.