OpenClaw je agentní framework, který bere „paměť“ doslova. Místo slibů o tom, že si model něco zapamatuje, staví na tom, co je auditovatelné a přenositelné na souborech v jednom adresáři.
Tomuhle adresáři říká „Workspace“. Je to „domov“ agenta. Jediný pracovní adresář pro file nástroje a zároveň hlavní zdroj kontextu, který agent používá napříč seancemi. Workspace je oddělený od ~/.openclaw/. Zdroj.
Jak funguje paměť v OpenClaw
OpenClaw má vždy krátkodobý kontext (aktuální session/konverzaci) a k tomu pracuje s pamětí na disku – typicky jako čitelné Markdown soubory ve workspace. Nad těmito soubory může běžet odvozená vyhledávací vrstva (indexy pro rychlé/sémantické hledání; embeddings mohou být ukládány v SQLite přes sqlite-vec), ale „zdroj pravdy“, který otevřete v editoru, zůstávají Markdown soubory. Zdroj
1) Krátkodobá paměť (session kontext)
To je to, co si model „nese“ v rámci aktuální session: poslední zprávy, aktuální úkol, rozpracované kroky. Když se kontext blíží limitům, OpenClaw používá compaction a může před ní spustit tichý „memory flush“ turn. Zdroj
2) Čitelná dlouhodobá paměť (Markdown)
Pro „věci, co se vyplatí pamatovat“ se používá MEMORY.md (trvalejší fakta, preference, rozhodnutí) a denní/záznamová vrstva v memory/ (např. memory/YYYY-MM-DD.md). Tyhle soubory jsou přímo editovatelné a dají se verzovat. Zdroj
3) Profil uživatele (Markdown)
USER.md je místo pro informace o vás: jak vás oslovovat, časové pásmo, preference a pracovní kontext. Dokumentace ho pojímá jako průběžně udržovaný soubor („update as you go“) a v praxi je dobré mít pravidla pro jeho doplňování explicitně v instrukcích agenta (např. v AGENTS.md). Zdroj
Workspace: místo, odkud OpenClaw načítá kontext
V OpenClaw je agent definovaný primárně svým workspace – adresářem, který slouží jako jediný pracovní adresář pro file nástroje a jako hlavní zdroj kontextu („paměť na disku“). Výchozí umístění bývá ~/.openclaw/workspace, ale workspace není totéž co ~/.openclaw/: ~/.openclaw/ typicky obsahuje konfiguraci, credentialy a sessions, zatímco workspace je „domov“ agenta.
Co tedy ve workspace tvoří perzistentní paměť agenta?
Základní soubory, které OpenClaw umí očekávat a řídí se podle nich:
- AGENTS.md – hlavní provozní instrukce pro agenta (jak pracovat, priority, pravidla chování); načítá se na začátku každé session.
- SOUL.md – persona, tón komunikace a hranice; načítá se v každé session.
- USER.md – informace o uživateli a jak ho oslovovat; načítá se v každé session.
- IDENTITY.md – jméno/vibe agenta; typicky se vytvoří nebo upraví během bootstrap rituálu.
- TOOLS.md – poznámky ke lokálním nástrojům a konvencím (slouží jako vodítko; neřídí dostupnost nástrojů).
Volitelné soubory a vrstvy podle toho, jak agenta používáte:
- HEARTBEAT.md – krátký checklist pro „heartbeat“ běhy (periodické proaktivní kontroly); držte ho krátký, aby nespaloval tokeny.
- BOOT.md – volitelný startup checklist spouštěný při restartu gateway (pokud jsou zapnuté interní hooky).
- BOOTSTRAP.md – jednorázový first-run rituál pro zcela nový workspace; po dokončení se má smazat.
- memory/YYYY-MM-DD.md – denní paměťový log (jeden soubor na den).
- MEMORY.md – kurátorovaná dlouhodobá paměť (volitelné; typicky se načítá jen v hlavní „privátní“ session, ne v kontextech sdílených skupin).
Základní soubory
AGENTS.md– hlavní provozní instrukce („manuál“), jak agent pracuje: priority, způsob odpovídání, pravidla chování a pracovní postupy. Je běžné, že různí agenti mají různáAGENTS.md(jiný styl práce), i když sdílí stejný tón/personu.SOUL.md– persona: tón komunikace, hodnoty, hranice a „kdo agent je“. Prakticky se často sdílí napříč více agenty (např. kopírováním stejného souboru), aby měli konzistentní styl, ale je to doporučený postup, ne povinná vlastnost systému.TOOLS.md– vaše „cheat sheet“ poznámky k nástrojům a infrastruktuře: lokální konvence, přístupy, názvy zařízení, SSH detaily, workflow poznámky. Slouží jako vodítko pro agenta, ale samo o sobě nezapíná/vypíná nástroje (to se řeší konfigurací OpenClaw).IDENTITY.md– identita agenta (jméno, vibe, emoji, avatar apod.). Dokumentace to rámuje jako soubor, který se vyplňuje při prvních interakcích a pomáhá ukotvit „kdo agent je“.USER.md– profil uživatele: jak vás oslovovat, časové pásmo, poznámky a kontext. Dokumentace přímo říká „Update this as you go“ – tedy že se má průběžně doplňovat, ale v praxi je to chování, které vychází z instrukcí a nastavení (není to automatická garance bez pravidel).MEMORY.md– kurátorovaná dlouhodobá paměť (pokud ji používáte). Vedle toho OpenClaw často pracuje i s denními logy v adresářimemory/(např.memory/YYYY-MM-DD.md), které slouží jako „časová stopa“ toho, co se řešilo.
Volitelné soubory a běhy
HEARTBEAT.md– checklist pro periodické „heartbeat“ běhy (pravidelné kontroly). Co má agent opakovaně kontrolovat nebo hlásit. Heartbeat běží v intervalu daném konfigurací a může být vypnut; pokud jeHEARTBEAT.mdefektivně prázdný, OpenClaw může heartbeat run přeskočit kvůli úspoře volání.BOOTSTRAP.md– jednorázový „first-run“ rituál pro novou workspace. Typicky pomůže nastavit základní identitu a pravidla; po dokončení se má odstranit / přestat používat, protože už splnil účel.BOOT.md– (volitelné) krátké instrukce, co dělat při startu gateway (vyžaduje zapnuté interní hooky). Pokud má něco poslat ven, má skončitNO_REPLY.
Další běžné složky ve workspace
avatars/(nebo podobně) – volitelná složka pro obrázky, které odkazujete zIDENTITY.md(dokumentace doporučuje workspace-relativní cestu pro avatar).hooks/– volitelná složka pro workspace-scoped hooky (pokud je používáte). Hooky umožňují automatizace a zásahy do běhů (např. bootstrap, start apod.).skills/(pokud používáte lokální skills) – místo, kde můžete držet vlastní/privátní skills; konkrétní struktura záleží na vašem setupu.
FAQ o paměti, autonomii a skills v OpenClaw
Praktické odpovědi pro správné nastavení workspace, paměti, automatizací a rozšíření schopností agenta
USER.md je profil uživatele: oslovení, časové pásmo, preference a kontext práce. Dokumentace ho pojímá jako soubor, který se má „průběžně aktualizovat“.
MEMORY.md je kurátorovaná dlouhodobá paměť: stabilní fakta, důležitá rozhodnutí a věci, které se vyplatí uchovat napříč úkoly.
memory/ typicky obsahuje denní logy (např. memory/2026-03-05.md). Je to „časová stopa“ toho, co se řešilo – užitečná pro dohledávání kontextu a kontinuitu práce.
Na rozdíl od MEMORY.md je to víc „deník“ než kurátorovaný souhrn.
Kanonická paměť je v Markdown souborech (čitelné a editovatelné). Nad nimi může běžet odvozená vyhledávací vrstva pro rychlé/sémantické hledání (např. indexy a embeddings), ale „zdroj pravdy“ zůstává v souborech.
Ano – OpenClaw může používat vektorový index pro sémantické vyhledávání nad pamětí. Důležité je, že jde o pomocnou vrstvu nad soubory, nikoli o náhradu čitelných Markdown pamětí.
Heartbeat jsou periodické „kontrolní“ běhy v hlavní session, řízené checklistem v HEARTBEAT.md. Hodí se na průběžné monitorování bez nutnosti psát prompt.
Cron je lepší pro úlohy v přesný čas (např. report každý den v 9:00).
Dokumentace uvádí výchozí cadence Heartbeat 30 minut (nebo 1 hodinu u Anthropic OAuth/setup-token). Interval si můžete změnit (nastavit vlastní cadence) nebo Heartbeat úplně vypnout.
Cron je lepší, když potřebujete úlohu v přesný čas (například denní report v 9:00). Heartbeat je vhodný pro průběžné kontroly podle checklistu v HEARTBEAT.md.
Skill je rozšíření schopností agenta. Typicky jde o adresář, jehož hlavním vstupem je SKILL.md s YAML front matter. Skill může obsahovat i skripty a další assets.
ClawHub je registry/marketplace pro objevování a správu skills. Pomáhá najít existující skills, prohlédnout jejich metadata a dostat je do prostředí, aby je agent mohl používat.
Workspace je výchozí pracovní adresář (CWD) pro file nástroje. Relativní cesty se řeší vůči němu, ale workspace není automaticky sandbox. Pokud nejsou zapnutá omezení, absolutní cesty mohou vést i mimo workspace.
Závěr
OpenClaw staví „chytrého“ agenta na jednoduchém, kontrolovatelném základu: workspace jako domov a paměť jako čitelné soubory. Krátkodobě agent pracuje se session kontextem, dlouhodobě si udržuje kontinuitu přes USER.md, MEMORY.md a denní logy v memory/, které můžete kdykoli otevřít, upravit i verzovat. Nad tím přidáte „reálné schopnosti“ pomocí skills a automatizace přes heartbeat nebo cron podle toho, jestli potřebujete průběžné kontroly, nebo úlohy na přesný čas. Výsledek je agent, který se dá škálovat (modely/provideři), zpřístupnit napříč kanály a hlavně: jeho paměť a chování nejsou zamčené v black boxu, ale zůstávají transparentní a spravovatelné.
Zdroje a dokumentace
- docs.openclaw.ai (Setup)
- docs.openclaw.ai (Agent Workspace)
- docs.openclaw.ai (AGENTS.md)
- docs.openclaw.ai (SOUL.md)
- docs.openclaw.ai (TOOLS.md)
- docs.openclaw.ai (IDENTITY.md)
- docs.openclaw.ai (USER.md)
- docs.openclaw.ai (Heartbeat)
- docs.openclaw.ai (BOOTSTRAP.md)
- docs.openclaw.ai (BOOT.md)
- docs.openclaw.ai (Default AGENTS)
- Video „OpenClaw Full Tutorial for Beginners: How to Setup Your First AI Agent (ClawdBot)“ Bart Slodyczka
