// dokumentacja openclaw

Przestrzeń robocza agenta — workspace w OpenClaw

Czym jest workspace agenta?

Przestrzeń robocza (workspace) pełni funkcję głównego katalogu pracy agenta oraz magazynu pamięci. Jest odrębna od katalogu konfiguracyjnego ~/.openclaw/. Domyślna lokalizacja to ~/.openclaw/workspace.

Ważne cechy workspace

  • Brak twardego sandboxa — ścieżki względne rozwiązywane są w obrębie workspace, ale ścieżki bezwzględne mogą wskazywać na inne lokalizacje, chyba że sandbox jest włączony.
  • Wsparcie profili — zmienna OPENCLAW_PROFILE tworzy warianty workspace, np. ~/.openclaw/workspace-<profile>.

Standardowe pliki workspace

Każdy workspace zawiera zestaw plików kontrolujących zachowanie agenta:

  • AGENTS.md — instrukcje operacyjne i wytyczne zachowania
  • SOUL.md — persona, ton i granice komunikacji
  • USER.md — tożsamość użytkownika i konwencje zwracania się
  • IDENTITY.md — nazwa agenta i emoji
  • TOOLS.md — lokalna dokumentacja narzędzi
  • HEARTBEAT.md — opcjonalna lista kontrolna dla zautomatyzowanych uruchomień
  • BOOT.md — opcjonalna lista startowa
  • BOOTSTRAP.md — jednorazowy rytuał inicjalizacyjny
  • memory/YYYY-MM-DD.md — dzienne dzienniki pamięci
  • MEMORY.md — długoterminowa, kuratorowana pamięć
  • skills/ — katalog umiejętności specyficznych dla workspace
  • canvas/ — pliki UI dla wyświetlaczy węzłów

Co nie trafia do workspace

Konfiguracja i dane wrażliwe rezydują w ~/.openclaw/ i nigdy nie powinny być commitowane do repozytorium:

  • Plik konfiguracyjny (openclaw.json)
  • Profile uwierzytelniania
  • Katalog poświadczeń
  • Transkrypty sesji
  • Zarządzane umiejętności

Backup przez Git

Zalecane jest utrzymywanie prywatnego repozytorium Git jako kopii zapasowej workspace:

  1. Zainicjalizuj repozytorium poleceniem git init w katalogu workspace.
  2. Dodaj remote przez GitHub CLI, interfejs web GitHub lub GitLab.
  3. Nigdy nie commituj sekretów, kluczy API ani poświadczeń.
  4. Używaj .gitignore do wykluczania wrażliwych plików.

Migracja workspace

Przeniesienie workspace na nową lokalizację wymaga kilku kroków:

  1. Sklonuj repozytorium do wybranej ścieżki.
  2. Zaktualizuj agents.defaults.workspace w konfiguracji.
  3. Uruchom setup, aby uzupełnić brakujące pliki.
  4. W razie potrzeby przenieś sesje osobno.
Wróc do dokumentacji