Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw backup

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

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

openclaw backup create วางแผนแหล่งข้อมูลสำรองจากการติดตั้ง OpenClaw ในเครื่องของคุณ:
  • ไดเรกทอรีสถานะที่ตัวแก้ไขสถานะในเครื่องของ OpenClaw ส่งคืน โดยปกติคือ ~/.openclaw
  • พาธไฟล์กำหนดค่าที่ใช้งานอยู่
  • ไดเรกทอรี credentials/ ที่แก้ไขแล้วเมื่อมีอยู่ภายนอกไดเรกทอรีสถานะ
  • ไดเรกทอรีพื้นที่ทำงานที่ค้นพบจากการกำหนดค่าปัจจุบัน เว้นแต่คุณจะส่ง --no-include-workspace
โปรไฟล์การตรวจสอบสิทธิ์ของโมเดลเป็นส่วนหนึ่งของไดเรกทอรีสถานะอยู่แล้วภายใต้ agents/<agentId>/agent/auth-profiles.json ดังนั้นโดยปกติจึงครอบคลุมอยู่ในรายการสำรอง สถานะ หากคุณใช้ --only-config OpenClaw จะข้ามการค้นหาสถานะ ไดเรกทอรีข้อมูลลับ และพื้นที่ทำงาน แล้วเก็บถาวรเฉพาะพาธไฟล์กำหนดค่าที่ใช้งานอยู่ OpenClaw ทำให้พาธเป็นรูปแบบมาตรฐานก่อนสร้างไฟล์เก็บถาวร หากการกำหนดค่า ไดเรกทอรีข้อมูลลับ หรือพื้นที่ทำงานอยู่ภายในไดเรกทอรีสถานะอยู่แล้ว รายการเหล่านั้นจะไม่ถูกทำซ้ำเป็นแหล่งข้อมูลสำรองระดับบนสุดแยกต่างหาก พาธที่หายไปจะ ถูกข้าม payload ของไฟล์เก็บถาวรจัดเก็บเนื้อหาไฟล์จากแผนผังต้นทางเหล่านั้น และ manifest.json ที่ฝังอยู่จะบันทึกพาธต้นทางแบบสัมบูรณ์ที่แก้ไขแล้ว พร้อมเค้าโครงไฟล์เก็บถาวรที่ใช้กับแต่ละ asset ระหว่างการสร้างไฟล์เก็บถาวร OpenClaw จะข้ามไฟล์ที่ทราบว่าเปลี่ยนแปลงขณะใช้งานจริงและไม่มีคุณค่าต่อการกู้คืน รวมถึงทรานสคริปต์เซสชันของ agent ที่ใช้งานอยู่ บันทึกการรัน cron บันทึกแบบ rolling คิวการนำส่ง ไฟล์ socket/pid/temp ใต้ไดเรกทอรีสถานะ และไฟล์ temp ของ durable queue ที่เกี่ยวข้อง ผลลัพธ์ JSON มี skippedVolatileCount เพื่อให้ automation เห็นจำนวนไฟล์ที่ถูกละไว้โดยตั้งใจ ไฟล์ซอร์สและ manifest ของ Plugin ที่ติดตั้งไว้ภายใต้แผนผัง extensions/ ของไดเรกทอรีสถานะจะถูกรวมไว้ แต่แผนผัง dependency node_modules/ ที่ซ้อนอยู่จะถูกข้าม dependency เหล่านั้นเป็น artifact การติดตั้งที่สร้างใหม่ได้ หลังจาก กู้คืนไฟล์เก็บถาวร ให้ใช้ openclaw plugins update <id> หรือติดตั้ง Plugin ใหม่ ด้วย openclaw plugins install <spec> --force เมื่อ Plugin ที่กู้คืนรายงานว่า dependency หายไป

​
ลักษณะการทำงานเมื่อการกำหนดค่าไม่ถูกต้อง

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

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

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

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