Czym jest Agent w OpenClaw?
OpenClaw uruchamia pojedynczy, wbudowany runtime agenta. Każdy agent operuje w ramach wyznaczonego katalogu roboczego (tzw. workspace), który stanowi jego główne środowisko pracy — to w nim przechowywane są narzędzia, kontekst i pamięć. Katalog workspace definiuje się za pomocą parametru agents.defaults.workspace.
Konfiguracja workspace
Workspace można zainicjalizować poleceniem openclaw setup, które tworzy plik konfiguracyjny ~/.openclaw/openclaw.json. Jeśli tryb sandbox jest włączony, sesje inne niż główna mogą korzystać z osobnych katalogów roboczych tworzonych pod ścieżką agents.defaults.sandbox.workspaceRoot.
Pliki bootstrap — wstrzykiwane przy pierwszym uruchomieniu
OpenClaw oczekuje zestawu edytowalnych plików w katalogu workspace. Pliki te są automatycznie wstrzykiwane do kontekstu agenta na początku każdej sesji:
- AGENTS.md — instrukcje operacyjne i wytyczne zachowania agenta
- SOUL.md — persona, ton komunikacji i granice
- TOOLS.md — notatki o narzędziach i konwencjach utrzymywane przez użytkownika
- BOOTSTRAP.md — jednorazowy rytuał inicjalizacyjny (usuwany po wykonaniu)
- IDENTITY.md — nazwa agenta, styl i emoji
- USER.md — profil użytkownika i preferowany sposób zwracania się
Duże pliki są automatycznie przycinane ze znacznikami obcięcia. Brakujące pliki generują linie zastępcze, a polecenie openclaw setup tworzy bezpieczne szablony domyślne. Tworzenie plików bootstrap można wyłączyć ustawieniem { agent: { skipBootstrap: true } }.
Wbudowane narzędzia i umiejętności
Podstawowe narzędzia — read, exec, edit, write — są zawsze dostępne. Narzędzie apply_patch jest opcjonalne i kontrolowane parametrem tools.exec.applyPatch. Umiejętności (skills) ładowane są z wielu lokalizacji w ustalonej kolejności priorytetów: workspace, umiejętności projektu agenta, osobiste umiejętności agenta, zarządzane/lokalne, wbudowane i dodatkowe katalogi.
Sesje i streaming
Transkrypty sesji przechowywane są w formacie JSONL w katalogu ~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl. Strumieniowanie bloków (block streaming) jest domyślnie wyłączone, ale można je skonfigurować parametrem agents.defaults.blockStreamingDefault.
Konfiguracja modeli
Referencje modeli używają formatu provider/model (np. openai/gpt-5.4). System próbuje dopasowania aliasów, następnie dopasowania specyficznego dla providera, z mechanizmem fallback dla usuniętych modeli.
Minimalna konfiguracja
Aby agent działał poprawnie, wymagane są co najmniej:
agents.defaults.workspace— ścieżka do katalogu roboczegochannels.whatsapp.allowFrom— silnie zalecane ze względów bezpieczeństwa