Przejdź do głównej treści

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