Skip to main content
OpenClaw importuje lokalny stan Claude za pomocą dołączonego dostawcy migracji Claude. Dostawca wyświetla podgląd każdego elementu przed zmianą stanu, utajnia dane poufne w planach i raportach oraz tworzy zweryfikowaną kopię zapasową przed zastosowaniem zmian.
Import podczas wdrażania wymaga świeżej konfiguracji OpenClaw. Jeśli masz już lokalny stan OpenClaw, najpierw zresetuj konfigurację, dane uwierzytelniające, sesje i obszar roboczy albo użyj bezpośrednio polecenia openclaw migrate z opcją --overwrite po przejrzeniu planu.

​
Dwa sposoby importowania

Kreator oferuje import z Claude po wykryciu lokalnego stanu Claude.
Możesz też wskazać konkretne źródło:

​
Co jest importowane

  • Zawartość plików projektu CLAUDE.md i .claude/CLAUDE.md jest kopiowana lub dopisywana do pliku AGENTS.md w obszarze roboczym agenta OpenClaw.
  • Zawartość pliku użytkownika ~/.claude/CLAUDE.md jest dopisywana do pliku USER.md w obszarze roboczym.
Definicje serwerów MCP są importowane z pliku projektu .mcp.json, pliku Claude Code ~/.claude.json oraz pliku Claude Desktop claude_desktop_config.json, jeśli są dostępne.
  • Skills Claude zawierające plik SKILL.md są kopiowane do katalogu Skills w obszarze roboczym OpenClaw.
  • Pliki Markdown poleceń Claude znajdujące się w .claude/commands/ lub ~/.claude/commands/ są konwertowane na Skills OpenClaw z ustawieniem disable-model-invocation: true.

​
Co pozostaje wyłącznie w archiwum

Dostawca kopiuje poniższe elementy do raportu migracji w celu ręcznego przejrzenia, ale nie wczytuje ich do aktywnej konfiguracji OpenClaw:
  • hooki Claude
  • uprawnienia Claude i szerokie listy dozwolonych narzędzi
  • domyślne ustawienia środowiska Claude
  • CLAUDE.local.md
  • .claude/rules/
  • podagenci Claude w .claude/agents/ lub ~/.claude/agents/
  • katalogi pamięci podręcznej, planów i historii projektów Claude Code
  • rozszerzenia Claude Desktop i dane uwierzytelniające przechowywane przez system operacyjny
OpenClaw odmawia automatycznego wykonywania hooków, uznawania list dozwolonych uprawnień oraz dekodowania nieprzejrzystego stanu danych uwierzytelniających OAuth i Claude Desktop. Po przejrzeniu archiwum przenieś ręcznie potrzebne elementy.

​
Wybór źródła

Bez opcji --from OpenClaw sprawdza domyślny katalog domowy Claude Code w ~/.claude, przykładowy plik stanu Claude Code ~/.claude.json oraz konfigurację MCP Claude Desktop w systemie macOS. Gdy opcja --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 importowania z katalogu głównego projektu nie odczytuje globalnego katalogu domowego Claude.

​
Zalecany przebieg

1

Wyświetl podgląd planu

Plan zawiera wszystko, co zostanie zmienione, w tym konflikty, pominięte elementy i wartości poufne utajnione w zagnieżdżonych polach MCP env lub headers.
2

Zastosuj z kopią zapasową

OpenClaw tworzy i weryfikuje kopię zapasową przed zastosowaniem zmian.
3

Uruchom diagnostykę

Diagnostyka sprawdza po imporcie problemy z konfiguracją lub stanem.
4

Uruchom ponownie i zweryfikuj

Upewnij się, że Gateway działa prawidłowo, a zaimportowane instrukcje, serwery MCP i Skills zostały wczytane.

​
Obsługa konfliktów

Zastosowanie zmian zostaje przerwane, gdy plan zgłasza konflikty (plik lub wartość konfiguracji już istnieje w miejscu docelowym).
Uruchom ponownie z opcją --overwrite tylko wtedy, gdy celowo chcesz zastąpić istniejący element docelowy. Dostawcy mogą nadal zapisywać kopie zapasowe poszczególnych zastępowanych plików w katalogu raportu migracji.
W świeżej instalacji OpenClaw konflikty występują rzadko. Zwykle pojawiają się po ponownym uruchomieniu importu w konfiguracji zawierającej już zmiany użytkownika.

​
Dane wyjściowe JSON do automatyzacji

Opcja --yes jest wymagana dla polecenia migrate apply poza terminalem interaktywnym. Bez niej OpenClaw zgłasza błąd zamiast zastosować zmiany, dlatego skrypty i CI muszą jawnie przekazywać --yes. Najpierw wyświetl podgląd za pomocą --dry-run --json, a gdy plan będzie prawidłowy, zastosuj go za pomocą --json --yes.

​
Rozwiązywanie problemów

Przekaż --from /actual/path (CLI) lub --import-source /actual/path (wdrażanie).
Import podczas wdrażania wymaga świeżej konfiguracji. Zresetuj stan i ponownie przeprowadź wdrażanie albo użyj bezpośrednio polecenia openclaw migrate apply claude, które obsługuje opcję --overwrite i jawną kontrolę kopii zapasowych.
Claude Desktop odczytuje plik claude_desktop_config.json ze ścieżki właściwej dla danej platformy. Jeśli OpenClaw nie wykrył go automatycznie, ustaw opcję --from na katalog zawierający ten plik.
Jest to działanie zamierzone. Polecenia Claude są uruchamiane przez użytkownika, dlatego OpenClaw importuje je jako Skills z ustawieniem disable-model-invocation: true. Jeśli chcesz, aby agent wywoływał je automatycznie, zmodyfikuj metadane frontmatter każdego Skill.

​
Powiązane materiały