OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Panduan migrasi

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.

Langkah-langkah migrasi

  • Hentikan Gateway dan buat cadangan

    Pada mesin lama, hentikan Gateway agar berkas tidak berubah saat penyalinan berlangsung, lalu arsipkan:

    bash
    openclaw gateway stopcd ~tar -czf openclaw-state.tgz .openclaw

    Jika Anda menggunakan beberapa profil (misalnya ~/.openclaw-work), arsipkan masing-masing secara terpisah.

  • 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.

  • Salin direktori status dan ruang kerja

    Transfer arsip melalui scp, rsync -a, atau drive eksternal, lalu ekstrak:

    bash
    cd ~tar -xzf openclaw-state.tgz

    Pastikan direktori tersembunyi telah disertakan dan kepemilikan berkas sesuai dengan pengguna yang akan menjalankan Gateway.

  • Jalankan Doctor dan verifikasi

    Pada mesin baru, jalankan Doctor untuk menerapkan migrasi konfigurasi dan memperbaiki layanan:

    bash
    openclaw doctoropenclaw gateway restartopenclaw status

    • 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:

    bash
    awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env

    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

    Ketidakcocokan profil atau direktori status

    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.

    Hanya menyalin openclaw.json

    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.

    Izin dan kepemilikan

    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.

    Mode jarak jauh

    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.

    Rahasia dalam cadangan

    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

    Was this useful?
    On this page

    On this page