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 Claude lokal melalui penyedia migrasi Claude bawaan. Penyedia menampilkan pratinjau setiap item sebelum mengubah state, menyamarkan rahasia dalam rencana dan laporan, serta membuat cadangan terverifikasi sebelum diterapkan.
Impor onboarding memerlukan penyiapan OpenClaw yang baru. Jika Anda sudah memiliki state OpenClaw lokal, reset konfigurasi, kredensial, sesi, dan ruang kerja terlebih dahulu, atau gunakan openclaw migrate secara langsung dengan --overwrite setelah meninjau rencananya.

​
Dua cara untuk mengimpor

Wizard menawarkan Claude saat mendeteksi state Claude lokal.
openclaw onboard --flow import
Atau arahkan ke sumber tertentu:
openclaw onboard --import-from claude --import-source ~/.claude

​
Apa yang diimpor

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

​
Apa yang tetap hanya arsip

Penyedia menyalin ini ke laporan migrasi untuk peninjauan manual, tetapi tidak memuatnya ke konfigurasi OpenClaw aktif:
  • Hook Claude
  • Izin Claude dan allowlist alat yang luas
  • Default lingkungan Claude
  • CLAUDE.local.md
  • .claude/rules/
  • Subagen Claude di bawah .claude/agents/ atau ~/.claude/agents/
  • Cache, rencana, dan direktori riwayat proyek Claude Code
  • Ekstensi Claude Desktop dan kredensial yang disimpan OS
OpenClaw menolak menjalankan hook, memercayai allowlist izin, atau mendekode state kredensial OAuth dan Desktop yang buram secara otomatis. Pindahkan yang Anda perlukan secara manual setelah meninjau arsip.

​
Pemilihan sumber

Tanpa --from, OpenClaw memeriksa home Claude Code default di ~/.claude, file state Claude Code ~/.claude.json yang disampel, dan konfigurasi MCP Claude Desktop di macOS. Saat --from menunjuk ke root proyek, OpenClaw hanya mengimpor file Claude proyek tersebut seperti CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/, dan .mcp.json. Itu tidak membaca home Claude global Anda selama impor root proyek.

​
Alur yang direkomendasikan

1

Pratinjau rencana

openclaw migrate claude --dry-run
Rencana mencantumkan semua yang akan berubah, termasuk konflik, item yang dilewati, dan nilai sensitif yang disamarkan dari field MCP env atau headers bersarang.
2

Terapkan dengan cadangan

openclaw migrate apply claude --yes
OpenClaw membuat dan memverifikasi cadangan sebelum menerapkan.
3

Jalankan doctor

openclaw doctor
Doctor memeriksa masalah konfigurasi atau state setelah impor.
4

Mulai ulang dan verifikasi

openclaw gateway restart
openclaw status
Pastikan Gateway sehat dan instruksi, server MCP, serta Skills yang diimpor sudah dimuat.

​
Penanganan konflik

Penerapan menolak melanjutkan saat rencana melaporkan konflik (file atau nilai konfigurasi sudah ada di target).
Jalankan ulang dengan --overwrite hanya saat penggantian target yang ada memang disengaja. Penyedia mungkin tetap menulis cadangan 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 penyiapan yang sudah memiliki editan pengguna.

​
Output JSON untuk otomatisasi

openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
Dengan --json dan tanpa --yes, penerapan mencetak rencana dan tidak mengubah state. Ini adalah mode paling aman untuk CI dan skrip bersama.

​
Pemecahan masalah

Teruskan --from /actual/path (CLI) atau --import-source /actual/path (onboarding).
Impor onboarding memerlukan penyiapan baru. Reset state lalu onboarding ulang, atau gunakan openclaw migrate apply claude secara langsung, yang mendukung --overwrite dan kontrol cadangan eksplisit.
Claude Desktop membaca claude_desktop_config.json dari path khusus platform. Arahkan --from ke direktori file tersebut jika OpenClaw tidak mendeteksinya secara otomatis.
Ini sesuai desain. Perintah Claude dipicu pengguna, jadi OpenClaw mengimpornya sebagai Skills dengan disable-model-invocation: true. Edit frontmatter setiap Skill jika Anda ingin agen memanggilnya secara otomatis.

​
Terkait