OpenClawDocs
Na tej stronie

Na tej stronie

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Agent workspace

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.

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:
json5
{  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.

Jeśli samodzielnie zarządzasz już plikami obszaru roboczego, możesz wyłączyć tworzenie plików startowych:

json5
{ 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.

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

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:

    bash
    cd ~/.openclaw/workspacegit initgit 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

    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:
    bash
    git branch -M maingit remote add origin <https-url>git push -u origin main

    GitHub CLI (gh)

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

    Interfejs webowy GitLab

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

  • Bieżące aktualizacje

    bash
    git statusgit add .git commit -m "Update memory"git push

    • Nie zatwierdzaj sekretów

    Sugerowany starter .gitignore:

    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
    Was this useful?