# openclaw backup

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

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

# หมายเหตุ

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

# สิ่งที่จะถูกสำรองข้อมูล

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

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

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

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

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

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

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

# พฤติกรรมเมื่อ config ไม่ถูกต้อง

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

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

openclaw backup create --no-include-workspace

วิธีนี้จะยังรวมสถานะ, config และไดเรกทอรีข้อมูลลับภายนอกไว้ในขอบเขต ขณะเดียวกัน ข้ามการค้นหา workspace ทั้งหมด

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

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

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

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

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

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

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

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

• ข้อมูลอ้างอิง CLI