Przejdź do głównej treści
Obszar roboczy jest domem agenta. To jedyny katalog roboczy używany przez narzędzia plikowe oraz jako kontekst obszaru roboczego. Zachowaj jego prywatność i traktuj go jak pamięć. Jest on oddzielny od ~/.openclaw/, gdzie przechowywane są konfiguracja, dane uwierzytelniające i sesje.
Obszar roboczy to domyślny cwd, a nie twarda piaskownica. Narzędzia rozwiązują ścieżki względne względem obszaru roboczego, ale ścieżki bezwzględne nadal mogą sięgać innych miejsc na hoście, chyba że włączono sandboxing. Jeśli potrzebujesz izolacji, użyj agents.defaults.sandbox (i/lub konfiguracji piaskownicy dla konkretnego agenta).Gdy sandboxing jest włączony, a workspaceAccess nie ma wartości "rw", narzędzia działają w obszarze roboczym piaskownicy pod ~/.openclaw/sandboxes, a nie w obszarze roboczym hosta.

​
Domyślna lokalizacja

  • Domyślnie: ~/.openclaw/workspace
  • Jeśli ustawiono OPENCLAW_PROFILE i nie ma ono wartości "default", domyślna lokalizacja zmienia się na ~/.openclaw/workspace-<profile>.
  • Nadpisanie w ~/.openclaw/openclaw.json:
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}
openclaw onboard, openclaw configure lub openclaw setup utworzy obszar roboczy i wypełni go plikami startowymi, jeśli ich brakuje.
Kopie początkowe piaskownicy akceptują tylko zwykłe pliki znajdujące się w obszarze roboczym; aliasy symlink/hardlink, które rozwiązują się poza źródłowym obszarem roboczym, są ignorowane.
Jeśli samodzielnie zarządzasz już plikami obszaru roboczego, możesz wyłączyć tworzenie plików startowych: 
{ agents: { defaults: { skipBootstrap: true } } }

​
Dodatkowe foldery obszaru roboczego

Starsze instalacje mogły utworzyć ~/openclaw. Utrzymywanie wielu katalogów obszaru roboczego może powodować mylący rozjazd uwierzytelniania lub stanu, ponieważ w danym momencie aktywny jest tylko jeden obszar roboczy.
Zalecenie: utrzymuj jeden aktywny obszar roboczy. Jeśli nie używasz już dodatkowych folderów, zarchiwizuj je lub przenieś do kosza (na przykład trash ~/openclaw). Jeśli celowo utrzymujesz wiele obszarów roboczych, upewnij się, że agents.defaults.workspace wskazuje aktywny.openclaw doctor ostrzega, gdy wykryje dodatkowe katalogi obszaru roboczego.

​
Mapa plików obszaru roboczego

Oto standardowe pliki, których OpenClaw oczekuje w obszarze roboczym:
Instrukcje operacyjne dla agenta oraz sposób, w jaki ma używać pamięci. Ładowane na początku każdej sesji. Dobre miejsce na reguły, priorytety i szczegóły typu „jak się zachowywać”.
Persona, ton i granice. Ładowane w każdej sesji. Przewodnik: przewodnik osobowości SOUL.md.
Kim jest użytkownik i jak się do niego zwracać. Ładowane w każdej sesji.
Imię, klimat i emoji agenta. Tworzone/aktualizowane podczas rytuału startowego.
Notatki o lokalnych narzędziach i konwencjach. Nie kontroluje dostępności narzędzi; to wyłącznie wskazówki.
Opcjonalna krótka lista kontrolna dla uruchomień Heartbeat. Zachowaj ją krótką, aby unikać zużywania tokenów.
Opcjonalna lista kontrolna uruchamiania wykonywana automatycznie po restarcie Gateway (gdy włączone są wewnętrzne hooki). Zachowaj ją krótką; do wysyłek wychodzących używaj narzędzia wiadomości.
Jednorazowy rytuał pierwszego uruchomienia. Tworzony tylko dla zupełnie nowego obszaru roboczego. Usuń go po zakończeniu rytuału.
Dzienny dziennik pamięci (jeden plik na dzień). Zaleca się odczyt dzisiejszego i wczorajszego dnia przy starcie sesji.
Wyselekcjonowana pamięć długoterminowa: trwałe fakty, preferencje, decyzje i krótkie podsumowania. Szczegółowe dzienniki trzymaj w memory/YYYY-MM-DD.md, aby narzędzia pamięci mogły je pobierać na żądanie bez wstrzykiwania ich do każdego promptu. Ładuj MEMORY.md tylko w głównej, prywatnej sesji (nie w kontekstach współdzielonych/grupowych). Zobacz Pamięć, aby poznać przepływ pracy i automatyczne opróżnianie pamięci.
Skills specyficzne dla obszaru roboczego. Lokalizacja Skills o najwyższym priorytecie dla tego obszaru roboczego. Nadpisuje Skills agenta projektu, osobiste Skills agenta, zarządzane Skills, wbudowane Skills oraz skills.load.extraDirs, gdy nazwy kolidują.
Pliki interfejsu Canvas dla wyświetleń węzłów (na przykład canvas/index.html).
Jeśli brakuje któregokolwiek pliku startowego, OpenClaw wstrzykuje do sesji znacznik „brakujący plik” i kontynuuje. Duże pliki startowe są obcinane przy wstrzykiwaniu; dostosuj limity za pomocą agents.defaults.bootstrapMaxChars (domyślnie: 20000) i agents.defaults.bootstrapTotalMaxChars (domyślnie: 60000). openclaw setup może odtworzyć brakujące wartości domyślne bez nadpisywania istniejących plików.

​
Czego NIE ma w obszarze roboczym

Te elementy znajdują się pod ~/.openclaw/ i NIE powinny być zatwierdzane do repo obszaru roboczego:
  • ~/.openclaw/openclaw.json (konfiguracja)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (profile uwierzytelniania modeli: OAuth + klucze API)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (konto runtime Codex dla danego agenta, konfiguracja, Skills, pluginy i natywny stan wątków)
  • ~/.openclaw/credentials/ (stan kanałów/dostawców oraz dane importu starszego OAuth)
  • ~/.openclaw/agents/<agentId>/sessions/ (transkrypty sesji + metadane)
  • ~/.openclaw/skills/ (zarządzane Skills)
Jeśli musisz migrować sesje lub konfigurację, skopiuj je osobno i trzymaj poza kontrolą wersji.

​
Kopia zapasowa Git (zalecana, prywatna)

Traktuj obszar roboczy jak prywatną pamięć. Umieść go w prywatnym repo git, aby mieć kopię zapasową i możliwość odzyskania. Wykonaj te kroki na maszynie, na której działa Gateway (tam znajduje się obszar roboczy).
1

Zainicjalizuj repo

Jeśli git jest zainstalowany, zupełnie nowe obszary robocze są inicjalizowane automatycznie. Jeśli ten obszar roboczy nie jest jeszcze repo, uruchom:
cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
git commit -m "Add agent workspace"
2

Dodaj prywatny remote

  1. Utwórz nowe prywatne repozytorium na GitHub.
  2. Nie inicjalizuj go z README (zapobiega konfliktom scalania).
  3. Skopiuj zdalny URL HTTPS.
  4. Dodaj remote i wypchnij:
git branch -M main
git remote add origin <https-url>
git push -u origin main
3

Bieżące aktualizacje

git status
git add .
git commit -m "Update memory"
git push

​
Nie zatwierdzaj sekretów

Nawet w prywatnym repo unikaj przechowywania sekretów w obszarze roboczym:
  • Klucze API, tokeny OAuth, hasła lub prywatne dane uwierzytelniające.
  • Wszystko pod ~/.openclaw/.
  • Surowe zrzuty czatów lub wrażliwe załączniki.
Jeśli musisz przechowywać wrażliwe odwołania, użyj placeholderów i trzymaj prawdziwy sekret gdzie indziej (menedżer haseł, zmienne środowiskowe lub ~/.openclaw/).
Sugerowany starter .gitignore: 
.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

​
Przenoszenie obszaru roboczego na nową maszynę

1

Sklonuj repo

Sklonuj repo do wybranej ścieżki (domyślnie ~/.openclaw/workspace).
2

Zaktualizuj konfigurację

Ustaw agents.defaults.workspace na tę ścieżkę w ~/.openclaw/openclaw.json.
3

Wypełnij brakujące pliki

Uruchom openclaw setup --workspace <path>, aby utworzyć brakujące pliki.
4

Skopiuj sesje (opcjonalnie)

Jeśli potrzebujesz sesji, skopiuj osobno ~/.openclaw/agents/<agentId>/sessions/ ze starej maszyny.

​
Uwagi zaawansowane

  • Routing wielu agentów może używać różnych obszarów roboczych dla poszczególnych agentów. Zobacz Routing kanałów, aby poznać konfigurację routingu.
  • Jeśli włączono agents.defaults.sandbox, sesje inne niż główna mogą używać obszarów roboczych piaskownicy dla sesji pod agents.defaults.sandbox.workspaceRoot.

​
Powiązane

  • Heartbeat - plik obszaru roboczego HEARTBEAT.md
  • Sandboxing - dostęp do obszaru roboczego w środowiskach piaskownicy
  • Sesja - ścieżki przechowywania sesji
  • Stałe polecenia - trwałe instrukcje w plikach obszaru roboczego