English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Fundamentals

Obszar roboczy agenta

Obszar roboczy jest domem agenta. To jedyny katalog roboczy używany przez narzędzia plikowe i kontekst obszaru roboczego. Zachowaj jego prywatność i traktuj go jak pamięć.

Jest to oddzielne od ~/.openclaw/, które przechowuje konfigurację, dane uwierzytelniające i sesje.

Domyślna lokalizacja

  • Domyślnie: ~/.openclaw/workspace
  • Jeśli ustawiono OPENCLAW_PROFILE i nie ma wartości "default", domyślną lokalizacją staje się ~/.openclaw/workspace-<profile>.
  • Nadpisz w ~/.openclaw/openclaw.json:
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}

openclaw onboard, openclaw configure lub openclaw setup utworzy obszar roboczy i wypełni pliki startowe, jeśli ich brakuje.

Jeśli już samodzielnie zarządzasz 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 dryf 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 i sposób, w jaki powinien używać pamięci. Ładowane na początku każdej sesji. Dobre miejsce na reguły, priorytety i szczegóły dotyczące „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ę agenta, klimat i emoji. 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 tylko wskazówki.

HEARTBEAT.md - lista kontrolna Heartbeat

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

BOOT.md - lista kontrolna uruchamiania

Opcjonalna lista kontrolna uruchamiania wykonywana automatycznie po restarcie Gateway (gdy włączone są wewnętrzne haki). Zachowaj ją krótką; użyj narzędzia wiadomości do wysyłek wychodzących.

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ę przeczytać dziś + wczoraj przy starcie sesji.

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

Wyselekcjonowana pamięć długoterminowa. Ładuj 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ń Node (na przykład canvas/index.html).

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 środowiska uruchomieniowego Codex dla agenta, konfiguracja, Skills, Plugins i natywny stan wątku)
  • ~/.openclaw/credentials/ (stan kanału/dostawcy 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 Git (zalecana, prywatna)

Traktuj obszar roboczy jako 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).

  • Zainicjuj repozytorium

    Jeśli git jest zainstalowany, zupełnie nowe obszary robocze są inicjowane 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"

  • Dodaj prywatne zdalne repozytorium

    Interfejs webowy GitHub

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

    GitHub CLI (gh)

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

    Interfejs webowy GitLab

    1. Utwórz nowe prywatne repozytorium na GitLab.
    2. Nie inicjuj go plikiem README (unika konfliktów scalania).
    3. Skopiuj zdalny URL HTTPS.
    4. Dodaj zdalne repozytorium 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 commituj sekretów

    Sugerowany starter .gitignore:

    .DS_Store
.env
**/*.key
**/*.pem
**/secrets*

    Przenoszenie obszaru roboczego na nową maszynę

  • Sklonuj repozytorium

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

  • Zaktualizuj konfigurację

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

  • Uzupełnij brakujące pliki

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

  • Skopiuj sesje (opcjonalnie)

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

    • Uwagi zaawansowane

    • Routing wielu agentów może używać różnych obszarów roboczych dla każdego agenta. Zobacz Routing kanałów, aby poznać konfigurację routingu.
    • Jeśli agents.defaults.sandbox jest włączone, sesje niegłówne mogą używać obszarów roboczych piaskownicy dla sesji pod agents.defaults.sandbox.workspaceRoot.

    Powiązane