> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Migracja z Claude

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.

<Note>
  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.
</Note>

## Dwa sposoby importu

<Tabs>
  <Tab title="Kreator wdrażania">
    Kreator proponuje Claude, gdy wykryje lokalny stan Claude.

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --flow import
    ```

    Albo wskaż konkretne źródło:

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --import-from claude --import-source ~/.claude
    ```
  </Tab>

  <Tab title="CLI">
    Użyj `openclaw migrate` do uruchomień skryptowych lub powtarzalnych. Pełny opis znajdziesz w [`openclaw migrate`](/pl/cli/migrate).

    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw migrate claude --dry-run
    openclaw migrate apply claude --yes
    ```

    Dodaj `--from <path>`, aby zaimportować konkretny katalog domowy Claude Code lub katalog główny projektu.
  </Tab>
</Tabs>

## Co jest importowane

<AccordionGroup>
  <Accordion title="Instrukcje i pamięć">
    * 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.
  </Accordion>

  <Accordion title="Serwery MCP">
    Definicje serwerów MCP są importowane z projektu `.mcp.json`, Claude Code `~/.claude.json` oraz Claude Desktop `claude_desktop_config.json`, gdy są obecne.
  </Accordion>

  <Accordion title="Skills i polecenia">
    * 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`.
  </Accordion>
</AccordionGroup>

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

<Steps>
  <Step title="Podejrzyj plan">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    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`.
  </Step>

  <Step title="Zastosuj z kopią zapasową">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw migrate apply claude --yes
    ```

    OpenClaw tworzy i weryfikuje kopię zapasową przed zastosowaniem zmian.
  </Step>

  <Step title="Uruchom doctor">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw doctor
    ```

    [Doctor](/pl/gateway/doctor) sprawdza problemy z konfiguracją lub stanem po imporcie.
  </Step>

  <Step title="Uruchom ponownie i zweryfikuj">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw gateway restart
    openclaw status
    ```

    Potwierdź, że gateway działa poprawnie, a zaimportowane instrukcje, serwery MCP i Skills są załadowane.
  </Step>
</Steps>

## Obsługa konfliktów

Zastosowanie zmian odmawia kontynuowania, gdy plan zgłasza konflikty (plik lub wartość konfiguracji już istnieje w miejscu docelowym).

<Warning>
  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.
</Warning>

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

<AccordionGroup>
  <Accordion title="Stan Claude znajduje się poza ~/.claude">
    Przekaż `--from /actual/path` (CLI) albo `--import-source /actual/path` (wdrażanie).
  </Accordion>

  <Accordion title="Wdrażanie odmawia importu w istniejącej konfiguracji">
    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.
  </Accordion>

  <Accordion title="Serwery MCP z Claude Desktop nie zostały zaimportowane">
    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.
  </Accordion>

  <Accordion title="Polecenia Claude stały się Skills z wyłączonym wywoływaniem modelu">
    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.
  </Accordion>
</AccordionGroup>

## Powiązane

* [`openclaw migrate`](/pl/cli/migrate): pełny opis CLI, kontrakt Plugin i kształty JSON.
* [Przewodnik po migracji](/pl/install/migrating): wszystkie ścieżki migracji.
* [Migracja z Hermes](/pl/install/migrating-hermes): druga ścieżka importu między systemami.
* [Wdrażanie](/pl/cli/onboard): przepływ kreatora i flagi nieinteraktywne.
* [Doctor](/pl/gateway/doctor): kontrola kondycji po migracji.
* [Przestrzeń robocza agenta](/pl/concepts/agent-workspace): gdzie znajdują się `AGENTS.md`, `USER.md` i Skills.