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

Maintenance

Migracja z Claude

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.

Dwa sposoby importowania

Kreator wdrażania

Kreator oferuje import z Claude po wykryciu lokalnego stanu Claude.

bash
openclaw onboard --flow import

Możesz też wskazać konkretne źródło:

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

CLI

Użyj openclaw migrate do uruchomień skryptowych lub powtarzalnych. Pełną dokumentację zawiera strona openclaw migrate.

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

Dodaj --from <path>, aby zaimportować określony katalog domowy Claude Code lub katalog główny projektu.

Co jest importowane

Instrukcje i pamięć
  • 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.
Serwery MCP

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 i polecenia
  • 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

  • Wyświetl podgląd planu

    bash
    openclaw migrate claude --dry-run

    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.

  • Zastosuj z kopią zapasową

    bash
    openclaw migrate apply claude --yes

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

  • Uruchom diagnostykę

    bash
    openclaw doctor

    Diagnostyka sprawdza po imporcie problemy z konfiguracją lub stanem.

  • Uruchom ponownie i zweryfikuj

    bash
    openclaw gateway restartopenclaw status

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

    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

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

    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

    Stan Claude znajduje się poza ~/.claude

    Przekaż --from /actual/path (CLI) lub --import-source /actual/path (wdrażanie).

    Wdrażanie odmawia importu do istniejącej konfiguracji

    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.

    Serwery MCP z Claude Desktop nie zostały zaimportowane

    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.

    Polecenia Claude stały się Skills z wyłączonym wywoływaniem przez model

    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

    Was this useful?
    On this page

    On this page