Obszar roboczy agenta

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:

AGENTS.md - instrukcje operacyjne

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ć”.

SOUL.md - persona i ton

Persona, ton i granice. Ładowane w każdej sesji. Przewodnik: przewodnik osobowości SOUL.md.

USER.md - kim jest użytkownik

Kim jest użytkownik i jak się do niego zwracać. Ładowane w każdej sesji.

IDENTITY.md - imię, klimat, emoji

Imię, klimat i emoji agenta. Tworzone/aktualizowane podczas rytuału startowego.

TOOLS.md - lokalne konwencje narzędzi

Notatki o lokalnych narzędziach i konwencjach. Nie kontroluje dostępności narzędzi; to wyłącznie wskazówki.

HEARTBEAT.md - lista kontrolna Heartbeat

Opcjonalna krótka lista kontrolna dla uruchomień Heartbeat. Zachowaj ją krótką, aby unikać zużywania tokenów.

BOOT.md - lista kontrolna uruchamiania

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.

BOOTSTRAP.md - rytuał pierwszego uruchomienia

Jednorazowy rytuał pierwszego uruchomienia. Tworzony tylko dla zupełnie nowego obszaru roboczego. Usuń go po zakończeniu rytuału.

memory/YYYY-MM-DD.md - dzienny dziennik pamięci

Dzienny dziennik pamięci (jeden plik na dzień). Zaleca się odczyt dzisiejszego i wczorajszego dnia przy starcie sesji.

MEMORY.md - wyselekcjonowana pamięć długoterminowa (opcjonalnie)

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/ - Skills obszaru roboczego (opcjonalnie)

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ą.

canvas/ - pliki interfejsu Canvas (opcjonalnie)

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).

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"

Dodaj prywatny remote

Interfejs webowy GitHub
GitHub CLI (gh)
Interfejs webowy GitLab

Utwórz nowe prywatne repozytorium na GitHub.
Nie inicjalizuj go z README (zapobiega konfliktom scalania).
Skopiuj zdalny URL HTTPS.
Dodaj remote i wypchnij:

git branch -M main
git remote add origin <https-url>
git push -u origin main

gh auth login
gh repo create openclaw-workspace --private --source . --remote origin --push

Utwórz nowe prywatne repozytorium na GitLab.
Nie inicjalizuj go z README (zapobiega konfliktom scalania).
Skopiuj zdalny URL HTTPS.
Dodaj remote i wypchnij:

git branch -M main
git remote add origin <https-url>
git push -u origin main

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ę

Sklonuj repo

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

Zaktualizuj konfigurację

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

Wypełnij brakujące pliki

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

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

Fundamentals

Sessions and memory

Multi-agent

Messages and delivery

Obszar roboczy agenta

Domyślna lokalizacja

Dodatkowe foldery obszaru roboczego

Mapa plików obszaru roboczego

Czego NIE ma w obszarze roboczym

Kopia zapasowa Git (zalecana, prywatna)

Nie zatwierdzaj sekretów

Przenoszenie obszaru roboczego na nową maszynę

Uwagi zaawansowane

Powiązane

​Domyślna lokalizacja

​Dodatkowe foldery obszaru roboczego

​Mapa plików obszaru roboczego

​Czego NIE ma w obszarze roboczym

​Kopia zapasowa Git (zalecana, prywatna)

​Nie zatwierdzaj sekretów

​Przenoszenie obszaru roboczego na nową maszynę

​Uwagi zaawansowane

​Powiązane

Domyślna lokalizacja

Dodatkowe foldery obszaru roboczego

Mapa plików obszaru roboczego

Czego NIE ma w obszarze roboczym

Kopia zapasowa Git (zalecana, prywatna)

Nie zatwierdzaj sekretów

Przenoszenie obszaru roboczego na nową maszynę

Uwagi zaawansowane

Powiązane