openclaw backup

สร้างไฟล์เก็บถาวรสำรองในเครื่องสำหรับสถานะ, การกำหนดค่า, โปรไฟล์ auth, ข้อมูลประจำตัวของช่องทาง/ผู้ให้บริการ, เซสชัน และ workspace ของ OpenClaw ตามตัวเลือก

openclaw backup createopenclaw backup create --output ~/Backupsopenclaw backup create --dry-run --jsonopenclaw backup create --verifyopenclaw backup create --no-include-workspaceopenclaw backup create --only-configopenclaw backup verify ./2026-03-09T08-00-00.000+08-00-openclaw-backup.tar.gz

หมายเหตุ

• ไฟล์เก็บถาวรมีไฟล์ manifest.json พร้อมพาธต้นทางที่ resolve แล้วและโครงร่างไฟล์เก็บถาวร
• เอาต์พุตเริ่มต้นคือไฟล์เก็บถาวร .tar.gz ที่มี timestamp ในไดเรกทอรีทำงานปัจจุบัน
• ชื่อไฟล์สำรองที่มี timestamp จะใช้ timezone ท้องถิ่นของเครื่องคุณและรวม UTC offset
• หากไดเรกทอรีทำงานปัจจุบันอยู่ภายใน source tree ที่ถูกสำรอง OpenClaw จะ fallback ไปใช้ไดเรกทอรี home ของคุณเป็นตำแหน่งไฟล์เก็บถาวรเริ่มต้น
• ไฟล์เก็บถาวรที่มีอยู่แล้วจะไม่ถูกเขียนทับ
• พาธเอาต์พุตภายใน source state/workspace tree จะถูกปฏิเสธเพื่อหลีกเลี่ยงการรวมตัวเองเข้าไปด้วย
• openclaw backup verify <archive> ตรวจสอบว่าไฟล์เก็บถาวรมี root manifest เพียงรายการเดียว ปฏิเสธพาธไฟล์เก็บถาวรแบบ traversal และตรวจสอบว่า payload ทุกตัวที่ประกาศใน manifest มีอยู่ใน tarball
• openclaw backup create --verify เรียกใช้การตรวจสอบนั้นทันทีหลังจากเขียนไฟล์เก็บถาวร
• openclaw backup create --only-config สำรองเฉพาะไฟล์การกำหนดค่า JSON ที่ใช้งานอยู่

สิ่งที่จะถูกสำรอง

openclaw backup create วางแผนแหล่งสำรองจากการติดตั้ง OpenClaw ในเครื่องของคุณ:

• ไดเรกทอรีสถานะที่ตัว resolve สถานะในเครื่องของ OpenClaw ส่งคืนมา โดยปกติคือ ~/.openclaw
• พาธไฟล์การกำหนดค่าที่ใช้งานอยู่
• ไดเรกทอรี credentials/ ที่ resolve แล้ว เมื่อมีอยู่ภายนอกไดเรกทอรีสถานะ
• ไดเรกทอรี workspace ที่ค้นพบจากการกำหนดค่าปัจจุบัน เว้นแต่คุณจะส่ง --no-include-workspace

โปรไฟล์ auth ของโมเดลเป็นส่วนหนึ่งของไดเรกทอรีสถานะอยู่แล้วภายใต้ agents/<agentId>/agent/auth-profiles.json ดังนั้นโดยปกติจึงครอบคลุมอยู่ใน รายการสำรองสถานะ

หากคุณใช้ --only-config OpenClaw จะข้ามสถานะ ไดเรกทอรีข้อมูลประจำตัว และการค้นพบ workspace แล้วเก็บถาวรเฉพาะพาธไฟล์การกำหนดค่าที่ใช้งานอยู่

OpenClaw จะ canonicalize พาธก่อนสร้างไฟล์เก็บถาวร หากการกำหนดค่า, ไดเรกทอรีข้อมูลประจำตัว หรือ workspace อยู่ภายในไดเรกทอรีสถานะอยู่แล้ว รายการเหล่านั้นจะไม่ถูกทำซ้ำเป็นแหล่งสำรองระดับบนสุดแยกต่างหาก พาธที่หายไปจะ ถูกข้าม

payload ของไฟล์เก็บถาวรจัดเก็บเนื้อหาไฟล์จาก source tree เหล่านั้น และ manifest.json ที่ฝังอยู่จะบันทึกพาธต้นทางแบบ absolute ที่ resolve แล้ว พร้อมโครงร่างไฟล์เก็บถาวรที่ใช้สำหรับ asset แต่ละรายการ

ระหว่างการสร้างไฟล์เก็บถาวร OpenClaw จะข้ามไฟล์ live-mutation ที่รู้จักซึ่งไม่มีคุณค่าต่อการกู้คืน รวมถึง transcript ของเซสชัน agent ที่ใช้งานอยู่, บันทึกการรัน cron, rolling log, คิวการส่ง, ไฟล์ socket/pid/temp ภายใต้ไดเรกทอรีสถานะ และไฟล์ temp ของ durable queue ที่เกี่ยวข้อง ผลลัพธ์ JSON มี skippedVolatileCount เพื่อให้ automation เห็นได้ว่ามีไฟล์กี่ไฟล์ที่ถูกละไว้โดยตั้งใจ

ซอร์สและไฟล์ manifest ของ Plugin ที่ติดตั้งไว้ภายใต้ tree extensions/ ของไดเรกทอรีสถานะจะถูกรวมไว้ด้วย แต่ tree dependency node_modules/ ที่ซ้อนอยู่จะถูกข้าม dependency เหล่านั้นเป็น artifact จากการติดตั้งที่สร้างใหม่ได้ หลังจากกู้คืนไฟล์เก็บถาวรแล้ว ให้ใช้ openclaw plugins update <id> หรือติดตั้ง Plugin ใหม่ด้วย openclaw plugins install <spec> --force เมื่อ Plugin ที่กู้คืนมารายงานว่า dependency หายไป

พฤติกรรมเมื่อการกำหนดค่าไม่ถูกต้อง

openclaw backup ตั้งใจข้าม config preflight ปกติเพื่อให้ยังช่วยได้ระหว่างการกู้คืน เนื่องจากการค้นพบ workspace ต้องอาศัยการกำหนดค่าที่ถูกต้อง ตอนนี้ openclaw backup create จึงล้มเหลวทันทีเมื่อไฟล์การกำหนดค่ามีอยู่แต่ไม่ถูกต้อง และการสำรอง workspace ยังเปิดใช้อยู่

หากคุณยังต้องการสำรองบางส่วนในสถานการณ์นั้น ให้รันใหม่:

openclaw backup create --no-include-workspace

การทำเช่นนี้จะยังคงรวมสถานะ การกำหนดค่า และไดเรกทอรีข้อมูลประจำตัวภายนอกไว้ในขอบเขต พร้อมข้ามการค้นพบ workspace ทั้งหมด

หากคุณต้องการเพียงสำเนาของไฟล์การกำหนดค่าเอง --only-config ก็ใช้งานได้เมื่อการกำหนดค่าผิดรูปแบบ เพราะไม่ได้พึ่งพาการ parse การกำหนดค่าเพื่อค้นพบ workspace

ขนาดและประสิทธิภาพ

OpenClaw ไม่บังคับใช้ขนาดสำรองสูงสุดในตัวหรือขีดจำกัดขนาดต่อไฟล์

ข้อจำกัดในทางปฏิบัติมาจากเครื่องในเครื่องและระบบไฟล์ปลายทาง:

• พื้นที่ว่างสำหรับการเขียนไฟล์เก็บถาวรชั่วคราวและไฟล์เก็บถาวรสุดท้าย
• เวลาที่ใช้เดิน tree workspace ขนาดใหญ่และบีบอัดเป็น .tar.gz
• เวลาที่ใช้สแกนไฟล์เก็บถาวรซ้ำ หากคุณใช้ openclaw backup create --verify หรือรัน openclaw backup verify
• พฤติกรรมของระบบไฟล์ที่พาธปลายทาง OpenClaw จะพยายามใช้ขั้นตอน publish แบบ hard link ที่ไม่เขียนทับก่อน และ fallback ไปใช้การคัดลอกแบบ exclusive เมื่อไม่รองรับ hard link

workspace ขนาดใหญ่มักเป็นปัจจัยหลักที่ทำให้ไฟล์เก็บถาวรมีขนาดใหญ่ หากคุณต้องการสำรองที่เล็กลงหรือเร็วขึ้น ให้ใช้ --no-include-workspace

สำหรับไฟล์เก็บถาวรที่เล็กที่สุด ให้ใช้ --only-config

ที่เกี่ยวข้อง

• เอกสารอ้างอิง CLI