---
read_when:
    - คุณต้องการไฟล์เก็บถาวรสำรองข้อมูลชั้นหนึ่งสำหรับสถานะ OpenClaw ในเครื่อง
    - คุณต้องการดูตัวอย่างว่าเส้นทางใดบ้างที่จะถูกรวมไว้ก่อนการรีเซ็ตหรือถอนการติดตั้ง
summary: ข้อมูลอ้างอิง CLI สำหรับ `openclaw backup` (สร้างไฟล์เก็บถาวรสำรองข้อมูลในเครื่อง)
title: สำรองข้อมูล
x-i18n:
    generated_at: "2026-04-23T06:17:04Z"
    model: gpt-5.4
    provider: openai
    source_hash: 700eda8f9eac1cc93a854fa579f128e5e97d4e6dfc0da75b437c0fb2a898a37d
    source_path: cli/backup.md
    workflow: 15
---

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

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

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

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

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

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

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

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

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

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

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

```bash
openclaw backup create --no-include-workspace
```

ซึ่งจะยังคงรวมสถานะ config และไดเรกทอรีข้อมูลรับรองภายนอกไว้ในขอบเขต
ขณะเดียวกันก็ข้ามการค้นหาเวิร์กสเปซทั้งหมด

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

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

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

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

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

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

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