Architektura OpenClaw: nodes i gateway

Architektura OpenClaw: kluczowe komponenty i ich powiązania

OpenClaw wykorzystuje architekturę hub-and-spoke z centralnym Gateway jako płaszczyzną sterowania. Dzięki temu agent może komunikować się z urządzeniami peryferyjnymi i kanałami wejścia-wyjścia. Zrozumienie ról node, session, channel i operator ułatwia konfigurację i korzystanie z systemu dla programistów średniozaawansowanych i seniorów.

Node działa jako urządzenie towarzyszące, podłączające się do Gateway przez WebSocket z rolą role: "node". Oferuje interfejs komendowy poprzez node.invoke, w tym canvas., camera., device., notifications., system.* i system.run.

Role i interakcje aktorów

Gateway zarządza połączeniami od node i operatorów, koordynuje channels, sessions i parowanie urządzeń. Channels integrują się z komunikatorami takimi jak WhatsApp, Telegram, Discord, Slack, Signal, przekazując wiadomości do session → agent i z powrotem.

| Akcja | Odpowiedzialność | Interakcja |

|-------|------------------|------------|

| Gateway | Płaszczyzna sterowania | Połączenia node/operatorów, zarządzanie sessions/channels |

| Channels | Integracja z komunikatorami | Przekazywanie wiadomości do Gateway → Session → Agent |

| Nodes | Peryferia | Połączenie z role: node, node.invoke |

| Operators | Zarządzanie | Parowanie, zatwierdzanie, konfiguracja |

| Sessions | Kontekst agenta | Przechowywanie historii, stanu |

| Agent | Środowisko AI | Wywoływanie narzędzi/node w session |

| User | Końcowy użytkownik | Przez channels/operators |

| Devices | Podłączane urządzenia | Parowanie przez Gateway |

Przepływ: User → Channel → Gateway → Session → Agent → Node/Channel. Operator zatwierdza parowanie i akcje.

Rodzaje node:

• Aplikacja w pasku menu macOS
• iOS/Android dla kamery, GPS, ekranu
• Headless (openclaw node run) dla serwerów
• Rozszerzenie VS Code

Canvas i A2UI w ekosystemie

Canvas to wizualna przestrzeń sterowana przez agenta. A2UI to protokół do dynamicznego tworzenia interfejsów. Agent wywołuje canvas.present, canvas.a2ui.push, generując opis JSON UI, wyświetlany na node (macOS, iOS, Android, web).

Scenariusze:

• Dynamiczne pulpity
• Interaktywne formularze
• Wizualizacja danych
• Aplikacje natywne dla AI (CRM, monitoring)
• Gry, galerie

Akcje użytkownika wracają do agenta przez WebSocket, zapewniając aktualizacje w czasie rzeczywistym.

Przykłady z praktyki: Osobiste CRM

Problem: Dane rozproszone po Gmailu, WhatsApp, Kalendarzu, Notion.

Przepływ użytkownika: Wiadomość w Telegramie: „Karta Ivana Ivanova”. Agent otwiera Canvas z zakładkami, polami, historią.

Rezultat: Jednolite AI-CRM z aktualizacjami na żywo.

Architektura: Channel → Gateway → Session → Agent (umiejętność canvas + A2UI) → Node (UI). Operator do zatwierdzeń, dane w session.

Przykłady: Poranny briefing

Problem: Ręczne zbieranie danych z kalendarza, poczty, pogody (10–15 min).

Przepływ użytkownika: „Briefing” → doprecyzowania typu „Pogoda w Warszawie”.

Rezultat: Podsumowanie z wykresami w Canvas.

Architektura: Zaplanowane zadanie Gateway → Session → Agent (umiejętności: kalendarz/poczta/pogoda) → Channel/Canvas. Headless node opcjonalnie.

Przykłady: Rodzinna lista zakupów

Problem: Chaos w grupowym czacie.

Przepływ użytkownika: Wiadomości w grupie Telegram → „Pokaż koszyk” → Canvas ze listą, przyciskami.

Rezultat: Aktualna lista na mobilnym node.

Architektura: Channel (grupa) → Gateway → Session → Agent (parsowanie, canvas) → Mobile Node. WebSocket dla akcji.

Przykłady: Orkiestracja multiagenta

Problem: Pojedynczy agent traci fokus.

Przepływ użytkownika: „Apel” → delegowanie zadań.

Rezultat: Końcowy raport od zespołu agentów.

Architektura: Gateway (wiele sessions) → Główny Agent (delegacja) → Nodes na agenta → Channel.

Przykłady: Farma drukarek 3D

Problem: Ręczny monitoring drukarek Bambu Lab.

Przepływ użytkownika: „Status X1C”, „Uruchom Benchy”, „Pokaż kamerę”.

Rezultat: Zdalne sterowanie z kamerą.

Architektura: Channel → Gateway → Session → Agent → Physical Node (integracja Bambu) → Drukarki.

Co ważne

• Gateway — centralny hub, bez niego system nie działa.
• Nodes rozszerzają agenta na urządzenia: headless dla serwerów, mobilne dla sensorów.
• Canvas/A2UI zamieniają czat w pełny interfejs.
• Sessions izolują konteksty, przechowują pamięć.
• Operators zapewniają bezpieczeństwo parowania/zatwierdzeń.

— Editorial Team