---
read_when:
    - คุณต้องการคลังสำรองข้อมูลระดับชั้นหนึ่งสำหรับสถานะ OpenClaw ภายในเครื่อง
    - คุณต้องการดูตัวอย่างว่าเส้นทางใดจะถูกรวมไว้ก่อนรีเซ็ตหรือถอนการติดตั้ง
summary: ข้อมูลอ้างอิง CLI สำหรับ `openclaw backup` (สร้างไฟล์เก็บถาวรสำรองข้อมูลภายในเครื่อง)
title: สำรองข้อมูล
x-i18n:
    generated_at: "2026-06-27T17:19:55Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 1ac7d8e4babd24f1c46ac48dca6c413e12361173df83cfe485dd3945ccd30c3e
    source_path: cli/backup.md
    workflow: 16
---

# `openclaw backup`

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

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

```bash
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](/th/cli)