Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Impor dari sistem agen lain

Gunakan penyedia migrasi bawaan untuk membawa instruksi, server MCP, Skills, konfigurasi model, dan (opsional) kunci API ke OpenClaw. Rencana dipratinjau sebelum perubahan apa pun, rahasia disunting dalam laporan, dan penerapan didukung oleh cadangan terverifikasi.

Migrasi dari Claude

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

Migrasi dari Hermes

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

​
Pindahkan OpenClaw ke mesin baru

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

​
Langkah migrasi

1

Hentikan gateway dan buat cadangan

Di mesin lama, hentikan Gateway agar file tidak berubah saat penyalinan berlangsung, 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 berikutnya.
3

Salin direktori status dan workspace

Transfer arsip melalui scp, rsync -a, atau drive eksternal, lalu ekstrak:
cd ~
tar -xzf openclaw-state.tgz
Pastikan direktori tersembunyi 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
Jika Telegram atau Discord menggunakan fallback env default (TELEGRAM_BOT_TOKEN atau DISCORD_BOT_TOKEN), verifikasi bahwa .env direktori status yang dimigrasikan berisi kunci tersebut tanpa mencetak nilai rahasianya: 
awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env
openclaw doctor juga memperingatkan saat akun Telegram atau Discord default yang diaktifkan tidak memiliki token yang dikonfigurasi dan variabel env yang cocok tidak tersedia untuk proses doctor.

​
Kendala umum

Jika Gateway lama menggunakan --profile atau OPENCLAW_STATE_DIR dan yang baru tidak, channel akan tampak keluar dan sesi akan kosong. Jalankan Gateway dengan profil atau state-dir yang sama dengan yang Anda migrasikan, lalu jalankan ulang openclaw doctor.
File konfigurasi saja tidak cukup. Profil autentikasi model berada di bawah agents/<agentId>/agent/auth-profiles.json, dan status channel serta penyedia berada di bawah credentials/. Selalu migrasikan direktori status secara keseluruhan.
Jika Anda menyalin sebagai root atau beralih pengguna, Gateway mungkin gagal membaca kredensial. Pastikan direktori status dan workspace dimiliki oleh pengguna yang menjalankan Gateway.
Jika UI Anda mengarah ke Gateway jarak jauh, host jarak jauh memiliki sesi dan workspace. Migrasikan host Gateway itu sendiri, bukan laptop lokal Anda. Lihat FAQ.
Direktori status berisi profil autentikasi, kredensial channel, dan status penyedia lainnya. Simpan cadangan secara terenkripsi, hindari channel transfer yang tidak aman, dan rotasi kunci jika Anda mencurigai adanya paparan.

​
Daftar periksa verifikasi

Di mesin baru, konfirmasikan:
  • openclaw status menunjukkan Gateway berjalan.
  • Channel masih tersambung (tidak perlu pairing ulang).
  • Dasbor terbuka dan menampilkan sesi yang sudah ada.
  • File workspace (memori, konfigurasi) tersedia.

​
Mutakhirkan Plugin di tempat

Pemutakhiran Plugin di tempat mempertahankan id Plugin dan kunci konfigurasi yang sama, tetapi dapat memindahkan status di disk ke tata letak saat ini. Panduan pemutakhiran khusus Plugin berada bersama channel-nya:
  • Migrasi Matrix: batas pemulihan status terenkripsi, perilaku snapshot otomatis, dan perintah pemulihan manual.

​
Terkait