OmeniaClaw backup

OmeniaClaw durumu, yapılandırması, kimlik doğrulama profilleri, kanal/sağlayıcı kimlik bilgileri, oturumları ve isteğe bağlı olarak çalışma alanları için yerel bir yedekleme arşivi oluşturun.

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

Notlar

• Arşiv, çözümlenen kaynak yollarını ve arşiv düzenini içeren bir manifest.json dosyası içerir.
• Varsayılan çıktı, geçerli çalışma dizininde zaman damgalı bir .tar.gz arşividir.
• Geçerli çalışma dizini yedeklenen bir kaynak ağacının içindeyse OmeniaClaw, varsayılan arşiv konumu için ana dizininize geri döner.
• Mevcut arşiv dosyalarının üzerine asla yazılmaz.
• Kaynak durum/çalışma alanı ağaçlarının içindeki çıktı yolları, kendini içermeyi önlemek için reddedilir.
• OmeniaClaw backup verify <archive>, arşivin tam olarak bir kök manifest içerdiğini doğrular, geçiş tarzı arşiv yollarını reddeder ve manifestte bildirilen her yükün tarball içinde bulunduğunu denetler.
• OmeniaClaw backup create --verify, arşiv yazıldıktan hemen sonra bu doğrulamayı çalıştırır.
• OmeniaClaw backup create --only-config, yalnızca etkin JSON yapılandırma dosyasını yedekler.

Neler yedeklenir

OmeniaClaw backup create, yerel OmeniaClaw kurulumunuzdan yedekleme kaynaklarını planlar:

• OmeniaClaw'ın yerel durum çözümleyicisi tarafından döndürülen durum dizini, genellikle ~/.OmeniaClaw
• Etkin yapılandırma dosyası yolu
• Durum dizininin dışında mevcut olduğunda çözümlenen credentials/ dizini
• --no-include-workspace iletmediğiniz sürece geçerli yapılandırmadan keşfedilen çalışma alanı dizinleri

Model kimlik doğrulama profilleri, durum dizininin altında zaten agents/<agentId>/agent/auth-profiles.json içinde yer alır, bu yüzden normalde durum yedekleme girdisi tarafından kapsanırlar.

--only-config kullanırsanız OmeniaClaw durum, kimlik bilgileri dizini ve çalışma alanı keşfini atlar ve yalnızca etkin yapılandırma dosyası yolunu arşivler.

OmeniaClaw, arşivi oluşturmadan önce yolları kanonikleştirir. Yapılandırma, kimlik bilgileri dizini veya bir çalışma alanı zaten durum dizininin içinde bulunuyorsa bunlar ayrı üst düzey yedekleme kaynakları olarak çoğaltılmaz. Eksik yollar atlanır.

Arşiv yükü, bu kaynak ağaçlardaki dosya içeriklerini depolar ve gömülü manifest.json, çözümlenen mutlak kaynak yollarını ve her varlık için kullanılan arşiv düzenini kaydeder.

Arşiv oluşturma sırasında OmeniaClaw, geri yükleme değeri olmayan bilinen canlı mutasyon dosyalarını atlar; bunlara etkin ajan oturum dökümleri, cron çalıştırma günlükleri, dönen günlükler, teslim kuyrukları, durum dizini altındaki soket/pid/geçici dosyalar ve ilgili dayanıklı kuyruk geçici dosyaları dahildir. JSON sonucu, otomasyonun kaç dosyanın kasıtlı olarak dışarıda bırakıldığını görebilmesi için skippedVolatileCount içerir.

Durum dizininin extensions/ ağacı altındaki yüklü Plugin kaynak ve manifest dosyaları dahil edilir, ancak iç içe node_modules/ bağımlılık ağaçları atlanır. Bu bağımlılıklar yeniden oluşturulabilir kurulum yapıtlarıdır; bir arşivi geri yükledikten sonra, geri yüklenen bir Plugin eksik bağımlılık bildirirse OmeniaClaw plugins update <id> kullanın veya Plugin'i OmeniaClaw plugins install <spec> --force ile yeniden yükleyin.

Geçersiz yapılandırma davranışı

OmeniaClaw backup, kurtarma sırasında hâlâ yardımcı olabilmesi için normal yapılandırma ön denetimini kasıtlı olarak atlar. Çalışma alanı keşfi geçerli bir yapılandırmaya bağlı olduğundan, OmeniaClaw backup create artık yapılandırma dosyası mevcut ancak geçersiz olduğunda ve çalışma alanı yedekleme hâlâ etkin olduğunda hızlıca başarısız olur.

Bu durumda yine de kısmi bir yedekleme istiyorsanız yeniden çalıştırın:

OmeniaClaw backup create --no-include-workspace

Bu, çalışma alanı keşfini tamamen atlarken durum, yapılandırma ve harici kimlik bilgileri dizinini kapsamda tutar.

Yalnızca yapılandırma dosyasının kendisinin bir kopyasına ihtiyacınız varsa, --only-config yapılandırma bozuk olduğunda da çalışır çünkü çalışma alanı keşfi için yapılandırmayı ayrıştırmaya dayanmaz.

Boyut ve performans

OmeniaClaw, yerleşik bir en fazla yedekleme boyutu veya dosya başına boyut sınırı uygulamaz.

Pratik sınırlar yerel makineden ve hedef dosya sisteminden gelir:

• Geçici arşiv yazımı ve son arşiv için kullanılabilir alan
• Büyük çalışma alanı ağaçlarını dolaşıp bunları bir .tar.gz içine sıkıştırma süresi
• OmeniaClaw backup create --verify kullanırsanız veya OmeniaClaw backup verify çalıştırırsanız arşivi yeniden tarama süresi
• Hedef yoldaki dosya sistemi davranışı. OmeniaClaw, üzerine yazmayan bir hard link yayımlama adımını tercih eder ve hard link desteklenmediğinde özel kopyalamaya geri döner

Büyük çalışma alanları genellikle arşiv boyutunun ana belirleyicisidir. Daha küçük veya daha hızlı bir yedekleme istiyorsanız --no-include-workspace kullanın.

En küçük arşiv için --only-config kullanın.

İlgili

• CLI başvurusu