# openclaw migrate

Impor status dari sistem agen lain melalui penyedia migrasi yang dimiliki plugin. Penyedia bawaan mencakup status Codex CLI, Claude, dan Hermes; plugin pihak ketiga dapat mendaftarkan penyedia tambahan.

# Perintah

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> Nama penyedia migrasi terdaftar, misalnya hermes. Jalankan openclaw migrate list untuk melihat penyedia yang terinstal.

--dry-runboolean

Buat rencana lalu keluar tanpa mengubah status.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> Timpa direktori status sumber. Hermes secara default menggunakan ~/.hermes.

--include-secretsboolean

Impor kredensial yang didukung. Nonaktif secara default.

--overwriteboolean

Izinkan penerapan mengganti target yang ada ketika rencana melaporkan konflik.

--yesboolean

Lewati prompt konfirmasi. Diperlukan dalam mode noninteraktif.

"--skill

--no-backupboolean

Lewati cadangan prapenerapan. Memerlukan --force ketika status OpenClaw lokal ada.

--forceboolean

Diperlukan bersama --no-backup ketika penerapan semestinya menolak melewati cadangan.

--jsonboolean

Cetak rencana atau hasil penerapan sebagai JSON. Dengan --json dan tanpa --yes, penerapan mencetak rencana dan tidak mengubah status.

# Model keamanan

openclaw migrate mengutamakan pratinjau.

# Penyedia Claude

Penyedia Claude bawaan mendeteksi status Claude Code di ~/.claude secara default. Gunakan --from <path> untuk mengimpor home atau root proyek Claude Code tertentu.

# Yang diimpor Claude

• CLAUDE.md proyek dan .claude/CLAUDE.md ke dalam ruang kerja agen OpenClaw.
• ~/.claude/CLAUDE.md pengguna ditambahkan ke USER.md ruang kerja.
• Definisi server MCP dari .mcp.json proyek, ~/.claude.json Claude Code, dan claude_desktop_config.json Claude Desktop.
• Direktori skill Claude yang menyertakan SKILL.md.
• File Markdown perintah Claude dikonversi menjadi skill OpenClaw dengan pemanggilan manual saja.

# Status arsip dan tinjauan manual

Hook, izin, default lingkungan, memori lokal, aturan bercakupan jalur, subagen, cache, rencana, dan riwayat proyek Claude dipertahankan dalam laporan migrasi atau dilaporkan sebagai item tinjauan manual. OpenClaw tidak menjalankan hook, menyalin allowlist luas, atau mengimpor status kredensial OAuth/Desktop secara otomatis.

# Penyedia Codex

Penyedia Codex bawaan mendeteksi status Codex CLI di ~/.codex secara default, atau di CODEX_HOME ketika variabel lingkungan tersebut diatur. Gunakan --from <path> untuk menginventarisasi home Codex tertentu.

Gunakan penyedia ini saat berpindah ke harness Codex OpenClaw dan Anda ingin mempromosikan aset Codex CLI pribadi yang berguna secara sengaja. Peluncuran server aplikasi Codex lokal menggunakan direktori CODEX_HOME dan HOME per agen, sehingga secara default tidak membaca status Codex CLI pribadi Anda.

Menjalankan openclaw migrate codex di terminal interaktif menampilkan pratinjau rencana lengkap, lalu membuka pemilih kotak centang untuk item salinan skill sebelum konfirmasi penerapan final. Gunakan Toggle all on atau Toggle all off untuk pilihan massal; skill yang direncanakan dimulai dalam keadaan dicentang, skill konflik dimulai tanpa dicentang, dan Skip for now membiarkan skill tidak berubah tanpa menerapkan. Untuk proses terskrip atau eksekusi yang presisi, berikan --skill <name> sekali per skill, misalnya:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

# Yang diimpor Codex

• Direktori skill Codex CLI di bawah $CODEX_HOME/skills, tidak termasuk cache .system Codex.
• AgentSkills pribadi di bawah $HOME/.agents/skills, disalin ke ruang kerja agen OpenClaw saat Anda menginginkan kepemilikan per agen.

# Status Codex tinjauan manual

Plugin native Codex, config.toml, dan hooks/hooks.json native tidak diaktifkan secara otomatis. Plugin dapat mengekspos server MCP, aplikasi, hook, atau perilaku lain yang dapat dieksekusi, sehingga penyedia melaporkannya untuk ditinjau alih-alih memuatnya ke dalam OpenClaw. File konfigurasi dan hook disalin ke laporan migrasi untuk tinjauan manual.

# Penyedia Hermes

Penyedia Hermes bawaan mendeteksi status di ~/.hermes secara default. Gunakan --from <path> ketika Hermes berada di tempat lain.

# Yang diimpor Hermes

• Konfigurasi model default dari config.yaml.
• Penyedia model yang dikonfigurasi dan endpoint kompatibel OpenAI khusus dari providers dan custom_providers.
• Definisi server MCP dari mcp_servers atau mcp.servers.
• SOUL.md dan AGENTS.md ke dalam ruang kerja agen OpenClaw.
• memories/MEMORY.md dan memories/USER.md ditambahkan ke file memori ruang kerja.
• Default konfigurasi memori untuk memori file OpenClaw, ditambah item arsip atau tinjauan manual untuk penyedia memori eksternal seperti Honcho.
• Skills yang menyertakan file SKILL.md di bawah skills/<name>/.
• Nilai konfigurasi per skill dari skills.config.
• Kunci API yang didukung dari .env, hanya dengan --include-secrets.

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

# Status khusus arsip

Status Hermes yang tidak dapat diinterpretasikan OpenClaw dengan aman disalin ke laporan migrasi untuk tinjauan manual, tetapi tidak dimuat ke konfigurasi atau kredensial OpenClaw aktif. Ini mempertahankan status yang buram atau tidak aman tanpa berpura-pura bahwa OpenClaw dapat menjalankan atau memercayainya secara otomatis:

• plugins/
• sessions/
• logs/
• cron/
• mcp-tokens/
• auth.json
• state.db

# Setelah menerapkan

openclaw doctor

# Kontrak Plugin

Sumber migrasi adalah plugin. Plugin mendeklarasikan id penyedianya di openclaw.plugin.json:

{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}

Saat runtime, plugin memanggil api.registerMigrationProvider(...). Penyedia mengimplementasikan detect, plan, dan apply. Core memiliki orkestrasi CLI, kebijakan cadangan, prompt, keluaran JSON, dan preflight konflik. Core meneruskan rencana yang telah ditinjau ke apply(ctx, plan), dan penyedia boleh membangun ulang rencana hanya ketika argumen tersebut tidak ada demi kompatibilitas.

Plugin penyedia dapat menggunakan openclaw/plugin-sdk/migration untuk konstruksi item dan jumlah ringkasan, serta openclaw/plugin-sdk/migration-runtime untuk salinan file yang sadar konflik, salinan laporan khusus arsip, wrapper runtime konfigurasi bercache, dan laporan migrasi.

# Integrasi onboarding

Onboarding dapat menawarkan migrasi ketika penyedia mendeteksi sumber yang dikenal. Baik openclaw onboard --flow import maupun openclaw setup --wizard --import-from hermes menggunakan penyedia migrasi plugin yang sama dan tetap menampilkan pratinjau sebelum menerapkan.

# Terkait

• Bermigrasi dari Hermes: panduan langkah demi langkah bagi pengguna.
• Bermigrasi dari Claude: panduan langkah demi langkah bagi pengguna.
• Bermigrasi: pindahkan OpenClaw ke mesin baru.
• Doctor: pemeriksaan kesehatan setelah menerapkan migrasi.
• Plugin: instalasi dan pendaftaran plugin.