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.

​
openclaw backup

Utwórz lokalne archiwum kopii zapasowej dla stanu OpenClaw, konfiguracji, profili uwierzytelniania, danych uwierzytelniających kanałów/dostawców, sesji oraz opcjonalnie obszarów roboczych. 
openclaw backup create
openclaw backup create --output ~/Backups
openclaw backup create --dry-run --json
openclaw backup create --verify
openclaw backup create --no-include-workspace
openclaw backup create --only-config
openclaw backup verify ./2026-03-09T00-00-00.000Z-openclaw-backup.tar.gz

​
Uwagi

  • Archiwum zawiera plik manifest.json z rozpoznanymi ścieżkami źródłowymi i układem archiwum.
  • Domyślnym wyjściem jest archiwum .tar.gz ze znacznikiem czasu w bieżącym katalogu roboczym.
  • Jeśli bieżący katalog roboczy znajduje się wewnątrz drzewa źródłowego objętego kopią zapasową, OpenClaw używa katalogu domowego jako domyślnej lokalizacji archiwum.
  • Istniejące pliki archiwów nigdy nie są nadpisywane.
  • Ścieżki wyjściowe wewnątrz drzew stanu źródłowego/obszaru roboczego są odrzucane, aby uniknąć samowłączenia.
  • openclaw backup verify <archive> sprawdza, czy archiwum zawiera dokładnie jeden główny manifest, odrzuca ścieżki archiwum w stylu przechodzenia po katalogach i sprawdza, czy każdy zadeklarowany w manifeście ładunek istnieje w tarballu.
  • openclaw backup create --verify uruchamia tę walidację natychmiast po zapisaniu archiwum.
  • openclaw backup create --only-config tworzy kopię zapasową tylko aktywnego pliku konfiguracji JSON.

​
Co jest obejmowane kopią zapasową

openclaw backup create planuje źródła kopii zapasowej z lokalnej instalacji OpenClaw:
  • Katalog stanu zwracany przez lokalny resolver stanu OpenClaw, zwykle ~/.openclaw
  • Ścieżka aktywnego pliku konfiguracji
  • Rozpoznany katalog credentials/, gdy istnieje poza katalogiem stanu
  • Katalogi obszarów roboczych odkryte z bieżącej konfiguracji, chyba że przekażesz --no-include-workspace
Profile uwierzytelniania modeli są już częścią katalogu stanu pod agents/<agentId>/agent/auth-profiles.json, więc zwykle są objęte wpisem kopii zapasowej stanu. Jeśli użyjesz --only-config, OpenClaw pomija wykrywanie stanu, katalogu danych uwierzytelniających i obszaru roboczego oraz archiwizuje tylko ścieżkę aktywnego pliku konfiguracji. OpenClaw kanonikalizuje ścieżki przed zbudowaniem archiwum. Jeśli konfiguracja, katalog danych uwierzytelniających lub obszar roboczy już znajdują się w katalogu stanu, nie są duplikowane jako osobne źródła kopii zapasowej najwyższego poziomu. Brakujące ścieżki są pomijane. Ładunek archiwum przechowuje zawartość plików z tych drzew źródłowych, a osadzony manifest.json zapisuje rozpoznane bezwzględne ścieżki źródłowe oraz układ archiwum użyty dla każdego zasobu. Podczas tworzenia archiwum OpenClaw pomija znane pliki modyfikowane na żywo, które nie mają wartości przy przywracaniu, w tym aktywne transkrypty sesji agentów, logi uruchomień Cron, logi rotacyjne, kolejki dostarczania, pliki socket/pid/temp w katalogu stanu oraz powiązane pliki tymczasowe trwałych kolejek. Wynik JSON zawiera skippedVolatileCount, aby automatyzacja mogła zobaczyć, ile plików celowo pominięto. Zainstalowane pliki źródłowe i manifesty pluginów pod drzewem extensions/ w katalogu stanu są uwzględniane, ale ich zagnieżdżone drzewa zależności node_modules/ są pomijane. Te zależności są odtwarzalnymi artefaktami instalacji; po przywróceniu archiwum użyj openclaw plugins update <id> albo zainstaluj plugin ponownie za pomocą openclaw plugins install <spec> --force, gdy przywrócony plugin zgłasza brakujące zależności.

​
Zachowanie przy nieprawidłowej konfiguracji

openclaw backup celowo pomija normalny preflight konfiguracji, aby nadal mógł pomagać podczas odzyskiwania. Ponieważ wykrywanie obszarów roboczych zależy od prawidłowej konfiguracji, openclaw backup create teraz szybko kończy się niepowodzeniem, gdy plik konfiguracji istnieje, ale jest nieprawidłowy, a kopia zapasowa obszaru roboczego jest nadal włączona. Jeśli nadal chcesz w tej sytuacji częściową kopię zapasową, uruchom ponownie: 
openclaw backup create --no-include-workspace
To pozostawia w zakresie stan, konfigurację i zewnętrzny katalog danych uwierzytelniających, jednocześnie całkowicie pomijając wykrywanie obszarów roboczych. Jeśli potrzebujesz tylko kopii samego pliku konfiguracji, --only-config działa również wtedy, gdy konfiguracja jest zniekształcona, ponieważ nie polega na parsowaniu konfiguracji w celu wykrywania obszarów roboczych.

​
Rozmiar i wydajność

OpenClaw nie wymusza wbudowanego maksymalnego rozmiaru kopii zapasowej ani limitu rozmiaru pojedynczego pliku. Praktyczne limity wynikają z lokalnej maszyny i docelowego systemu plików:
  • Dostępne miejsce na tymczasowy zapis archiwum oraz końcowe archiwum
  • Czas potrzebny na przejście dużych drzew obszarów roboczych i skompresowanie ich do .tar.gz
  • Czas potrzebny na ponowne przeskanowanie archiwum, jeśli używasz openclaw backup create --verify albo uruchamiasz openclaw backup verify
  • Zachowanie systemu plików w ścieżce docelowej. OpenClaw preferuje etap publikacji bez nadpisywania przez dowiązanie twarde i przechodzi na wyłączną kopię, gdy dowiązania twarde nie są obsługiwane
Duże obszary robocze są zwykle głównym czynnikiem wpływającym na rozmiar archiwum. Jeśli chcesz mniejszą lub szybszą kopię zapasową, użyj --no-include-workspace. Dla najmniejszego archiwum użyj --only-config.

​
Powiązane