Saat meningkatkan gambar aplikasi OpenClaw, lakukan backup dan pemulihan data ruang kerja untuk mempertahankan data personal seperti memori asisten AI, konfigurasi identitas, dan Skills. - Simple Application Server

Untuk meningkatkan aplikasi OpenClaw pada instans Simple Application Server sekaligus mempertahankan data ruang kerja (seperti memori, konfigurasi identitas, dan Skills), gunakan salah satu dari dua metode berikut: backup dan pemulihan lokal atau rollback snapshot.

Ikhtisar jalur peningkatan

Anda dapat meningkatkan OpenClaw dengan menggunakan salah satu dari dua metode berikut:

Metode	Proses
Metode 1: Peningkatan melalui backup dan pemulihan lokal	Backup lokal → reset sistem → Pulihkan dari backup
Metode 2: Peningkatan melalui rollback snapshot	Buat snapshot → Tingkatkan perangkat lunak → Lakukan rollback menggunakan snapshot jika terjadi masalah

Latar belakang

Direktori ruang kerja OpenClaw default, /home/admin/.openclaw/workspace, menyimpan data personal inti untuk asisten AI Anda, termasuk:

IDENTITY.md: Definisi identitas.
SOUL.md: Definisi nilai.
AGENTS.md: Definisi gaya kerja.
memory/: Riwayat percakapan dan catatan kerja.
skills/: Skills ekstensi yang terinstal.

Penting

Langkah-langkah dalam topik ini mengasumsikan direktori ruang kerja default adalah /home/admin/.openclaw/workspace. Jika Anda telah mengubah direktori ruang kerja default, gunakan path aktual Anda.
File konfigurasi OpenClaw berada di /home/admin/.openclaw/openclaw.json. Anda dapat melakukan backup file ini sesuai kebutuhan.

Prosedur

Metode 1: Backup dan pemulihan lokal

Peringatan

Reset sistem akan menghapus semua data pada sistem disk (termasuk konfigurasi, log, dan database) serta menghentikan layanan Anda. Anda harus melakukan backup data kritis sebelum melanjutkan. Untuk memastikan integritas data, kami menyarankan agar Anda menghentikan gateway dan menjeda layanan OpenClaw sebelum membuat backup.

Langkah 1: Backup data ruang kerja

Kemas direktori ruang kerja dan unduh arsipnya ke komputer lokal Anda.

Di Simple Application Server console, pilih server target dan klik Connect. Di bagian Workbench One-click Connection, klik Log on Now.

Kemas data ruang kerja.

cd /home/admin
tar -zcvf workspace.tar.gz -C /home/admin/.openclaw/ workspace

Unduh arsip terkompresi ke komputer lokal Anda. Untuk informasi lebih lanjut, lihat Download files by using Workbench.

Workbench membatasi ukuran unduhan file tunggal hingga 1.200 MB. Jika file arsip Anda lebih besar dari 1.200 MB, lihat Transfer files to a Linux instance by using scp, rsync, or sftp.

Langkah 2: Reset sistem dan tingkatkan gambar

Di Simple Application Server console, temukan server Anda dan pilih More > Server Resetting.
Di bawah Reset to Other image, pilih versi terbaru dari gambar OpenClaw dan klik Confirm Reset.
Setelah sistem di-reset, ikuti Langkah 2 dalam Deploy the OpenClaw application image untuk mengonfigurasi ulang instans Anda.

Langkah 3: Pulihkan data backup

Unggah file backup ke instans yang telah di-reset dan pulihkan data ke direktori ruang kerja.

Unggah file backup ke direktori /home/admin pada instans. Untuk informasi lebih lanjut, lihat Upload files by using Workbench.

Workbench membatasi ukuran unggahan file tunggal hingga 1.200 MB. Jika arsip Anda lebih besar dari 1.200 MB, lihat Transfer files to a Linux instance by using scp, rsync, or sftp.

Sambungkan ke instans dan ekstrak arsip untuk memulihkan data ruang kerja.

cd  /home/admin
tar -xzvf workspace.tar.gz
mv /home/admin/.openclaw/workspace /home/admin/.openclaw/workspace.bak # Ganti nama direktori ruang kerja saat ini sebagai cadangan jika pemulihan gagal.
mv workspace /home/admin/.openclaw/ # Pindahkan direktori ruang kerja hasil ekstraksi ke path aplikasi untuk menyelesaikan pemulihan.

Restart gateway untuk menerapkan perubahan.
```
openclaw gateway restart
```
Buka WebUI, jalankan perintah /new, dan konfirmasi dengan asisten AI bahwa memori dan konfigurasi identitas Anda telah dipulihkan.

Metode 2: Rollback snapshot

Sebelum melakukan peningkatan, buat snapshot instans sebagai titik pemulihan. Jika terjadi masalah setelah Anda meningkatkan perangkat lunak OpenClaw, Anda dapat menggunakan snapshot tersebut untuk melakukan rollback instans ke kondisi sebelum peningkatan.

Langkah 1: Buat snapshot

Buat snapshot instans sebelum peningkatan sebagai titik rollback.

Di Simple Application Server console, temukan server target dan pilih Snapshot > Create Snapshot.
Tetapkan nama snapshot, misalnya openclaw-pre-upgrade, klik Create, dan tunggu hingga snapshot selesai dibuat.

Langkah 2: Tingkatkan perangkat lunak OpenClaw

Lakukan koneksi remote ke instans. Di bagian Workbench One-click Connection, klik Log on Now.
Di terminal, jalankan perintah berikut untuk memeriksa versi saat ini dan meningkatkan OpenClaw:
```
openclaw --version
sudo openclaw update
```
Di terminal, jalankan perintah berikut untuk me-restart gateway:
```
openclaw gateway restart
```
Verifikasi bahwa peningkatan berhasil.
```
openclaw --version
```

Penting

Setelah Anda melakukan peningkatan menggunakan perintah openclaw update, Anda mungkin mengalami masalah dikenal berikut di konsol:

Gateway tampak offline: Meskipun konsol menunjukkan operasi restart berhasil, gateway sebenarnya tidak direstart. Anda harus menjalankan openclaw gateway restart di terminal untuk me-restart gateway.
Tombol "Get Address" dinonaktifkan: Tombol ini hanya tersedia saat gateway online. Anda dapat menjalankan sh /opt/.swas/run-cmd.sh get-url di terminal untuk mendapatkan URL akses WebUI, lalu membukanya di browser.

Untuk penjelasan lengkap, lihat Apa yang harus saya lakukan jika gateway tampak offline di konsol setelah peningkatan menggunakan openclaw update?

Langkah 3: Rollback snapshot (opsional)

Jika OpenClaw berjalan tidak normal setelah peningkatan, gunakan snapshot untuk melakukan rollback ke kondisi sebelum peningkatan.

Lakukan langkah ini hanya jika peningkatan menyebabkan masalah. Rollback tidak diperlukan jika aplikasi berjalan sesuai harapan.

Di Simple Application Server console, buka halaman Snapshot.
Temukan snapshot yang Anda buat sebelum peningkatan dan klik Rollback. Konfirmasi operasi rollback tersebut.
Setelah rollback selesai, klik Start dan verifikasi bahwa OpenClaw berjalan dengan benar.

Pulihkan hanya file konfigurasi

Snapshot Simple Application Server tidak mendukung pemasangan langsung atau pemulihan file individual. Jika Anda perlu memulihkan file konfigurasi tertentu dari snapshot tanpa melakukan rollback penuh, buat instans sementara dari snapshot tersebut. Kemudian, ekstrak file yang diperlukan dan transfer ke instans Anda saat ini.

Di Simple Application Server console, buka halaman Snapshot dari server tempat snapshot target berada. Pilih snapshot tersebut dan klik Create Server untuk membuat instans sementara.
Setelah instans sementara dibuat, buka halaman detail instans dan klik Connect. Di bagian Workbench One-click Connection, klik Log on Now.

Temukan file konfigurasi yang perlu Anda pulihkan. Contohnya:

ls /home/admin/.openclaw/workspace/
ls /home/admin/.openclaw/openclaw.json

Unduh file konfigurasi ke komputer lokal Anda. Untuk informasi lebih lanjut, lihat Download files by using Workbench.
Pada instans Anda saat ini, unggah file konfigurasi ke direktori yang sesuai. Untuk informasi lebih lanjut, lihat Upload files by using Workbench.
Setelah memverifikasi bahwa path file dan izin sudah benar, restart gateway untuk menerapkan konfigurasi.
```
openclaw gateway restart
```
Setelah selesai, segera lepas instans sementara untuk menghindari biaya tambahan.

FAQ

Bagaimana cara menghentikan gateway?

Jalankan perintah openclaw gateway stop di terminal atau masukkan perintah tersebut di WebUI untuk menghentikan gateway.

Mengapa konsol masih menampilkan versi image lama setelah peningkatan menggunakan `openclaw update`?

Setelah Anda berhasil meningkatkan perangkat lunak menggunakan perintah openclaw update, informasi image di Simple Application Server console mungkin tetap menampilkan versi lama. Ini merupakan perilaku yang diharapkan. Konsol menampilkan versi image yang digunakan saat membuat instans dan tidak memengaruhi versi aktual perangkat lunak OpenClaw. Output perintah openclaw --version memberikan nomor versi yang pasti.

Apa yang harus dilakukan jika gateway offline setelah peningkatan dengan `openclaw update`?

Setelah Anda melakukan peningkatan menggunakan perintah openclaw update, skrip yang dikirimkan oleh Cloud Assistant mungkin tidak kompatibel dengan versi baru, sehingga menyebabkan masalah berikut di konsol:

Gateway tampak offline: Layanan gateway berjalan dengan benar di server, tetapi statusnya di konsol ditampilkan sebagai offline.
Tombol Restart tidak berfungsi: Meskipun konsol menunjukkan operasi restart berhasil, gateway sebenarnya tidak direstart.
Tombol "Get Address" dinonaktifkan: Tombol ini dinonaktifkan saat gateway ditampilkan sebagai offline.

Solusi:

Untuk me-restart gateway, jalankan perintah berikut di terminal:
```
openclaw gateway restart
```
Untuk mengakses WebUI, jalankan perintah berikut di terminal untuk mendapatkan URL akses:
```
sh /opt/.swas/run-cmd.sh get-url
```
Salin URL dari output perintah tersebut dan buka di browser untuk mengakses WebUI.