Langsung ke konten utama

​
Memigrasikan OpenClaw ke Mesin Baru

Panduan ini memindahkan gateway OpenClaw ke mesin baru tanpa mengulang onboarding.

​
Apa Saja yang Dimigrasikan

Saat Anda menyalin direktori state (~/.openclaw/ secara default) dan workspace Anda, Anda akan mempertahankan:
  • Konfigurasi — openclaw.json dan semua pengaturan gateway
  • Auth — auth-profiles.json per agent (kunci API + OAuth), serta state channel/provider apa pun di bawah credentials/
  • Sesi — riwayat percakapan dan state agent
  • State channel — login WhatsApp, sesi Telegram, dll.
  • File workspace — MEMORY.md, USER.md, Skills, dan prompt
Jalankan openclaw status di mesin lama untuk mengonfirmasi path direktori state Anda. Profil kustom menggunakan ~/.openclaw-<profile>/ atau path yang disetel melalui OPENCLAW_STATE_DIR.

​
Langkah Migrasi

1

Hentikan gateway dan buat cadangan

Di mesin lama, hentikan gateway agar file tidak berubah di tengah penyalinan, lalu arsipkan:
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
Jika Anda menggunakan beberapa profil (misalnya ~/.openclaw-work), arsipkan masing-masing secara terpisah.
2

Instal OpenClaw di mesin baru

Instal CLI (dan Node jika diperlukan) di mesin baru. Tidak masalah jika onboarding membuat ~/.openclaw/ baru — Anda akan menimpanya setelah ini.
3

Salin direktori state dan workspace

Transfer arsip melalui scp, rsync -a, atau drive eksternal, lalu ekstrak:
cd ~
tar -xzf openclaw-state.tgz
Pastikan direktori tersembunyi ikut disertakan dan kepemilikan file sesuai dengan pengguna yang akan menjalankan gateway.
4

Jalankan doctor dan verifikasi

Di mesin baru, jalankan Doctor untuk menerapkan migrasi konfigurasi dan memperbaiki layanan:
openclaw doctor
openclaw gateway restart
openclaw status

​
Kendala Umum

Jika gateway lama menggunakan --profile atau OPENCLAW_STATE_DIR dan yang baru tidak, channel akan terlihat logout dan sesi akan kosong. Jalankan gateway dengan profil atau state-dir yang sama seperti yang Anda migrasikan, lalu jalankan ulang openclaw doctor.
File konfigurasi saja tidak cukup. Profil auth model berada di bawah agents/<agentId>/agent/auth-profiles.json, dan state channel/provider masih berada di bawah credentials/. Selalu migrasikan seluruh direktori state.
Jika Anda menyalin sebagai root atau mengganti pengguna, gateway mungkin gagal membaca kredensial. Pastikan direktori state dan workspace dimiliki oleh pengguna yang menjalankan gateway.
Jika UI Anda menunjuk ke gateway remote, host remote tersebut yang memiliki sesi dan workspace. Migrasikan host gateway itu sendiri, bukan laptop lokal Anda. Lihat FAQ.
Direktori state berisi profil auth, kredensial channel, dan state provider lainnya. Simpan cadangan dalam keadaan terenkripsi, hindari saluran transfer yang tidak aman, dan rotasi kunci jika Anda mencurigai adanya paparan.

​
Daftar Periksa Verifikasi

Di mesin baru, konfirmasikan:
  • openclaw status menunjukkan gateway sedang berjalan
  • Channel masih terhubung (tidak perlu pairing ulang)
  • Dashboard terbuka dan menampilkan sesi yang ada
  • File workspace (memori, konfigurasi) tersedia