---
read_when:
    - คุณต้องการคลังสำรองข้อมูลที่รองรับอย่างเต็มรูปแบบสำหรับสถานะ OpenClaw ในเครื่อง
    - คุณต้องการดูตัวอย่างว่าพาธใดบ้างที่จะถูกรวมไว้ก่อนรีเซ็ตหรือถอนการติดตั้ง
summary: ข้อมูลอ้างอิง CLI สำหรับ `openclaw backup` (สร้างไฟล์เก็บถาวรสำรองข้อมูลในเครื่อง)
title: การสำรองข้อมูล
x-i18n:
    generated_at: "2026-05-10T19:28:25Z"
    model: gpt-5.5
    provider: openai
    source_hash: 2c95cf475a563ad4f0a2dbaeda504b265580545c9d3f6f71d2f4d2a183e76a5c
    source_path: cli/backup.md
    workflow: 16
---

# `openclaw backup`

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

```bash
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` จึงล้มเหลวทันทีเมื่อไฟล์กำหนดค่ามีอยู่แต่ไม่ถูกต้อง และการสำรองพื้นที่ทำงานยังเปิดใช้งานอยู่

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

```bash
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`

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

- [ข้อมูลอ้างอิง CLI](/th/cli)