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 mengimpor state Hermes melalui penyedia migrasi bawaan. Penyedia ini meninjau semuanya sebelum mengubah state, menyamarkan secret dalam rencana dan laporan, serta membuat backup terverifikasi sebelum apply.
Impor memerlukan setup OpenClaw yang baru. Jika Anda sudah memiliki state OpenClaw lokal, reset config, credentials, sessions, dan workspace terlebih dahulu, atau gunakan openclaw migrate secara langsung dengan --overwrite setelah meninjau rencananya.

​
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

​
Apa yang diimpor

  • Pilihan model default dari Hermes config.yaml.
  • 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 config memori untuk memori file OpenClaw. Penyedia memori eksternal seperti Honcho dicatat sebagai item arsip atau tinjauan manual agar Anda dapat memindahkannya secara sengaja.
Skills dengan file SKILL.md di bawah skills/<name>/ disalin, bersama dengan nilai config per skill dari skills.config.
Atur --include-secrets untuk mengimpor kunci .env yang didukung: OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY. Tanpa flag tersebut, secret tidak pernah disalin.

​
Yang tetap hanya diarsipkan

Penyedia menyalin ini ke direktori laporan migrasi untuk tinjauan manual, tetapi tidak memuatnya ke config atau credentials OpenClaw live:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • auth.json
  • state.db
OpenClaw menolak mengeksekusi atau memercayai state 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

Tinjau rencana

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

Terapkan dengan backup

openclaw migrate apply hermes --yes
OpenClaw membuat dan memverifikasi backup sebelum menerapkan. Jika Anda perlu mengimpor kunci API, tambahkan --include-secrets.
3

Jalankan doctor

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

Restart dan verifikasi

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

​
Penanganan konflik

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

​
Secret

Secret tidak pernah diimpor secara default.
  • Jalankan openclaw migrate apply hermes --yes terlebih dahulu untuk mengimpor state non-secret.
  • Jika Anda juga ingin kunci .env yang didukung disalin, jalankan ulang dengan --include-secrets.
  • Untuk credentials yang dikelola SecretRef, konfigurasikan sumber SecretRef setelah impor selesai.

​
Output JSON untuk otomasi

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
Dengan --json dan tanpa --yes, apply mencetak rencana dan tidak mengubah state. 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 setup baru. Reset state dan lakukan onboarding ulang, atau gunakan openclaw migrate apply hermes secara langsung, yang mendukung --overwrite dan kontrol backup eksplisit.
--include-secrets wajib digunakan, dan hanya kunci yang tercantum di atas 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.