Langsung ke konten utama
OpenClaw mengimpor status Hermes melalui penyedia migrasi bawaan. Penyedia ini mempratinjau semuanya sebelum mengubah status, menyamarkan rahasia dalam rencana dan laporan, serta membuat cadangan terverifikasi sebelum menerapkan.
Impor memerlukan penyiapan OpenClaw yang baru. Jika Anda sudah memiliki status OpenClaw lokal, reset konfigurasi, kredensial, sesi, dan workspace terlebih dahulu, atau gunakan openclaw migrate langsung dengan --overwrite setelah meninjau rencana.

​
Dua cara untuk mengimpor

Jalur tercepat. Wizard mendeteksi Hermes di ~/.hermes dan menampilkan pratinjau sebelum menerapkan.
openclaw onboard --flow import
Atau arahkan ke sumber tertentu:
openclaw onboard --import-from hermes --import-source ~/.hermes

​
Yang diimpor

  • Pilihan model default dari config.yaml Hermes.
  • Penyedia model yang dikonfigurasi dan endpoint kustom yang kompatibel dengan OpenAI dari providers dan custom_providers.
Definisi server MCP dari mcp_servers atau mcp.servers.
  • SOUL.md dan AGENTS.md disalin ke workspace agen OpenClaw.
  • memories/MEMORY.md dan memories/USER.md ditambahkan ke file memori OpenClaw yang sesuai, bukan menimpanya.
Default konfigurasi memori untuk memori file OpenClaw. Penyedia memori eksternal seperti Honcho dicatat sebagai item arsip atau peninjauan manual agar Anda dapat memindahkannya secara sengaja.
Skills dengan file SKILL.md di bawah skills/<name>/ disalin, beserta nilai konfigurasi per-Skills dari skills.config.
openclaw migrate interaktif bertanya sebelum mengimpor kredensial auth, dengan ya dipilih secara default. Impor yang diterima mencakup kredensial OAuth OpenAI OpenCode dari auth.json OpenCode, entri OpenCode dan GitHub Copilot dari auth.json OpenCode, serta kunci .env yang didukung. Entri OAuth auth.json Hermes adalah status legacy dan ditampilkan sebagai pekerjaan reauth/doctor manual, bukan diimpor ke auth aktif. Gunakan --include-secrets untuk impor kredensial openclaw migrate non-interaktif, --no-auth-credentials untuk melewatinya, atau onboarding --import-secrets saat mengimpor dari wizard onboarding.

​
Yang tetap hanya arsip

Penyedia menyalin ini ke direktori laporan migrasi untuk peninjauan manual, tetapi tidak memuatnya ke konfigurasi atau kredensial OpenClaw aktif:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
OpenClaw menolak mengeksekusi atau memercayai status ini secara otomatis karena format dan asumsi kepercayaan dapat bergeser antar sistem. Pindahkan yang Anda butuhkan secara manual setelah meninjau arsip.

​
Alur yang direkomendasikan

1

Pratinjau rencana

openclaw migrate hermes --dry-run
Rencana mencantumkan semua yang akan berubah, termasuk konflik, item yang dilewati, dan item sensitif apa pun. Output rencana menyamarkan kunci bertingkat yang terlihat seperti rahasia.
2

Terapkan dengan cadangan

openclaw migrate apply hermes --yes
OpenClaw membuat dan memverifikasi cadangan sebelum menerapkan. Contoh non-interaktif ini mengimpor status non-rahasia. Jalankan tanpa --yes untuk menjawab prompt kredensial, atau tambahkan --include-secrets untuk menyertakan kredensial yang didukung dalam eksekusi tanpa pengawasan.
3

Jalankan doctor

openclaw doctor
Doctor menerapkan ulang migrasi konfigurasi yang tertunda dan memeriksa masalah yang muncul selama impor.
4

Mulai ulang dan verifikasi

openclaw gateway restart
openclaw status
Pastikan Gateway sehat dan model, memori, serta Skills yang diimpor sudah dimuat.

​
Penanganan konflik

Penerapan menolak melanjutkan saat rencana melaporkan konflik (file atau nilai konfigurasi sudah ada di target).
Jalankan ulang dengan --overwrite hanya saat mengganti target yang ada memang disengaja. Penyedia mungkin tetap menulis cadangan tingkat item untuk file yang ditimpa di direktori laporan migrasi.
Untuk instalasi OpenClaw baru, konflik jarang terjadi. Biasanya konflik muncul saat Anda menjalankan ulang impor pada penyiapan yang sudah memiliki editan pengguna. Jika konflik muncul di tengah penerapan (misalnya, race tak terduga pada file konfigurasi), Hermes menandai item konfigurasi dependen yang tersisa sebagai skipped dengan alasan blocked by earlier apply conflict, bukan menuliskannya sebagian. Laporan migrasi mencatat setiap item yang diblokir sehingga Anda dapat menyelesaikan konflik asli dan menjalankan ulang impor.

​
Rahasia

openclaw migrate interaktif bertanya apakah akan mengimpor kredensial auth yang terdeteksi, dengan ya dipilih secara default.
  • Menerima prompt mengimpor kredensial OAuth OpenAI OpenCode dari auth.json OpenCode, entri OpenCode dan GitHub Copilot dari auth.json OpenCode, serta kunci .env yang didukung. Entri OAuth auth.json Hermes dilaporkan untuk reauth OpenAI manual atau perbaikan doctor.
  • Gunakan --no-auth-credentials atau pilih tidak pada prompt untuk hanya mengimpor status non-rahasia.
  • Gunakan --include-secrets saat menjalankan tanpa pengawasan dengan --yes.
  • Gunakan onboarding --import-secrets saat mengimpor kredensial dari wizard onboarding.
  • Untuk kredensial yang dikelola SecretRef, konfigurasikan sumber SecretRef setelah impor selesai.

​
Output JSON untuk automasi

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
Dengan --json dan tanpa --yes, penerapan mencetak rencana dan tidak mengubah status. Ini adalah mode paling aman untuk CI dan skrip bersama.

​
Pemecahan masalah

Periksa output rencana. Setiap konflik mengidentifikasi path sumber dan target yang sudah ada. Putuskan per item apakah akan melewati, mengedit target, atau menjalankan ulang dengan --overwrite.
Berikan --from /actual/path (CLI) atau --import-source /actual/path (onboarding).
Impor onboarding memerlukan penyiapan baru. Reset status dan lakukan onboarding ulang, atau gunakan openclaw migrate apply hermes langsung, yang mendukung --overwrite dan kontrol cadangan eksplisit.
openclaw migrate interaktif mengimpor kunci API hanya saat Anda menerima prompt kredensial. Eksekusi --yes non-interaktif memerlukan --include-secrets; impor onboarding memerlukan --import-secrets. Hanya kunci .env yang didukung yang dikenali; variabel lain di .env diabaikan.

​
Terkait

  • openclaw migrate: referensi CLI lengkap, kontrak Plugin, dan bentuk JSON.
  • Onboarding: alur wizard dan flag non-interaktif.
  • Migrasi: memindahkan instalasi OpenClaw antar mesin.
  • Doctor: pemeriksaan kesehatan pascamigrasi.
  • Workspace agen: tempat SOUL.md, AGENTS.md, dan file memori berada.