Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Obszar roboczy jest domem agenta. Jest jedynym katalogiem roboczym używanym przez narzędzia plikowe i kontekst obszaru roboczego. Zachowaj jego prywatność i traktuj go jak pamięć. Jest to niezależne od ~/.openclaw/, gdzie przechowywane są konfiguracja, poświadczenia i sesje.
Obszar roboczy to domyślne 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ć gdzie indziej na hoście, chyba że włączono piaskownicę. Jeśli potrzebujesz izolacji, użyj agents.defaults.sandbox (i/lub konfiguracji piaskownicy dla poszczególnych agentów).Gdy piaskownica jest włączona, 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 wartości "default", domyślna lokalizacja staje się ~/.openclaw/workspace-<profile>.
  • Nadpisanie w ~/.openclaw/openclaw.json:
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}
openclaw onboard, openclaw configure lub openclaw setup utworzą obszar roboczy i dodadzą początkowe pliki bootstrap, jeśli ich brakuje.
Kopie seed piaskownicy akceptują tylko zwykłe pliki wewnątrz obszaru roboczego; aliasy symlink/hardlink, które wskazują poza źródłowy obszar roboczy, są ignorowane.
Jeśli już samodzielnie zarządzasz plikami obszaru roboczego, możesz wyłączyć tworzenie plików bootstrap: 
{ agents: { defaults: { skipBootstrap: true } } }

​
Dodatkowe foldery obszaru roboczego

Starsze instalacje mogły utworzyć ~/openclaw. Przechowywanie wielu katalogów obszaru roboczego może powodować mylące rozjazdy 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 albo 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 używania pamięci. Ładowane na początku każdej sesji. Dobre miejsce na reguły, priorytety i szczegóły „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ę agenta, styl i emoji. Tworzone/aktualizowane podczas rytuału bootstrap.
Notatki o lokalnych narzędziach i konwencjach. Nie steruje dostępnością narzędzi; to tylko wskazówki.
Opcjonalna krótka lista kontrolna dla uruchomień Heartbeat. Zachowaj ją krótką, aby uniknąć zużycia tokenów.
Opcjonalna lista kontrolna startu uruchamiana automatycznie przy 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ń). Zalecane jest odczytanie dzisiejszego i wczorajszego dnia przy starcie sesji.
Utrzymana pamięć długoterminowa: trwałe fakty, preferencje, decyzje i krótkie podsumowania. Szczegółowe logi trzymaj w memory/YYYY-MM-DD.md, aby narzędzia pamięci mogły pobierać je 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ć workflow 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, dołączone Skills oraz skills.load.extraDirs, gdy nazwy kolidują.
Pliki interfejsu Canvas dla wyświetlaczy węzłów (na przykład canvas/index.html).
Jeśli brakuje dowolnego pliku bootstrap, OpenClaw wstrzykuje do sesji znacznik „brakujący plik” i kontynuuje. Duże pliki bootstrap są obcinane podczas wstrzykiwania; limity dostosujesz za pomocą agents.defaults.bootstrapMaxChars (domyślnie: 12000) 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ć commitowane do repozytorium obszaru roboczego:
  • ~/.openclaw/openclaw.json (konfiguracja)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (profile uwierzytelniania modelu: OAuth + klucze API)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (konto runtime Codex dla agenta, konfiguracja, Skills, plugins i natywny stan wątku)
  • ~/.openclaw/credentials/ (stan kanału/providera oraz starsze dane importu OAuth)
  • ~/.openclaw/agents/<agentId>/sessions/ (transkrypty sesji + metadane)
  • ~/.openclaw/skills/ (zarządzane Skills)
Jeśli musisz migrować sesje lub konfigurację, skopiuj je oddzielnie i trzymaj poza kontrolą wersji.

​
Kopia zapasowa w Git (zalecana, prywatna)

Traktuj obszar roboczy jak prywatną pamięć. Umieść go w prywatnym repozytorium git, aby był objęty kopią zapasową i możliwy do odzyskania. Uruchom te kroki na maszynie, na której działa Gateway (tam znajduje się obszar roboczy).
1

Zainicjalizuj repozytorium

Jeśli git jest zainstalowany, zupełnie nowe obszary robocze są inicjalizowane automatycznie. Jeśli ten obszar roboczy nie jest jeszcze repozytorium, 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 plikiem README (pozwala to uniknąć konfliktów 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 commituj sekretów

Nawet w prywatnym repozytorium unikaj przechowywania sekretów w obszarze roboczym:
  • Klucze API, tokeny OAuth, hasła lub prywatne poświadczenia.
  • Wszystko pod ~/.openclaw/.
  • Surowe zrzuty czatów lub poufne załączniki.
Jeśli musisz przechowywać poufne odniesienia, używaj 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 repozytorium

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

Zaktualizuj konfigurację

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

Uzupełnij brakujące pliki

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

Skopiuj sesje (opcjonalnie)

Jeśli potrzebujesz sesji, skopiuj oddzielnie ~/.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 agents.defaults.sandbox jest włączone, 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
  • Piaskownica - dostęp do obszaru roboczego w środowiskach piaskownicy
  • Sesja - ścieżki przechowywania sesji
  • Stałe polecenia - trwałe instrukcje w plikach obszaru roboczego