Skip to main content
OpenClaw mengimpor status Claude lokal melalui penyedia migrasi Claude bawaan. Penyedia ini menampilkan pratinjau setiap item sebelum mengubah status, menyamarkan rahasia dalam rencana dan laporan, serta membuat cadangan terverifikasi sebelum penerapan.
Impor orientasi 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 secara langsung dengan --overwrite setelah meninjau rencana.

​
Dua cara untuk mengimpor

Wisaya menawarkan Claude ketika mendeteksi status Claude lokal.
Atau arahkan ke sumber tertentu:

​
Yang diimpor

  • Konten CLAUDE.md dan .claude/CLAUDE.md proyek disalin atau ditambahkan ke AGENTS.md di ruang kerja agen OpenClaw.
  • Konten ~/.claude/CLAUDE.md pengguna ditambahkan ke USER.md di ruang kerja.
Definisi server MCP diimpor dari .mcp.json proyek, ~/.claude.json Claude Code, dan claude_desktop_config.json Claude Desktop jika tersedia.
  • Skills Claude yang memiliki berkas SKILL.md disalin ke direktori Skills di ruang kerja OpenClaw.
  • Berkas Markdown perintah Claude di bawah .claude/commands/ atau ~/.claude/commands/ dikonversi menjadi Skills OpenClaw dengan disable-model-invocation: true.

​
Yang hanya disimpan sebagai arsip

Penyedia menyalin item berikut ke laporan migrasi untuk ditinjau secara manual, tetapi tidak memuatnya ke konfigurasi aktif OpenClaw:
  • Hook Claude
  • Izin Claude dan daftar luas alat yang diizinkan
  • Nilai bawaan lingkungan Claude
  • CLAUDE.local.md
  • .claude/rules/
  • Subagen Claude di bawah .claude/agents/ atau ~/.claude/agents/
  • Direktori cache, rencana, dan riwayat proyek Claude Code
  • Ekstensi Claude Desktop dan kredensial yang disimpan oleh sistem operasi
OpenClaw menolak mengeksekusi hook, memercayai daftar izin, atau secara otomatis mendekode status kredensial OAuth dan Desktop yang tidak transparan. Pindahkan secara manual hal-hal yang Anda perlukan setelah meninjau arsip.

​
Pemilihan sumber

Tanpa --from, OpenClaw memeriksa direktori utama Claude Code bawaan di ~/.claude, berkas status sampel Claude Code ~/.claude.json, dan konfigurasi MCP Claude Desktop di macOS. Ketika --from mengarah ke akar proyek, OpenClaw hanya mengimpor berkas Claude milik proyek tersebut, seperti CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/, dan .mcp.json. OpenClaw tidak membaca direktori utama Claude global Anda selama impor dari akar proyek.

​
Alur yang direkomendasikan

1

Pratinjau rencana

Rencana mencantumkan semua hal yang akan berubah, termasuk konflik, item yang dilewati, dan nilai sensitif yang disamarkan dari bidang MCP env atau headers bertingkat.
2

Terapkan dengan cadangan

OpenClaw membuat dan memverifikasi cadangan sebelum menerapkan perubahan.
3

Jalankan doctor

Doctor memeriksa masalah konfigurasi atau status setelah impor.
4

Mulai ulang dan verifikasi

Pastikan Gateway berfungsi dengan baik dan instruksi, server MCP, serta Skills yang diimpor telah dimuat.

​
Penanganan konflik

Penerapan menolak melanjutkan ketika rencana melaporkan konflik (berkas atau nilai konfigurasi sudah ada di target).
Jalankan kembali dengan --overwrite hanya jika Anda memang bermaksud mengganti target yang sudah ada. Penyedia mungkin tetap menulis cadangan tingkat item untuk berkas yang ditimpa ke direktori laporan migrasi.
Pada instalasi OpenClaw baru, konflik jarang terjadi. Konflik biasanya muncul ketika Anda menjalankan ulang impor pada penyiapan yang sudah memiliki perubahan pengguna.

​
Keluaran JSON untuk otomatisasi

--yes wajib digunakan untuk migrate apply di luar terminal interaktif; tanpanya, OpenClaw menghasilkan kesalahan alih-alih menerapkan perubahan, sehingga skrip dan CI harus meneruskan --yes secara eksplisit. Tampilkan pratinjau terlebih dahulu dengan --dry-run --json, lalu terapkan dengan --json --yes setelah rencana terlihat benar.

​
Pemecahan masalah

Teruskan --from /actual/path (CLI) atau --import-source /actual/path (orientasi).
Impor orientasi memerlukan penyiapan baru. Atur ulang status dan jalankan kembali orientasi, atau gunakan openclaw migrate apply claude secara langsung, yang mendukung --overwrite dan kontrol cadangan eksplisit.
Claude Desktop membaca claude_desktop_config.json dari jalur khusus platform. Arahkan --from ke direktori berkas tersebut jika OpenClaw tidak mendeteksinya secara otomatis.
Ini memang disengaja. Perintah Claude dipicu oleh pengguna, sehingga OpenClaw mengimpornya sebagai Skills dengan disable-model-invocation: true. Edit frontmatter setiap Skill jika Anda ingin agen memanggilnya secara otomatis.

​
Terkait