CLI commands
การสำรองข้อมูล
OmeniaClaw backup
สร้างไฟล์เก็บถาวรสำรองในเครื่องสำหรับสถานะ, การกำหนดค่า, โปรไฟล์การตรวจสอบสิทธิ์, ข้อมูลลับสำหรับช่องทาง/ผู้ให้บริการ, เซสชัน และพื้นที่ทำงานของ OmeniaClaw หากเลือกไว้
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หมายเหตุ
- ไฟล์เก็บถาวรมีไฟล์
manifest.jsonพร้อมพาธต้นทางที่แก้ไขแล้วและเค้าโครงไฟล์เก็บถาวร - เอาต์พุตเริ่มต้นคือไฟล์เก็บถาวร
.tar.gzที่มีเวลาประทับ อยู่ในไดเรกทอรีทำงานปัจจุบัน - หากไดเรกทอรีทำงานปัจจุบันอยู่ภายในแผนผังต้นทางที่ถูกสำรองข้อมูล OmeniaClaw จะใช้ไดเรกทอรีหลักของคุณเป็นตำแหน่งไฟล์เก็บถาวรเริ่มต้นแทน
- ไฟล์เก็บถาวรที่มีอยู่แล้วจะไม่ถูกเขียนทับเด็ดขาด
- พาธเอาต์พุตภายในแผนผังสถานะ/พื้นที่ทำงานต้นทางจะถูกปฏิเสธเพื่อหลีกเลี่ยงการรวมตัวเองเข้าไปด้วย
OmeniaClaw backup verify <archive>ตรวจสอบว่าไฟล์เก็บถาวรมี manifest ระดับรากเพียงไฟล์เดียว ปฏิเสธพาธไฟล์เก็บถาวรรูปแบบ traversal และตรวจสอบว่า payload ทุกอย่างที่ manifest ประกาศไว้มีอยู่ใน tarballOmeniaClaw backup create --verifyเรียกใช้การตรวจสอบนั้นทันทีหลังจากเขียนไฟล์เก็บถาวรOmeniaClaw backup create --only-configสำรองเฉพาะไฟล์กำหนดค่า JSON ที่ใช้งานอยู่
สิ่งที่ถูกสำรองข้อมูล
OmeniaClaw backup create วางแผนแหล่งข้อมูลสำรองจากการติดตั้ง OmeniaClaw ในเครื่องของคุณ:
- ไดเรกทอรีสถานะที่ตัวแก้ไขสถานะในเครื่องของ OmeniaClaw ส่งคืน โดยปกติคือ
~/.OmeniaClaw - พาธไฟล์กำหนดค่าที่ใช้งานอยู่
- ไดเรกทอรี
credentials/ที่แก้ไขแล้วเมื่อมีอยู่ภายนอกไดเรกทอรีสถานะ - ไดเรกทอรีพื้นที่ทำงานที่ค้นพบจากการกำหนดค่าปัจจุบัน เว้นแต่คุณจะส่ง
--no-include-workspace
โปรไฟล์การตรวจสอบสิทธิ์ของโมเดลเป็นส่วนหนึ่งของไดเรกทอรีสถานะอยู่แล้วภายใต้
agents/<agentId>/agent/auth-profiles.json ดังนั้นโดยปกติจึงครอบคลุมอยู่ในรายการสำรอง
สถานะ
หากคุณใช้ --only-config OmeniaClaw จะข้ามการค้นหาสถานะ ไดเรกทอรีข้อมูลลับ และพื้นที่ทำงาน แล้วเก็บถาวรเฉพาะพาธไฟล์กำหนดค่าที่ใช้งานอยู่
OmeniaClaw ทำให้พาธเป็นรูปแบบมาตรฐานก่อนสร้างไฟล์เก็บถาวร หากการกำหนดค่า ไดเรกทอรีข้อมูลลับ หรือพื้นที่ทำงานอยู่ภายในไดเรกทอรีสถานะอยู่แล้ว รายการเหล่านั้นจะไม่ถูกทำซ้ำเป็นแหล่งข้อมูลสำรองระดับบนสุดแยกต่างหาก พาธที่หายไปจะ ถูกข้าม
payload ของไฟล์เก็บถาวรจัดเก็บเนื้อหาไฟล์จากแผนผังต้นทางเหล่านั้น และ manifest.json ที่ฝังอยู่จะบันทึกพาธต้นทางแบบสัมบูรณ์ที่แก้ไขแล้ว พร้อมเค้าโครงไฟล์เก็บถาวรที่ใช้กับแต่ละ asset
ระหว่างการสร้างไฟล์เก็บถาวร OmeniaClaw จะข้ามไฟล์ที่ทราบว่าเปลี่ยนแปลงขณะใช้งานจริงและไม่มีคุณค่าต่อการกู้คืน รวมถึงทรานสคริปต์เซสชันของ agent ที่ใช้งานอยู่ บันทึกการรัน cron บันทึกแบบ rolling คิวการนำส่ง ไฟล์ socket/pid/temp ใต้ไดเรกทอรีสถานะ และไฟล์ temp ของ durable queue ที่เกี่ยวข้อง ผลลัพธ์ JSON มี skippedVolatileCount เพื่อให้ automation เห็นจำนวนไฟล์ที่ถูกละไว้โดยตั้งใจ
ไฟล์ซอร์สและ manifest ของ Plugin ที่ติดตั้งไว้ภายใต้แผนผัง
extensions/ ของไดเรกทอรีสถานะจะถูกรวมไว้ แต่แผนผัง dependency
node_modules/ ที่ซ้อนอยู่จะถูกข้าม dependency เหล่านั้นเป็น artifact การติดตั้งที่สร้างใหม่ได้ หลังจาก
กู้คืนไฟล์เก็บถาวร ให้ใช้ OmeniaClaw plugins update <id> หรือติดตั้ง Plugin ใหม่
ด้วย OmeniaClaw plugins install <spec> --force เมื่อ Plugin ที่กู้คืนรายงานว่า
dependency หายไป
ลักษณะการทำงานเมื่อการกำหนดค่าไม่ถูกต้อง
OmeniaClaw backup ตั้งใจข้าม preflight การกำหนดค่าตามปกติเพื่อให้ยังช่วยได้ในระหว่างการกู้คืน เนื่องจากการค้นหาพื้นที่ทำงานขึ้นอยู่กับการกำหนดค่าที่ถูกต้อง ตอนนี้ OmeniaClaw backup create จึงล้มเหลวทันทีเมื่อไฟล์กำหนดค่ามีอยู่แต่ไม่ถูกต้อง และการสำรองพื้นที่ทำงานยังเปิดใช้งานอยู่
หากคุณยังต้องการสำรองข้อมูลบางส่วนในสถานการณ์นั้น ให้รันใหม่:
OmeniaClaw backup create --no-include-workspaceการทำเช่นนี้จะยังรวมสถานะ การกำหนดค่า และไดเรกทอรีข้อมูลลับภายนอกไว้ในขอบเขต ขณะ ข้ามการค้นหาพื้นที่ทำงานทั้งหมด
หากคุณต้องการเพียงสำเนาของไฟล์กำหนดค่าเอง --only-config ก็ใช้ได้เช่นกันเมื่อการกำหนดค่ามีรูปแบบผิดพลาด เพราะตัวเลือกนี้ไม่ต้องพึ่งพาการแยกวิเคราะห์การกำหนดค่าสำหรับการค้นหาพื้นที่ทำงาน
ขนาดและประสิทธิภาพ
OmeniaClaw ไม่บังคับใช้ขนาดสำรองสูงสุดในตัวหรือขีดจำกัดขนาดต่อไฟล์
ขีดจำกัดในทางปฏิบัติมาจากเครื่องในเครื่องและระบบไฟล์ปลายทาง:
- พื้นที่ว่างสำหรับการเขียนไฟล์เก็บถาวรชั่วคราวและไฟล์เก็บถาวรสุดท้าย
- เวลาที่ใช้เดินแผนผังพื้นที่ทำงานขนาดใหญ่และบีบอัดเป็น
.tar.gz - เวลาที่ใช้สแกนไฟล์เก็บถาวรซ้ำหากคุณใช้
OmeniaClaw backup create --verifyหรือรันOmeniaClaw backup verify - ลักษณะการทำงานของระบบไฟล์ที่พาธปลายทาง OmeniaClaw จะเลือกขั้นตอนเผยแพร่แบบ hard link ที่ไม่เขียนทับก่อน และจะถอยกลับไปใช้การคัดลอกแบบ exclusive เมื่อไม่รองรับ hard link
พื้นที่ทำงานขนาดใหญ่มักเป็นปัจจัยหลักที่ทำให้ไฟล์เก็บถาวรมีขนาดใหญ่ หากคุณต้องการสำรองข้อมูลให้เล็กลงหรือเร็วขึ้น ให้ใช้ --no-include-workspace
สำหรับไฟล์เก็บถาวรที่เล็กที่สุด ให้ใช้ --only-config
