====== OpenClaw ======

[[https://github.com/openclaw/openclaw|OpenClaw]] je open-source osobní AI asistent a zároveň vícekanálový gateway pro modely, nástroje a chatovací platformy. Projekt míří na self-hosted provoz: běží na vlastním zařízení, obsluhuje vybrané komunikační kanály a podle [[https://docs.openclaw.ai|oficiální dokumentace]] funguje hlavně jako dlouhodobě běžící control plane pro asistenta, ne jen jako jednorázový chat v prohlížeči.

===== Co projekt umí =====

Podle README a dokumentace OpenClaw kombinuje několik vrstev do jednoho celku:

  * běží jako lokální nebo vzdáleně přístupný gateway proces pro AI asistenta
  * napojuje chatovací kanály jako [[https://docs.openclaw.ai/channels|WhatsApp, Telegram, Slack, Discord, Signal, Google Chat, Matrix, Microsoft Teams a další]]
  * umí více agentů a směrování konverzací do oddělených session a workspace
  * nabízí webové Control UI, WebChat a doprovodné klienty nebo nody pro macOS, iOS a Android
  * podporuje práci s médii, hlasem, live Canvasem, nástroji, cron úlohami a skills
  * lze ho propojit s více poskytovateli modelů a s OpenAI kompatibilními HTTP endpointy

Prakticky to znamená, že jeden běžící proces může fungovat jako centrální vrstva mezi LLM, komunikačními kanály a nástroji, které má agent k dispozici.

===== Jak je OpenClaw navržený =====

Podle [[https://docs.openclaw.ai/concepts/architecture|popisu architektury]] je jádrem projektu dlouhodobě běžící gateway. Ten drží připojení ke kanálům, zajišťuje sessions, routing, události a obsluhuje klienty přes WebSocket API.

Důležité vlastnosti návrhu:

  * výchozí gateway běží na ''127.0.0.1:18789''
  * ke stejné instanci se přes WebSocket připojují CLI, webové UI i nody zařízení
  * jeden gateway obsluhuje více komunikačních ploch a více agentů
  * na stejném portu může běžet i Control UI a HTTP API
  * projekt počítá s jedním gatewayem na hostiteli, ne s několika konkurenčními instancemi pro stejný use-case

V repozitáři je vidět i poměrně široký záběr projektu: vedle ''src'' a ''packages'' obsahuje například ''apps'', ''extensions'', ''skills'', ''ui'' a rozsáhlou dokumentaci v ''docs''. Z ''package.json'' je zároveň patrné, že jde primárně o Node.js a TypeScript projekt distribuovaný jako CLI nástroj ''openclaw''.

===== Rychlý start =====

[[https://docs.openclaw.ai/start/getting-started|Getting Started]] i oficiální README doporučují jako základní cestu onboarding přes CLI. Pro běžné použití je doporučený Node 24.

<code bash>
npm install -g openclaw@latest
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard
</code>

Alternativně dokumentace nabízí i instalační skript pro macOS a Linux:

<code bash>
curl -fsSL https://openclaw.ai/install.sh | bash
</code>

Pokud se OpenClaw staví ze zdrojů, README uvádí tento základ:

<code bash>
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm openclaw onboard --install-daemon
</code>

===== Bezpečnostní model =====

[[https://docs.openclaw.ai/gateway/security|Bezpečnostní dokumentace]] výslovně říká, že OpenClaw je navržený jako personal assistant pro jednu důvěryhodnou hranici operátora. Není to platforma pro nepřátelsky víceuživatelský provoz nad jedním sdíleným gatewayem.

Z praktického pohledu je důležité hlavně toto:

  * příchozí DM zprávy se mají brát jako nedůvěryhodný vstup
  * výchozí doporučení je používat pairing a allowlisty místo otevřeného provozu
  * gateway má mít zapnutou autentizaci a pokud možno běžet jen na loopbacku nebo za VPN či Tailscale
  * pokud více nedůvěryhodných lidí píše jednomu agentovi s povolenými nástroji, sdílí tím stejnou autoritu nad nástroji
  * pro sdílené nebo firemní use-cases je lepší oddělit trust boundaries samostatným gatewayem, hostem nebo OS uživatelem

Dokumentace také doporučuje pravidelně spouštět audit:

<code bash>
openclaw security audit
openclaw security audit --deep
</code>

To je u podobného projektu podstatné, protože OpenClaw může mít přístup k shellu, souborům, browser automation i reálným komunikačním kanálům.

===== Rozšiřitelnost a integrace =====

Podle [[https://github.com/openclaw/openclaw/blob/main/VISION.md|VISION.md]] se OpenClaw snaží držet jádro relativně lean a další schopnosti přesouvat do pluginů. Prakticky je zajímavé hlavně toto:

  * projekt má plugin API a rozšíření mohou běžet mimo core repozitář
  * skills se ukládají do workspace a jsou součástí běžného workflow asistenta
  * MCP je podporované přes bridge [[https://github.com/steipete/mcporter|mcporter]], ne jako nativní runtime přímo v jádře
  * gateway umí vystavit i OpenAI kompatibilní endpointy jako ''/v1/models'', ''/v1/chat/completions'' nebo ''/v1/responses''

Tím se z OpenClawu nestává jen chat bot do jedné platformy, ale spíš integrační vrstva pro osobního asistenta, kterého lze postupně rozšiřovat.

===== Kdy to dává smysl =====

OpenClaw dává největší smysl tam, kde je cílem provozovat vlastního AI asistenta nad vlastní infrastrukturou a používat ho v kanálech, které už člověk stejně používá. Silná stránka projektu je kombinace lokálního gatewaye, více kanálů, routing pravidel, nástrojů a rozšiřitelnosti.

Naopak pokud je cílem jen jednoduchý webový chat nad jedním modelem, může být OpenClaw zbytečně široký a provozně náročný. Projekt je zjevně stavěný spíš pro lidi, kteří chtějí mít asistenta jako dlouhodobě běžící systém, ne jen jako jednu webovou aplikaci.

===== Zdroje =====

  * [[https://github.com/openclaw/openclaw|OpenClaw na GitHubu]]
  * [[https://docs.openclaw.ai|Oficiální dokumentace OpenClaw]]
  * [[https://docs.openclaw.ai/concepts/architecture|Gateway architecture]]
  * [[https://docs.openclaw.ai/channels|Přehled podporovaných kanálů]]
  * [[https://docs.openclaw.ai/gateway/security|Security]]
  * [[https://docs.openclaw.ai/start/getting-started|Getting Started]]
  * [[https://github.com/openclaw/openclaw/blob/main/VISION.md|VISION.md]]
  * [[https://github.com/steipete/mcporter|mcporter]]