Skip to main content
OpenClaw mendukung tiga jalur migrasi: mengimpor dari sistem agen lain, memindahkan instalasi yang sudah ada ke mesin baru, dan meningkatkan Plugin di tempat.

​
Impor dari sistem agen lain

Penyedia migrasi bawaan memasukkan instruksi, server MCP, Skills, konfigurasi model, dan kunci API (dengan persetujuan) ke OpenClaw. Rencana dipratinjau sebelum perubahan apa pun, rahasia disamarkan dalam laporan, dan penerapan didukung oleh cadangan yang telah diverifikasi.

Bermigrasi dari Claude

Impor status Claude Code dan Claude Desktop, termasuk CLAUDE.md, server MCP, Skills, dan perintah proyek.

Bermigrasi dari Hermes

Impor konfigurasi, penyedia, server MCP, memori, Skills, dan kunci .env yang didukung dari Hermes.
Titik masuk CLI adalah openclaw migrate. Orientasi awal juga dapat menawarkan migrasi ketika mendeteksi sumber yang dikenal (openclaw onboard --flow import).

​
Pindahkan OpenClaw ke mesin baru

Salin direktori status (~/.openclaw/ secara default) dan ruang kerja Anda untuk mempertahankan:
  • Konfigurasi — openclaw.json dan semua pengaturan Gateway.
  • Autentikasi — auth-profiles.json per agen (kunci API beserta OAuth), serta status saluran atau penyedia apa pun di bawah credentials/.
  • Sesi — riwayat percakapan dan status agen.
  • Status saluran — info masuk WhatsApp, sesi Telegram, dan yang serupa.
  • Berkas ruang kerja — MEMORY.md, USER.md, Skills, dan prompt.
Jalankan openclaw status pada mesin lama untuk mengonfirmasi jalur direktori status Anda. Profil khusus menggunakan ~/.openclaw-<profile>/ atau jalur yang ditetapkan melalui OPENCLAW_STATE_DIR.

​
Langkah-langkah migrasi

1

Hentikan Gateway dan buat cadangan

Pada mesin lama, hentikan Gateway agar berkas tidak berubah saat penyalinan berlangsung, lalu arsipkan:
Jika Anda menggunakan beberapa profil (misalnya ~/.openclaw-work), arsipkan masing-masing secara terpisah.
2

Instal OpenClaw pada mesin baru

Instal CLI (dan Node jika diperlukan) pada mesin baru. Tidak masalah jika orientasi awal membuat ~/.openclaw/ baru — Anda akan menimpanya pada langkah berikutnya.
3

Salin direktori status dan ruang kerja

Transfer arsip melalui scp, rsync -a, atau drive eksternal, lalu ekstrak:
Pastikan direktori tersembunyi telah disertakan dan kepemilikan berkas sesuai dengan pengguna yang akan menjalankan Gateway.
4

Jalankan Doctor dan verifikasi

Pada mesin baru, jalankan Doctor untuk menerapkan migrasi konfigurasi dan memperbaiki layanan:
Jika Telegram atau Discord menggunakan fallback lingkungan default (TELEGRAM_BOT_TOKEN atau DISCORD_BOT_TOKEN), pastikan .env dalam direktori status yang dimigrasikan berisi kunci tersebut tanpa mencetak nilai rahasianya:
openclaw doctor juga memperingatkan ketika akun Telegram atau Discord default yang diaktifkan tidak memiliki token yang dikonfigurasi dan variabel lingkungan yang sesuai tidak tersedia bagi proses Doctor.

​
Kendala umum

Jika Gateway lama menggunakan --profile atau OPENCLAW_STATE_DIR, sedangkan yang baru tidak, saluran akan tampak keluar dari akun dan sesi akan kosong. Jalankan Gateway dengan profil atau direktori status yang sama dengan yang Anda migrasikan, lalu jalankan kembali openclaw doctor.
Berkas konfigurasi saja tidak cukup. Profil autentikasi model berada di bawah agents/<agentId>/agent/auth-profiles.json, sedangkan status saluran dan penyedia berada di bawah credentials/. Selalu migrasikan seluruh direktori status.
Jika Anda menyalin sebagai root atau berganti pengguna, Gateway mungkin gagal membaca kredensial. Pastikan direktori status dan ruang kerja dimiliki oleh pengguna yang menjalankan Gateway.
Jika UI Anda mengarah ke Gateway jarak jauh, host jarak jauh tersebut memiliki sesi dan ruang kerja. Migrasikan host Gateway itu sendiri, bukan laptop lokal Anda. Lihat Tanya Jawab.
Direktori status berisi profil autentikasi, kredensial saluran, dan status penyedia lainnya. Simpan cadangan dalam keadaan terenkripsi, hindari saluran transfer yang tidak aman, dan rotasi kunci jika Anda mencurigai adanya kebocoran.

​
Daftar periksa verifikasi

Pada mesin baru, pastikan:
  • openclaw status menunjukkan Gateway sedang berjalan.
  • Saluran masih terhubung (tidak perlu memasangkan ulang).
  • Dasbor terbuka dan menampilkan sesi yang sudah ada.
  • Berkas ruang kerja (memori, konfigurasi) tersedia.

​
Tingkatkan Plugin di tempat

Peningkatan Plugin di tempat mempertahankan ID Plugin dan kunci konfigurasi yang sama, tetapi dapat memindahkan status pada disk ke tata letak saat ini. Panduan peningkatan khusus Plugin tersedia bersama salurannya:
  • Migrasi Matrix: batas pemulihan status terenkripsi, perilaku snapshot otomatis, dan perintah pemulihan manual.

​
Terkait