Skip to main content
Penyedia migrasi Hermes bawaan mengikuti HERMES_HOME dan profil Hermes aktif, dengan fallback ke ~/.hermes di macOS/Linux atau %LOCALAPPDATA%\hermes di Windows. Penyedia ini menampilkan pratinjau setiap perubahan sebelum menerapkannya, menyamarkan rahasia dalam rencana dan laporan, serta membuat cadangan OpenClaw yang telah diverifikasi sebelum menyentuh apa pun. Jalur --from yang ditentukan secara eksplisit selalu diprioritaskan.
Impor memerlukan penyiapan OpenClaw baru. Jika Anda sudah memiliki status OpenClaw lokal, atur ulang konfigurasi, kredensial, sesi, dan ruang kerja terlebih dahulu, atau gunakan openclaw migrate apply hermes secara langsung dengan --overwrite setelah meninjau rencana.

​
Dua cara untuk mengimpor

Mendeteksi direktori utama/profil Hermes aktif dan menampilkan pratinjau sebelum menerapkan.
Atau arahkan ke sumber tertentu:

​
Yang diimpor

  • Pemilihan model default dari config.yaml Hermes.
  • Penyedia model yang dikonfigurasi dan endpoint khusus dari model, providers, dan custom_providers, termasuk transportasi Hermes Chat Completions, Codex Responses, dan Anthropic Messages saat ini.
Definisi server MCP dari mcp_servers atau mcp.servers, termasuk status dinonaktifkan, batas waktu, dukungan alat paralel, cakupan OAuth, bidang TLS yang kompatibel, serta kebijakan alat native/resource/prompt. Variabel lingkungan dan header literal memerlukan persetujuan impor kredensial. Pengaturan siklus hidup, sampling, elicitation, preflight, keepalive, bundel CA, kunci klien yang dilindungi kata sandi, dan klien OAuth yang telah didaftarkan sebelumnya yang hanya tersedia di Hermes menjadi item tinjauan manual, bukan konfigurasi OpenClaw yang tidak valid.
  • SOUL.md dan AGENTS.md disalin ke ruang kerja agen OpenClaw.
  • memories/MEMORY.md dan memories/USER.md ditambahkan ke file memori OpenClaw yang sesuai, bukan menimpanya.
  • Permukaan khusus memori berperilaku berbeda: halaman memori orientasi dan halaman impor Memory di Control UI menyalin kedua file ini ke bawah memory/imports/hermes/ untuk pemanggilan kembali terindeks dan membiarkan memori ruang kerja yang ada tetap tidak tersentuh.
Default konfigurasi memori untuk memori file OpenClaw. Penyedia memori eksternal seperti Honcho dicatat sebagai item arsip atau tinjauan manual agar Anda dapat memindahkannya secara sengaja.
Skills yang memiliki file SKILL.md di mana pun di bawah skills/ ditemukan secara rekursif, diratakan ke dalam direktori skill ruang kerja OpenClaw, dan disalin beserta file pendukungnya. Nilai konfigurasi per skill dari skills.config dipertahankan.
openclaw migrate interaktif meminta konfirmasi sebelum mengimpor kredensial autentikasi, dengan ya dipilih secara default. Impor yang diterima mencakup entri OAuth OpenAI Codex Hermes saat ini, entri OAuth OpenAI dan GitHub Copilot OpenCode, serta kunci .env Hermes yang didukung. Gunakan --include-secrets untuk impor noninteraktif, --no-auth-credentials untuk melewati kredensial, atau flag --import-secrets pada orientasi. Setelah mengimpor OAuth Hermes, jangan biarkan Hermes dan OpenClaw menggunakan grant penyegaran yang sama; autentikasi ulang salah satu pihak sebelum menjalankan keduanya.

​
Yang tetap hanya berupa arsip

Penyedia menyalin hal-hal berikut ke direktori laporan migrasi untuk ditinjau secara manual, tetapi tidak memuatnya ke konfigurasi atau kredensial OpenClaw aktif:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • plans/, workspace/, skins/, dan kanban/
  • Penyimpanan pairing/ dan platforms/, serta status perutean/proses Gateway
  • state.db, hermes_state.db, projects.db, response_store.db, memory_store.db, verification_evidence.db, kanban.db, dan retaindb_queue.db
OpenClaw menolak menjalankan atau memercayai status ini secara otomatis karena format dan asumsi kepercayaan dapat berbeda antar sistem. Pindahkan secara manual hal yang Anda perlukan setelah meninjau arsip.

​
Alur yang direkomendasikan

1

Pratinjau rencana

Rencana mencantumkan semua hal yang akan berubah, termasuk konflik, item yang dilewati, dan item sensitif. Kunci bertingkat yang tampak seperti rahasia disamarkan dalam keluaran.
2

Terapkan dengan cadangan

OpenClaw membuat dan memverifikasi cadangan sebelum menerapkan. Contoh noninteraktif ini hanya mengimpor status nonrahasia. Jalankan tanpa --yes untuk menjawab permintaan kredensial secara interaktif, atau tambahkan --include-secrets untuk menyertakan kredensial yang didukung dalam eksekusi tanpa pengawasan.
3

Jalankan doctor

Doctor menerapkan kembali migrasi konfigurasi yang tertunda dan memeriksa masalah yang timbul selama impor.
4

Mulai ulang dan verifikasi

Pastikan Gateway dalam kondisi sehat dan model, memori, serta skill yang diimpor telah dimuat.

​
Penanganan konflik

Penerapan menolak melanjutkan ketika rencana melaporkan konflik (file atau nilai konfigurasi sudah ada di target).
Jalankan ulang dengan --overwrite hanya jika penggantian target yang ada memang disengaja. Penyedia mungkin tetap menulis cadangan tingkat item untuk file yang ditimpa ke direktori laporan migrasi.
Konflik jarang terjadi pada instalasi baru. Konflik biasanya muncul ketika Anda menjalankan ulang impor terhadap penyiapan yang sudah memiliki perubahan pengguna. Jika konflik muncul di tengah penerapan (misalnya, kondisi berpacu yang tidak terduga pada file konfigurasi), item tersebut dilaporkan sebagai konflik sementara file, skill, kredensial, arsip, dan entri konfigurasi yang independen tetap dilanjutkan. Selesaikan item yang berkonflik dan jalankan ulang impor; impor memori yang identik bersifat idempoten.

​
Rahasia

openclaw migrate interaktif menanyakan apakah kredensial autentikasi yang terdeteksi akan diimpor, dengan ya dipilih secara default.
  • Menerima akan mengimpor entri OAuth OpenAI Codex Hermes saat ini, entri OAuth OpenAI dan GitHub Copilot OpenCode, serta kunci .env yang didukung.
  • Gunakan --no-auth-credentials, atau jawab tidak pada permintaan, untuk hanya mengimpor status nonrahasia.
  • Gunakan --include-secrets untuk mengimpor kredensial dalam eksekusi --yes tanpa pengawasan.
  • Gunakan flag --import-secrets milik wizard orientasi untuk mengimpor kredensial dari wizard.

​
Keluaran JSON untuk otomatisasi

Dengan --json dan tanpa --yes, penerapan mencetak rencana dan tidak mengubah status — mode teraman untuk CI dan skrip bersama.

​
Pemecahan masalah

Periksa keluaran rencana. Setiap konflik mengidentifikasi jalur sumber dan target yang sudah ada. Tentukan untuk setiap item apakah akan melewatinya, mengedit target, atau menjalankan ulang dengan --overwrite.
Berikan --from /actual/path (CLI) atau --import-source /actual/path (orientasi).
Impor melalui orientasi memerlukan penyiapan baru. Atur ulang status dan lakukan orientasi ulang, atau gunakan openclaw migrate apply hermes secara langsung, yang mendukung --overwrite dan kontrol cadangan eksplisit.
openclaw migrate interaktif hanya mengimpor kunci API ketika Anda menerima permintaan kredensial. Eksekusi --yes noninteraktif memerlukan --include-secrets; impor melalui orientasi memerlukan --import-secrets. Hanya kunci .env yang didukung yang dikenali — variabel .env lainnya diabaikan.

​
Terkait

  • openclaw migrate: referensi CLI lengkap, kontrak Plugin, dan bentuk JSON.
  • Orientasi: alur wizard dan flag noninteraktif.
  • Migrasi: memindahkan instalasi OpenClaw antarmesin.
  • Doctor: pemeriksaan kesehatan pascamigrasi.
  • Ruang kerja agen: lokasi SOUL.md, AGENTS.md, dan file memori.