📎 Source:openclaw-vm-backup-reset-restore.md — view on GitHub & star ⭐

OpenClaw VM Berantakan? Cara Backup ke GitHub, Reset VPS, lalu Restore Rapi Tanpa Kehilangan History

Ada satu fase yang hampir pasti kejadian kalau kamu cukup lama main sama OpenClaw di VPS.

Awalnya rapi.

Terus mulai nambah satu workspace. Habis itu bikin test folder. Terus ada repo lain buat automation. Habis itu backup manual. Terus ada script yang tadinya “nanti aja dirapihin”. Tiba-tiba beberapa minggu kemudian kamu buka terminal dan reaksinya cuma satu:

“Kok ini berantakan banget ya?”

Dan jujur, itu fair.

Interaksi kayak gini sering banget muncul:

• “Kalau mau nata ulang OC di VM saya, file mana aja yang harus dibackup?”
• “Mau setup dari nol lagi, tapi history sebelumnya jangan hilang.”
• “Bisa nggak dibikin jadi satu folder workspace yang rapi dan relevan?”

Jawabannya: bisa banget.

Tapi jangan asal zip satu server terus berharap semuanya aman. Itu cara paling cepat buat bawa chaos lama ke mesin baru.

Yang lebih waras itu begini:

1. pilih file yang benar-benar penting
2. backup ke GitHub
3. reset atau rebuild VPS
4. restore ke struktur folder yang jauh lebih bersih
5. hidupkan lagi OpenClaw dengan identity dan history yang masih kepake

Kalau kamu belum punya VPS dan mau pakai link affiliate kita, daftar lewat sini ya:

https://blog.fanani.co/sumopod

Kalau kamu maunya versi teknis lengkap, full English, simpan link ini juga:

https://github.com/fanani-radian/openclaw-sumopod/blob/main/tutorials/openclaw-vm-backup-reset-restore.md

Yang di blog ini bakal lebih santai, lebih manusiawi, dan lebih enak diikutin dari awal sampai akhir.

Problem Sebenarnya Bukan Cuma Folder Berantakan

Jadi gini.

Kalau OpenClaw VM kamu berantakan, problem-nya biasanya bukan sekadar visual. Bukan cuma soal ls kelihatan jelek.

Problem yang lebih serius biasanya salah satu dari ini:

• kamu sendiri udah lupa folder mana yang aktif
• ada duplicate workspace dengan isi mirip tapi nggak sama
• scripts refer ke path lama
• memory dan project notes nyebar
• repo penting ada yang belum kepush
• config penting ada, tapi kamu nggak yakin ada di mana

Ini yang bikin reset VPS terasa serem.

Karena kamu pengen bersih, tapi takut kehilangan hal-hal yang selama ini bikin assistant kamu actually useful.

Nah, di titik ini mindset-nya harus diubah.

Target kamu bukan backup semuanya. Target kamu adalah backup hal yang bernilai.

Itu beda besar.

Cara Pikir yang Paling Waras

Lihat VM kamu kayak rumah kontrakan yang terlalu penuh barang.

Kamu mau pindah.

Apakah kamu angkut semua isi rumah, termasuk kardus rusak, kabel nggak jelas, dan struk belanja 8 bulan lalu?

Ya jangan lah.

Yang kamu bawa itu:

• barang identitas
• dokumen penting
• alat kerja yang beneran dipakai
• barang bernilai

Sisanya, buang.

OpenClaw VM juga gitu.

Kalau dilihat simple, alurnya memang simple. Yang bikin ribet biasanya bukan step-nya, tapi kita suka nyampur hal penting dan hal sampah dalam satu backup.

Kalau alurnya ini, kamu bukan sekadar “selamat dari reset”. Kamu malah naik level.

File Mana Saja yang Harus Dibackup?

Ini jawaban praktisnya.

1. File identity assistant

Ini yang bikin assistant kamu tetap jadi assistant yang sama.

Biasanya termasuk:

• SOUL.md
• USER.md
• AGENTS.md
• IDENTITY.md
• TOOLS.md

Kalau file-file ini hilang, assistant masih bisa hidup. Tapi rasanya beda. Nadanya beda. kebiasaannya beda. Bahkan decision pattern-nya bisa ikut beda.

Jadi ini wajib simpan.

2. File memory dan continuity

Ini bagian yang paling orang sesali kalau hilang.

Biasanya termasuk:

• MEMORY.md
• memory/*.md
• diary entries yang penting
• notes harian
• lessons learned
• project context docs

Kalau kamu bilang “history lama pengen tetap kepake”, ya inilah jantungnya.

3. File config OpenClaw

Ini operational brain.

Contohnya:

• ~/.openclaw/openclaw.json
• config models
• routing
• channel setup
• custom script yang nyambung ke gateway
• cron file yang kamu bikin sendiri

Tapi hati-hati.

Config begini kadang ngandung token, secret, atau credential. Jadi best practice-nya bukan asal push semua raw secrets ke GitHub publik. Mending:

• simpan config structure-nya
• bikin env-template.example
• re-add secret nanti waktu restore

Itu lebih sehat.

4. Project repos dan assets

Ini biasanya nilai kerjanya ada di sini.

Misalnya:

• repo openclaw-sumopod
• repo blog-fanani
• skill custom
• scripts automation
• dashboards
• generated images atau diagram yang memang kepake

Kalau repo ini belum dipush ke GitHub, backup kamu belum aman. Titik.

File Apa yang Biasanya Nggak Usah Dibawa?

Nah ini bagian yang sering bikin orang gagal move on dari VM lama.

Yang biasanya nggak usah dibawa:

• node_modules/
• npm cache
• pip cache
• Docker cache
• .next/
• .nuxt/
• .output/
• dist/
• logs lama yang nggak pernah dibaca
• screenshot temp
• backup zip random dalam backup lain
• duplicate project folders yang isinya nggak jelas mana paling baru

Brutal dikit nggak apa-apa di sini.

Kalau tujuanmu bikin sistem bersih, ya jangan pelihara sampah lama.

Minimal Backup Checklist Kalau Kamu Lagi Buru-Buru

Kalau lagi sempit waktu dan pengen jawaban cepat, simpan dulu ini:

~/.openclaw/openclaw.json
~/.openclaw/agents/
<main workspace>/SOUL.md
<main workspace>/USER.md
<main workspace>/AGENTS.md
<main workspace>/TOOLS.md
<main workspace>/MEMORY.md
<main workspace>/memory/
<main workspace>/skills/
<active project repos>

Kalau itu aman, kamu udah jauh lebih tenang.

Tapi kalau mau hasil restore yang beneran enak dipakai, ada satu langkah penting sebelum backup:

tentukan dulu struktur folder barunya.

Sebelum Backup, Tentukan Rumah Barunya Dulu

Ini langkah yang sering di-skip. Padahal ini yang bikin restore nanti berasa rapi, bukan sekadar hidup lagi.

Contoh struktur yang masuk akal:

/root/workspace/
├── core/
│   ├── SOUL.md
│   ├── USER.md
│   ├── AGENTS.md
│   ├── TOOLS.md
│   ├── MEMORY.md
│   └── memory/
├── projects/
│   ├── openclaw-sumopod/
│   ├── blog-fanani/
│   └── other-active-repos/
├── shared/
│   ├── skills/
│   └── scripts/
└── backups/

Atau kalau kamu tetap mau nuansa .openclaw tapi lebih bersih:

/root/.openclaw/
├── workspace-main/
├── workspace-projects/
│   ├── blog-fanani/
│   └── openclaw-sumopod/
├── shared-skills/
└── archived-backups/

Nggak harus persis begini.

Yang penting:

• ada satu home base yang jelas
• ada satu lokasi project yang jelas
• memory nggak nyebar liar
• scripts punya rumah
• backup nggak numpuk di folder kerja utama

Simple beats clever.

Step 1: Audit VM Lama Dulu

Jangan langsung backup. Audit dulu.

Pakai command simpel kayak gini:

find ~ -maxdepth 3 -type d \( -name '*openclaw*' -o -name '*workspace*' -o -name '*blog*' -o -name '*skills*' \) | sort

Lalu cek ukuran dan kandidat folder penting:

du -sh ~/.openclaw/* 2>/dev/null | sort -h
ls -la ~/workspace 2>/dev/null
ls -la ~/.openclaw/agents 2>/dev/null

Tujuan audit ini bukan buat kagum sama banyaknya folder.

Tujuannya cuma 3:

1. tau mana workspace utama
2. tau mana project yang masih aktif
3. tau mana folder sampah atau leftover

Kalau tiga hal ini udah jelas, backup jadi jauh lebih gampang.

Step 2: Bikin Repo Backup yang Khusus Buat Recovery

Ini pattern yang menurutku paling bersih.

Bikin satu repo private misalnya openclaw-vm-backup.

Isinya jangan random. Susun rapi.

Strukturnya bisa begini:

openclaw-vm-backup/
├── assistant-identity/
│   ├── SOUL.md
│   ├── USER.md
│   ├── AGENTS.md
│   ├── TOOLS.md
│   └── MEMORY.md
├── memory/
├── skills/
├── projects/
│   ├── openclaw-sumopod/
│   └── blog-fanani/
├── restore-notes.md
└── env-template.example

Begitu nanti restore, kamu tinggal baca repo ini dan semua hal penting udah ada rumahnya.

Nggak perlu tebak-tebakan.

Step 3: Copy yang Penting, Bukan yang Bikin Penuh

Contoh command-nya kira-kira begini:

mkdir -p ~/openclaw-vm-backup/assistant-identity
mkdir -p ~/openclaw-vm-backup/projects
mkdir -p ~/openclaw-vm-backup/memory
mkdir -p ~/openclaw-vm-backup/skills

cp ~/workspace/SOUL.md ~/openclaw-vm-backup/assistant-identity/ 2>/dev/null
cp ~/workspace/USER.md ~/openclaw-vm-backup/assistant-identity/ 2>/dev/null
cp ~/workspace/AGENTS.md ~/openclaw-vm-backup/assistant-identity/ 2>/dev/null
cp ~/workspace/TOOLS.md ~/openclaw-vm-backup/assistant-identity/ 2>/dev/null
cp ~/workspace/MEMORY.md ~/openclaw-vm-backup/assistant-identity/ 2>/dev/null
cp -r ~/workspace/memory ~/openclaw-vm-backup/
cp ~/.openclaw/openclaw.json ~/openclaw-vm-backup/

Untuk repo aktif, mending preserve repo-nya sekalian atau push upstream dulu.

cp -r ~/openclaw-sumopod ~/openclaw-vm-backup/projects/
cp -r ~/blog-fanani ~/openclaw-vm-backup/projects/

Kalau itu repo Git beneran, idealnya ya commit dan push dulu satu-satu.

Step 4: Push ke GitHub Dulu. Jangan Wipe Duluan

Ini bagian yang sering kelewat karena orang buru-buru pengen reset.

Kalau belum kepush, itu belum backup yang bisa dipercaya.

git init
git add .
git commit -m "Backup OpenClaw VM before rebuild"
git remote add origin <your-private-repo-url>
git push -u origin main

Kalau ada beberapa repo kerja, push juga repo aslinya.

Dan iya, repos project aktif tetap harus dipush ke upstream masing-masing. Jangan cuma andalkan satu backup dump lalu berharap semuanya aman.

Dengan cara ini, kamu punya backup yang rapi dan modular.

Step 5: Baru Reset VPS

Kalau semua backup udah verified, baru reset.

Sebelum pencet gas, pastikan kamu udah bisa jawab:

• repo backup ada di mana
• project repo mana aja yang udah kepush
• secret mana yang nanti perlu diisi ulang
• struktur folder baru mau kayak apa

Kalau masih bingung di salah satu poin itu, tahan dulu. Jangan wipe sambil gambling.

Step 6: Restore ke Struktur yang Jauh Lebih Masuk Akal

Setelah VPS fresh:

1. install OpenClaw lagi
2. clone repo backup
3. clone repo project aktif
4. restore identity + memory ke workspace baru
5. merge config dengan kepala dingin

Contoh:

mkdir -p /root/workspace/projects
cd /root/workspace

git clone <backup-repo-url> openclaw-vm-backup
git clone <openclaw-sumopod-repo-url> projects/openclaw-sumopod
git clone <blog-repo-url> projects/blog-fanani

Lalu restore file inti:

cp /root/workspace/openclaw-vm-backup/assistant-identity/* /root/workspace/core/
cp -r /root/workspace/openclaw-vm-backup/memory /root/workspace/core/

Jangan asal overwrite semua config baru pakai config lama kalau version OpenClaw udah jauh berubah. Bandingin, merge, baru apply.

Step 7: Reconnect Secret dan Layanan Eksternal

Ini yang sering bikin orang bilang “padahal file udah balik semua kok masih belum jalan”.

Ya karena restore bukan cuma soal file.

Checklist minimum:

• environment variables
• API keys model provider
• Telegram bot token
• Google credential kalau ada
• cron jobs
• script path yang refer ke workspace lama
• routing/channel config

Begitu semua ini beres, baru assistant kamu beneran balik hidup dengan normal.

Kalau Ditanya di Grup, Jawaban Singkatnya Apa?

Kalau ada yang nanya:

“Mas, kalau mau nata ulang OpenClaw di VM, file mana aja yang harus dibackup?”

Jawaban singkat yang bagus itu:

Backup ke GitHub dulu. Simpan file identity, memory, config penting, dan repo project aktif. Jangan backup sampah kayak cache dan build output. Setelah itu reset VPS, lalu restore semuanya ke satu folder workspace yang rapi dan relevan.

Itu udah jawaban yang bukan cuma aman, tapi juga berguna.

Common Mistakes yang Bikin Restore Berasa Gagal

Biasanya restore gagal bukan karena OpenClaw-nya susah. Tapi karena kita melakukan kebodohan yang sama dua kali.

Contohnya:

• backup semuanya tanpa mikir nilai file-nya
• restore tiga workspace yang isinya tumpang tindih
• naruh secret di file random tanpa restore notes
• langsung overwrite config baru pakai config lama tanpa compare schema
• nggak ngetes channel, model, dan script path habis restore

Kalau salah satu dari ini kejadian, hasilnya tetap hidup sih. Tapi rasanya masih kusut.

Pendapat Jujurku

Kalau VM kamu berantakan, itu bukan berarti kamu ceroboh banget.

Biasanya itu justru tanda sistemnya kepake. Kerjaan tumbuh lebih cepat daripada struktur. Itu sering kejadian.

Tapi ya jangan dibiarin selamanya juga.

Satu reset yang direncanakan dengan benar bisa bikin semua hal terasa jauh lebih ringan:

• path lebih waras
• restore lebih gampang
• repo lebih jelas
• assistant lebih gampang dirawat
• dan kamu sendiri nggak males buka server lagi

TBH, itu worth it.

Penutup

Kalau kamu mau mulai dari nol lagi tanpa kehilangan otak lama OpenClaw kamu, jangan panik dan jangan asal backup satu disk penuh.

Pilih yang penting. Push ke GitHub. Reset dengan rencana. Restore ke satu workspace yang rapi.

Itu versi dewasa dari “mulai ulang”.

Bukan buang semua. Tapi membawa yang bernilai ke sistem yang lebih sehat.

Kalau kamu mau lihat versi teknis penuh, command-by-command, baca tutorial GitHub ini:

https://github.com/fanani-radian/openclaw-sumopod/blob/main/tutorials/openclaw-vm-backup-reset-restore.md

Kalau butuh VPS buat jalanin OpenClaw atau project lain, daftar lewat affiliate kita di sini:

https://blog.fanani.co/sumopod

Related Links

• Technical GitHub tutorial: https://github.com/fanani-radian/openclaw-sumopod/blob/main/tutorials/openclaw-vm-backup-reset-restore.md
• OpenClaw Sumopod repo: https://github.com/fanani-radian/openclaw-sumopod
• OpenClaw official repo: https://github.com/openclaw/openclaw