Przejdź do głównej treści
OpenClaw importuje lokalny stan Claude przez dołączonego dostawcę migracji Claude. Dostawca pokazuje podgląd każdego elementu przed zmianą stanu, redaguje sekrety w planach i raportach oraz tworzy zweryfikowaną kopię zapasową przed zastosowaniem zmian.
Importy podczas wdrażania wymagają świeżej konfiguracji OpenClaw. Jeśli masz już lokalny stan OpenClaw, najpierw zresetuj konfigurację, poświadczenia, sesje i przestrzeń roboczą albo użyj bezpośrednio openclaw migrate z --overwrite po sprawdzeniu planu.

​
Dwa sposoby importu

Kreator proponuje Claude, gdy wykryje lokalny stan Claude.
openclaw onboard --flow import
Albo wskaż konkretne źródło:
openclaw onboard --import-from claude --import-source ~/.claude

​
Co jest importowane

  • Zawartość projektu CLAUDE.md i .claude/CLAUDE.md jest kopiowana lub dołączana do AGENTS.md w przestrzeni roboczej agenta OpenClaw.
  • Zawartość użytkownika ~/.claude/CLAUDE.md jest dołączana do USER.md w przestrzeni roboczej.
Definicje serwerów MCP są importowane z projektu .mcp.json, Claude Code ~/.claude.json oraz Claude Desktop claude_desktop_config.json, gdy są obecne.
  • Claude Skills z plikiem SKILL.md są kopiowane do katalogu Skills przestrzeni roboczej OpenClaw.
  • Pliki Markdown poleceń Claude w .claude/commands/ lub ~/.claude/commands/ są konwertowane na OpenClaw Skills z disable-model-invocation: true.

​
Co pozostaje tylko w archiwum

Dostawca kopiuje te elementy do raportu migracji do ręcznego przeglądu, ale nie ładuje ich do aktywnej konfiguracji OpenClaw:
  • hooki Claude
  • uprawnienia Claude i szerokie listy dozwolonych narzędzi
  • domyślne wartości środowiska Claude
  • CLAUDE.local.md
  • .claude/rules/
  • podagenci Claude w .claude/agents/ lub ~/.claude/agents/
  • katalogi pamięci podręcznej, planów i historii projektu Claude Code
  • rozszerzenia Claude Desktop i poświadczenia przechowywane przez system operacyjny
OpenClaw odmawia automatycznego wykonywania hooków, ufania listom dozwolonych uprawnień albo dekodowania nieprzezroczystego stanu poświadczeń OAuth i Desktop. Przenieś potrzebne elementy ręcznie po sprawdzeniu archiwum.

​
Wybór źródła

Bez --from OpenClaw sprawdza domyślny katalog domowy Claude Code w ~/.claude, przykładowy plik stanu Claude Code ~/.claude.json oraz konfigurację MCP Claude Desktop na macOS. Gdy --from wskazuje katalog główny projektu, OpenClaw importuje tylko pliki Claude tego projektu, takie jak CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ i .mcp.json. Podczas importu z katalogu głównego projektu nie odczytuje globalnego katalogu domowego Claude.

​
Zalecany przepływ

1

Podejrzyj plan

openclaw migrate claude --dry-run
Plan wymienia wszystko, co zostanie zmienione, w tym konflikty, pominięte elementy i wartości wrażliwe zredagowane z zagnieżdżonych pól MCP env lub headers.
2

Zastosuj z kopią zapasową

openclaw migrate apply claude --yes
OpenClaw tworzy i weryfikuje kopię zapasową przed zastosowaniem zmian.
3

Uruchom doctor

openclaw doctor
Doctor sprawdza problemy z konfiguracją lub stanem po imporcie.
4

Uruchom ponownie i zweryfikuj

openclaw gateway restart
openclaw status
Potwierdź, że gateway działa poprawnie, a zaimportowane instrukcje, serwery MCP i Skills są załadowane.

​
Obsługa konfliktów

Zastosowanie zmian odmawia kontynuowania, gdy plan zgłasza konflikty (plik lub wartość konfiguracji już istnieje w miejscu docelowym).
Uruchom ponownie z --overwrite tylko wtedy, gdy zastąpienie istniejącego celu jest zamierzone. Dostawcy nadal mogą zapisywać kopie zapasowe na poziomie elementów dla nadpisanych plików w katalogu raportu migracji.
W świeżej instalacji OpenClaw konflikty są nietypowe. Zwykle pojawiają się, gdy ponownie uruchamiasz import w konfiguracji, która ma już edycje użytkownika.

​
Wynik JSON do automatyzacji

openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
Z --json i bez --yes zastosowanie zmian wypisuje plan i nie modyfikuje stanu. To najbezpieczniejszy tryb dla CI i współdzielonych skryptów.

​
Rozwiązywanie problemów

Przekaż --from /actual/path (CLI) albo --import-source /actual/path (wdrażanie).
Importy podczas wdrażania wymagają świeżej konfiguracji. Zresetuj stan i ponownie przejdź wdrażanie albo użyj bezpośrednio openclaw migrate apply claude, które obsługuje --overwrite i jawną kontrolę kopii zapasowej.
Claude Desktop odczytuje claude_desktop_config.json ze ścieżki specyficznej dla platformy. Wskaż --from na katalog tego pliku, jeśli OpenClaw nie wykrył go automatycznie.
Zgodnie z projektem. Polecenia Claude są uruchamiane przez użytkownika, więc OpenClaw importuje je jako Skills z disable-model-invocation: true. Edytuj frontmatter każdego Skill, jeśli chcesz, aby agent wywoływał je automatycznie.

​
Powiązane