Clawdbot: open-source osobní AI asistent pro WhatsApp, Telegram a další

Co kdyby váš AI asistent nebyl webová aplikace, ale lokální agent, se kterým si píšete přes WhatsApp nebo Telegram? Přesně to nabízí Clawdbot — open-source projekt, který propojuje messaging platformy s AI modely.

Na rozdíl od ChatGPT nebo Claude.ai běží Clawdbot na vašem počítači. Ale pozor — „lokální” neznamená „soukromé”. Vaše data stále putují do cloudových API.

Co je Clawdbot?

Clawdbot je osobní AI asistent napsaný v TypeScriptu, který funguje jako gateway mezi chat aplikacemi a AI modely. Spustíte ho lokálně a komunikujete s ním přes běžné messengery:

• WhatsApp — přes knihovnu Baileys
• Telegram — přes grammY framework
• Discord — jako bot na serveru nebo v DM
• iMessage — na macOS
• Slack, Signal, Teams — a další platformy

Projekt vznikl koncem roku 2025 a rychle získal popularitu. GitHub repozitář má přes 8 000 hvězdiček a aktivní komunitu na Discordu.

Instalace

Vyžaduje Node.js verse 22 nebo vyšší:

# Instalace
npm install -g clawdbot@latest

# Onboarding a nastavení služby
clawdbot onboard --install-daemon

# Přihlášení k chat kanálům
clawdbot channels login

Příkaz onboard nastaví Clawdbot jako systémovou službu (daemon), která běží na pozadí. Na macOS, Linux i Windows (přes WSL2).

Alternativní instalace

Pro vývojáře je možná instalace ze zdrojových kódů:

git clone https://github.com/clawdbot/clawdbot
cd clawdbot
npm install
npm run build
npm link

Jak to funguje

Clawdbot používá architekturu s centrálním Gateway procesem:

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  WhatsApp   │────▶│             │────▶│   Claude    │
├─────────────┤     │   Gateway   │     ├─────────────┤
│  Telegram   │────▶│  WebSocket  │────▶│   OpenAI    │
├─────────────┤     │   Server    │     ├─────────────┤
│  Discord    │────▶│             │────▶│  Ollama     │
└─────────────┘     └─────────────┘     └─────────────┘

Gateway běží jako WebSocket server na ws://127.0.0.1:18789 a spojuje všechny komponenty — chat kanály, AI agenta (Pi), CLI nástroje a webové rozhraní.

Webové rozhraní

Po spuštění je dostupný WebChat na http://127.0.0.1:18789/ pro testování a ladění bez nutnosti připojovat messaging platformy.

Podporované AI modely

Clawdbot podporuje různé poskytovatele AI:

Poskytovatel	Modely	Poznámka
Anthropic	Claude Opus 4.5, Sonnet	Doporučeno pro dlouhý kontext
OpenAI	GPT-4o, o1	OAuth přihlášení
Ollama	Llama, Mistral, atd.	Plně lokální

Tvůrci doporučují Anthropic Claude Pro/Max s modelem Opus 4.5 pro nejlepší výsledky při práci s dlouhým kontextem.

Konfigurace

Nastavení se ukládá v ~/.clawdbot/clawdbot.json. Příklad omezení přístupu pouze na konkrétní číslo:

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+420123456789"],
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

Ve skupinových chatech lze nastavit, že bot reaguje pouze když je zmíněn (@Clawd).

Trvalá paměť

Jedna z klíčových funkcí — Clawdbot si pamatuje kontext napříč konversacemi. Paměť se ukládá jako Markdown soubory do složkové struktury podobné Obsidianu:

~/.clawdbot/
├── memory/
│   ├── user-preferences.md
│   ├── projects/
│   │   ├── web-app.md
│   │   └── api-design.md
│   └── contacts/
│       └── jan-novak.md
└── clawdbot.json

Agent si pamatuje vaše preference, rozpracované projekty i informace o lidech, se kterými pracujete.

Skills (dovednosti)

Clawdbot lze rozšiřovat pomocí skills — modulárních dovedností pro konkrétní služby:

• Gmail — čtení a odesílání e-mailů
• Google Calendar — správa událostí
• Notion — práce s databázemi a stránkami
• Spotify — ovládání přehrávání
• Philips Hue — kontrola osvětlení
• GitHub — issues, PR, repozitáře

Skills jsou dostupné na ClawdHub — komunitním katalogu rozšíření.

Vlastní skills

Můžete vytvářet vlastní dovednosti. Struktura je podobná Agent Skills specifikaci:

my-skill/
├── SKILL.md        # Instrukce pro agenta
├── scripts/        # Spustitelné skripty
└── config.json     # Konfigurace

Co Clawdbot umí

Práce se soubory

Agent má přístup k filesystému — může číst, vytvářet a upravovat soubory. Ve výchozím stavu běží v sandboxu s omezenými právy.

Webový prohlížeč

Vestavěný Chromium prohlížeč umožňuje:

• Procházet webové stránky
• Vyplňovat formuláře
• Extrahovat data (web scraping)
• Pořizovat screenshoty

Spouštění příkazů

Může spouštět shell příkazy a skripty. Hodí se pro automatisaci — spuštění buildů, testů, deploymentů.

Automatisace

Podporuje cron jobs, webhooky a Gmail Pub/Sub triggery pro automatické spouštění úloh.

Bezpečnostní risika

Clawdbot má plný přístup k vašemu systému. Může číst a mazat soubory, spouštět libovolné příkazy, přistupovat k internetu. V podstatě si dobrovolně instalujete software s právy, jaká má typický malware.

Co může Clawdbot udělat

• Smazat soubory — včetně důležitých dat
• Číst citlivé soubory — SSH klíče, konfigurace, hesla
• Spouštět příkazy — cokoliv, co můžete vy
• Přistupovat k síti — odesílat data kamkoliv
• Instalovat software — včetně dalších závislostí

Sandbox ve výchozím nastavení omezuje pouze skupinové chaty, ne hlavního agenta.

„Lokální” neznamená „soukromé”

Pokud používáte Claude nebo GPT, všechny vaše zprávy, soubory a kontext putují do cloudových API Anthropic nebo OpenAI. Poskytovatelé je mohou ukládat, analyzovat, používat pro trénink modelů.

Skutečně lokální je pouze varianta s Ollama — tam data nikam neodcházejí. Ale výkon lokálních modelů je výrazně nižší.

Risiko supply chain útoku

Instalujete npm balíček s plnými systémovými právy. Pokud by byl repozitář kompromitován nebo závislost obsahovala malware, máte problém. Totéž platí pro skills z komunitního katalogu.

Výchozí ochranné mechanismy

Projekt nabízí určitá omezení:

• DM pairing — neznámí odesílatelé musí zadat kód
• Whitelist — lze omezit na konkrétní čísla
• Sandbox pro skupiny — isolované prostředí pro skupinové chaty

Ale hlavní agent běží s plnými právy vašeho uživatelského účtu.

Jak minimalisovat risiko

Pokud chcete Clawdbot používat, zvažte tyto opatření:

• Separátní účty — založte si nový e-mail, GitHub, API klíče jen pro Clawdbot. Když agent něco pokazí nebo uniknou credentials, neohrozí to vaše hlavní účty.
• Isolované prostředí — spusťte na dedikovaném VPS nebo v Docker kontejneru, ne na počítači s citlivými daty.
• Pravidelné zálohy — agent může omylem smazat soubory. Mějte zálohy mimo jeho dosah (externí disk, cloud storage s read-only přístupem).
• Omezený přístup — nepřipojujte skills, které nepotřebujete. Každá integrace je další attack surface.
• Auditujte historii — pravidelně kontrolujte, co agent dělal. Logy jsou v ~/.clawdbot/logs/.

Přistupujte k tomu jako k novému projektu — čistý štít, separátní identity, minimální oprávnění.

Kde to spustit

V komunitě se objevil trend kupování Mac mini jako dedikovaného zařízení pro Clawdbot. Je to zbytečné.

Hardwarové nároky

Clawdbot je gateway napsaná v Node.js. Samotné AI výpočty probíhají v cloudu (Anthropic, OpenAI) nebo na separátním Ollama serveru. Gateway jen přeposílá zprávy.

Minimální požadavky:

• RAM — 512 MB (Node.js + Chromium pro browser skills)
• CPU — jakýkoliv, většinu času idle
• Disk — stovky MB pro aplikaci + paměť

Raspberry Pi 4 to zvládne. Mac mini za 15 000 Kč je overkill. Pro některé speciální úlohy (např. lokální Ollama s většími modely nebo náročnější browser automation) může být vyšší výkon potřeba, ale pro běžné použití s cloudovými API stačí minimum.

Levnější alternativy

Varianta	Cena	Poznámka
VPS (Hetzner, DigitalOcean)	~100 Kč/měsíc	Nejjednodušší, vždy online
Raspberry Pi	~2000 Kč jednorázově	Nízká spotřeba, tichý provoz
Starý notebook/PC	0 Kč	Využití existujícího hardware
Docker na NAS	0 Kč	Synology, QNAP — běží 24/7

Izolace pomocí Dockeru

Místo sandboxu v aplikaci můžete spustit celý Clawdbot v Docker kontejneru:

docker run -d \
  --name clawdbot \
  -v ~/.clawdbot:/root/.clawdbot \
  -p 18789:18789 \
  --restart unless-stopped \
  clawdbot/clawdbot

Kontejner izoluje aplikaci od hostitelského systému. I kdyby agent „zešílel”, nemůže smazat vaše soubory mimo namapovaný volume.

Podporované platformy

Platforma	Režim	Funkce
macOS	App + Node	Plná podpora včetně iMessage
Linux	Gateway	Server/headless provoz
Windows	WSL2	Přes Windows Subsystem for Linux
iOS	Node + Canvas	Mobilní přístup
Android	Node + Camera	Včetně přístupu ke kameře

Příklady použití

Několik scénářů, kde Clawdbot vyniká:

• Správa e-mailů — „Shrň mi nepřečtené e-maily a odpověz na urgentní”
• Kalendář — „Naplánuj meeting s Petrem na příští týden”
• Kódování — „Spusť testy a oprav failing cases”
• Domácnost — „Ztlum světla v obýváku na 50%”
• Research — „Najdi informace o tomto tématu a shrň je”

Výhodou je, že vše děláte z jedné chat aplikace, kterou už používáte.

Srovnání s alternativami

	Clawdbot	ChatGPT	Claude.ai
Běží lokálně	Ano	Ne	Ne
Chat integrace	WhatsApp, Telegram, atd.	Pouze web/app	Pouze web/app
Přístup k souborům	Plný (risiko)	Omezený	Omezený
Trvalá paměť	Ano (lokální)	Omezená	Projects
Open source	Ano (MIT)	Ne	Ne
Cena	Zdarma + API náklady	$20/měsíc	$20/měsíc

Shrnutí

• Clawdbot je open-source AI asistent běžící lokálně na vašem zařízení
• Komunikujete s ním přes WhatsApp, Telegram, Discord nebo jiné messengery
• Má trvalou paměť uloženou jako Markdown soubory
• Lze rozšiřovat pomocí skills pro Gmail, Notion, Spotify a další služby
• Bezpečnostní risiko — plný přístup k systému, data putují do cloudových API

Clawdbot je zajímavý projekt, ale vyžaduje důvěru. Dáváte AI agentovi práva, která byste nedali ani kolegovi. Zvažte, zda vám pohodlí stojí za risiko.

Odkazy

• clawd.bot — oficiální web
• GitHub — zdrojový kód
• Dokumentace
• ClawdHub — katalog skills