OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Bermigrasi dari Claude

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.

Dua cara untuk mengimpor

Wisaya orientasi

Wisaya menawarkan Claude ketika mendeteksi status Claude lokal.

bash
openclaw onboard --flow import

Atau arahkan ke sumber tertentu:

bash
openclaw onboard --import-from claude --import-source ~/.claude

CLI

Gunakan openclaw migrate untuk eksekusi berskrip atau berulang. Lihat openclaw migrate untuk referensi lengkap.

bash
openclaw migrate claude --dry-runopenclaw migrate apply claude --yes

Tambahkan --from <path> untuk mengimpor direktori utama Claude Code atau akar proyek tertentu.

Yang diimpor

Instruksi dan memori
  • 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.
Server MCP

Definisi server MCP diimpor dari .mcp.json proyek, ~/.claude.json Claude Code, dan claude_desktop_config.json Claude Desktop jika tersedia.

Skills dan perintah
  • 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

  • Pratinjau rencana

    bash
    openclaw migrate claude --dry-run

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

  • Terapkan dengan cadangan

    bash
    openclaw migrate apply claude --yes

    OpenClaw membuat dan memverifikasi cadangan sebelum menerapkan perubahan.

  • Jalankan doctor

    bash
    openclaw doctor

    Doctor memeriksa masalah konfigurasi atau status setelah impor.

  • Mulai ulang dan verifikasi

    bash
    openclaw gateway restartopenclaw status

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

    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

    bash
    openclaw migrate claude --dry-run --jsonopenclaw migrate apply claude --json --yes

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

    Status Claude berada di luar ~/.claude

    Teruskan --from /actual/path (CLI) atau --import-source /actual/path (orientasi).

    Orientasi menolak mengimpor pada penyiapan yang sudah ada

    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.

    Server MCP dari Claude Desktop tidak diimpor

    Claude Desktop membaca claude_desktop_config.json dari jalur khusus platform. Arahkan --from ke direktori berkas tersebut jika OpenClaw tidak mendeteksinya secara otomatis.

    Perintah Claude menjadi Skills dengan pemanggilan model dinonaktifkan

    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

    Was this useful?
    On this page

    On this page