OmeniaClaw backup

Utwórz lokalne archiwum kopii zapasowej dla stanu OmeniaClaw, konfiguracji, profili uwierzytelniania, danych uwierzytelniających kanałów/dostawców, sesji oraz opcjonalnie obszarów roboczych.

OmeniaClaw backup createOmeniaClaw backup create --output ~/BackupsOmeniaClaw backup create --dry-run --jsonOmeniaClaw backup create --verifyOmeniaClaw backup create --no-include-workspaceOmeniaClaw backup create --only-configOmeniaClaw backup verify ./2026-03-09T00-00-00.000Z-OmeniaClaw-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ą, OmeniaClaw 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.
• OmeniaClaw 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.
• OmeniaClaw backup create --verify uruchamia tę walidację natychmiast po zapisaniu archiwum.
• OmeniaClaw backup create --only-config tworzy kopię zapasową tylko aktywnego pliku konfiguracji JSON.

Co jest obejmowane kopią zapasową

OmeniaClaw backup create planuje źródła kopii zapasowej z lokalnej instalacji OmeniaClaw:

• Katalog stanu zwracany przez lokalny resolver stanu OmeniaClaw, zwykle ~/.OmeniaClaw
• Ś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, OmeniaClaw pomija wykrywanie stanu, katalogu danych uwierzytelniających i obszaru roboczego oraz archiwizuje tylko ścieżkę aktywnego pliku konfiguracji.

OmeniaClaw 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 OmeniaClaw 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 OmeniaClaw plugins update <id> albo zainstaluj plugin ponownie za pomocą OmeniaClaw plugins install <spec> --force, gdy przywrócony plugin zgłasza brakujące zależności.

Zachowanie przy nieprawidłowej konfiguracji

OmeniaClaw backup celowo pomija normalny preflight konfiguracji, aby nadal mógł pomagać podczas odzyskiwania. Ponieważ wykrywanie obszarów roboczych zależy od prawidłowej konfiguracji, OmeniaClaw 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:

OmeniaClaw 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ść

OmeniaClaw 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 OmeniaClaw backup create --verify albo uruchamiasz OmeniaClaw backup verify
• Zachowanie systemu plików w ścieżce docelowej. OmeniaClaw 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

• Dokumentacja CLI