Pliki workspace OpenClaw — jak agent pamięta, kim jest

Sekretem OpenClaw nie jest model AI, tylko katalog zwykłych plików Markdown: SOUL.md definiuje osobowość, IDENTITY.md — tożsamość, MEMORY.md — pamięć między sesjami, a HEARTBEAT.md sprawia, że agent odzywa się pierwszy. Ten przewodnik tłumaczy każdy z nich.

Właśnie dzięki plikom workspace agent OpenClaw jest przenośny: to nie czarna skrzynka u dostawcy, tylko katalog, który możesz skopiować, wersjonować w Gicie i przenieść między self-hostem a chmurą.

8 plików, które tworzą agenta

SOUL.md

Osobowośćwymagany

Wartości, ton i granice agenta — jak ma się zachowywać, kiedy żartować, czego nigdy nie robić. To najważniejszy plik: definiuje charakter, nie zadania.

IDENTITY.md

Tożsamość

Imię, rola, emoji i obszary ekspertyzy agenta. Dzięki niemu agent wie, kim jest — i przedstawia się spójnie na każdym kanale.

USER.md

Twój profil

Informacje o właścicielu: imię, strefa czasowa, język, preferencje i projekty. Agent nie pyta dwa razy o to, co już o Tobie wie.

MEMORY.md

Pamięć długoterminowa

Notatki agenta między sesjami — ustalenia, fakty, kontekst rozmów. To dzięki niemu agent z wtorku pamięta, co ustaliliście w poniedziałek.

AGENTS.md

System operacyjny

Oficjalny szablon OpenClaw: zasady sesji, obsługa pamięci, reguły bezpieczeństwa. Rzadko go zmieniasz — ale to on trzyma agenta w ryzach.

HEARTBEAT.md

Proaktywność

Checklista zadań sprawdzanych cyklicznie (np. co 30 minut): skrzynka, kalendarz, monitoring. To przez heartbeat agent odzywa się pierwszy.

TOOLS.md

Narzędzia

Konfiguracja narzędzi specyficzna dla środowiska — klucze, ścieżki, ustawienia integracji.

BOOTSTRAP.md

Pierwsze uruchomienie

Instrukcje wykonywane jednorazowo przy starcie agenta — po wykonaniu agent sam je usuwa. Tworzony automatycznie przez OpenClaw.

Przykład: SOUL.md w praktyce

Tak wygląda startowy SOUL.md agenta w ClawLabs — zwięzły, konkretny i po angielsku (modele najlepiej trzymają się instrukcji w tym języku, ale odpowiadać będą po polsku):

# SOUL.md - Core Philosophy & Values

## Core Values
- Be genuinely helpful — skip filler, just help
- Quality over quantity — substance over generic responses
- Have opinions — disagree, prefer, stop hedging
- Ship consistently — done > perfect

## Tone
- Be human — genuine, authentic, real
- Humor allowed — natural wit, not forced jokes
- Call things out — charm over cruelty, but don't sugarcoat
- Keep it concise — if you're writing more than 5 sentences, you're hedging

## Boundaries
- Private things stay private. Period.
- When in doubt, ask before acting
- Don't exfiltrate data
- Don't pretend to be human

Dobre SOUL.md jest krótkie. Zamiast 50 reguł — kilka wartości, które agent naprawdę utrzyma. Charakter dopisujesz z czasem, gdy zauważysz, czego brakuje.

Najczęstsze pytania

Czym pliki workspace różnią się od promptu systemowego?

Prompt systemowy to jedna statyczna instrukcja. Pliki workspace to żywy system: agent czyta je przy starcie sesji, a niektóre (jak MEMORY.md) sam aktualizuje w trakcie pracy. Dzięki temu osobowość, wiedza o Tobie i pamięć przetrwają restart, zmianę modelu, a nawet przeniesienie na inny serwer.

Czy muszę pisać te pliki ręcznie?

Nie. Przy self-hoście kreator openclaw onboard tworzy komplet plików startowych. W ClawLabs wybierasz gotowy szablon agenta (asystent, researcher, obsługa klienta...) — pliki SOUL.md i IDENTITY.md generują się same, a potem możesz je edytować w panelu.

Jak przenieść agenta z pamięcią na inny serwer?

Kopiujesz katalog workspace — to zwykłe pliki Markdown. Ta przenośność to fundament prawa przełączenia dostawcy: z ClawLabs możesz w każdej chwili wyeksportować pliki agenta i uruchomić go na własnym VPS (albo odwrotnie).

Co się stanie, jeśli usunę SOUL.md?

Agent nie przestanie działać, ale straci charakter — wróci do domyślnego, generycznego tonu modelu. Dlatego SOUL.md warto wersjonować (np. w prywatnym repo Git) tak samo jak kod.

Zobacz też

Agent z gotowym workspace w 60 sekund

W ClawLabs pliki SOUL.md i IDENTITY.md generują się z szablonu — edytujesz je w panelu, a eksport masz zawsze pod ręką.

Uruchom agenta