Architektura OpenClaw: nodes a gateway

Architektura OpenClaw: klíčové komponenty a jejich propojení

OpenClaw využívá architekturu hub-and-spoke s centrálním Gateway jako control plane. To umožňuje agentovi komunikovat s periferními zařízeními a vstupně-výstupními kanály. Porozumění rolím node, session, channel a operator usnadňuje nastavení a používání systému pro středně pokročilé a senior developery.

Node funguje jako společník zařízení, který se připojuje k Gateway přes WebSocket s rolí role: "node". Poskytuje příkazovou rozhraní přes node.invoke, včetně canvas., camera., device., notifications., system.* a system.run.

Role a interakce aktérů

Gateway spravuje připojení od nodů a operátorů, koordinuje kanály, sessiony a párování zařízení. Kanály se integrují s messengery jako WhatsApp, Telegram, Discord, Slack, Signal a předávají zprávy do session → agent a zpět.

| Aktér | Odpovědnost | Interakce |

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

| Gateway | Control plane | Připojení nodů/operátorů, správa sessionů/kanálů |

| Kanály | Integrace s messengery | Předávání zpráv do Gateway → Session → Agent |

| Nody | Periférie | Připojení s role: node, node.invoke |

| Operátoři | Řízení | Párování, schvalování, konfigurace |

| Sessiony| Kontext agenta | Uložení historie, stavu |

| Agent | AI-runtime | Volání nástrojů/nodů v session |

| Uživatel| Koncový uživatel | Přes kanály/operátory |

| Zařízení| Připojitelná zařízení | Párování přes Gateway |

Tok: Uživatel → Kanál → Gateway → Session → Agent → Node/Kanál. Operátor schvaluje párování a akce.

Typy nodů:

• macOS menubar app
• iOS/Android pro kameru, GPS, obrazovku
• Headless (openclaw node run) pro servery
• VS Code extension

Canvas a A2UI v ekosystému

Canvas je vizuální prostor řízený agentem. A2UI je protokol pro dynamické vytváření rozhraní. Agent volá canvas.present, canvas.a2ui.push a generuje JSON popis UI, který se zobrazí na nodech (macOS, iOS, Android, web).

Scénáře:

• Dynamické dashboardy
• Interaktivní formuláře
• Vizualizace dat
• AI-native appky (CRM, monitoring)
• Hry, galerie

Akce uživatele se vracejí agentovi přes WebSocket, což zajišťuje real-time aktualizace.

Příklady z praxe: Personal CRM

Problém: Data jsou roztroušena v Gmailu, WhatsAppu, Kalendáři, Notionu.

User flow: Zpráva v Telegramu: „Kartu Ivana Ivanova“. Agent otevře Canvas s taby, poli, historií.

Výsledek: Jednotný AI-CRM s real-time aktualizacemi.

Architektura: Kanál → Gateway → Session → Agent (canvas skill + A2UI) → Node (UI). Operátor pro schvalování, data v session.

Příklady: Ranní briefing

Problém: Ruční shromažďování dat z kalendáře, emailu, počasí (10–15 min).

User flow: „Briefing“ → upřesnění jako „Počasí v Praze“.

Výsledek: Digest s grafy v Canvas.

Architektura: Gateway scheduled job → Session → Agent (skilly: kalendář/email/počasí) → Kanál/Canvas. Headless node volitelně.

Příklady: Rodinný nákupní košík

Problém: Chaos v skupinovém chatu.

User flow: Zprávy ve skupině Telegram → „Ukaž košík“ → Canvas se seznamem, tlačítky.

Výsledek: Aktuální seznam na mobilním nodu.

Architektura: Kanál (skupina) → Gateway → Session → Agent (parsování, canvas) → Mobilní Node. WebSocket pro akce.

Příklady: Multiagentní orchestrace

Problém: Jeden agent ztrácí fokus.

User flow: „Roll call“ → delegování úkolů.

Výsledek: Finální report od týmu agentů.

Architektura: Gateway (mnoho sessionů) → Hlavní Agent (delegace) → Nody pro agenta → Kanál.

Příklady: Farma 3D tiskáren

Problém: Ruční monitoring tiskáren Bambu Lab.

User flow: „Stav X1C“, „Spusť Benchy“, „Ukaž kameru“.

Výsledek: Dálkové ovládání s kamerou.

Architektura: Kanál → Gateway → Session → Agent → Fyzický Node (Bambu integrace) → Tiskárny.

Co je důležité

• Gateway — centrální hub, bez něj systém nefunguje.
• Nody rozšiřují agenta na zařízení: headless pro servery, mobilní pro senzory.
• Canvas/A2UI mění chat na plnohodnotné UI.
• Sessiony izolují kontexty, ukládají paměť.
• Operátoři zajišťují bezpečnost párování/schvalování.

— Editorial Team