# openclaw migrate

Importuj stan z innego systemu agentów przez dostawcę migracji należącego do Plugin. Dostawcy wbudowani obejmują stan Codex CLI, Claude i Hermes; Plugin innych firm mogą rejestrować dodatkowych dostawców.

# Polecenia

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> Nazwa zarejestrowanego dostawcy migracji, na przykład hermes. Uruchom openclaw migrate list, aby zobaczyć zainstalowanych dostawców.

--dry-runboolean

Zbuduj plan i zakończ bez zmieniania stanu.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> Zastąp katalog stanu źródłowego. Hermes domyślnie używa ~/.hermes.

--include-secretsboolean

Importuj obsługiwane dane uwierzytelniające. Domyślnie wyłączone.

--overwriteboolean

Pozwól operacji apply zastępować istniejące cele, gdy plan zgłasza konflikty.

--yesboolean

Pomiń monit o potwierdzenie. Wymagane w trybie nieinteraktywnym.

"--skill

--no-backupboolean

Pomiń kopię zapasową przed apply. Wymaga --force, gdy istnieje lokalny stan OpenClaw.

--forceboolean

Wymagane razem z --no-backup, gdy apply w innym przypadku odmówiłoby pominięcia kopii zapasowej.

--jsonboolean

Wypisz plan lub wynik apply jako JSON. Z --json i bez --yes, apply wypisuje plan i nie modyfikuje stanu.

# Model bezpieczeństwa

openclaw migrate najpierw pokazuje podgląd.

# Dostawca Claude

Wbudowany dostawca Claude domyślnie wykrywa stan Claude Code w ~/.claude. Użyj --from <path>, aby importować określony katalog domowy Claude Code lub katalog główny projektu.

# Co importuje Claude

• Projektowe CLAUDE.md i .claude/CLAUDE.md do przestrzeni roboczej agenta OpenClaw.
• Użytkownika ~/.claude/CLAUDE.md dołączone do USER.md w przestrzeni roboczej.
• Definicje serwerów MCP z projektowego .mcp.json, Claude Code ~/.claude.json i Claude Desktop claude_desktop_config.json.
• Katalogi Skills Claude, które zawierają SKILL.md.
• Pliki Markdown poleceń Claude przekonwertowane na Skills OpenClaw tylko z ręcznym wywołaniem.

# Stan archiwum i ręcznego przeglądu

Hooki Claude, uprawnienia, domyślne ustawienia środowiska, pamięć lokalna, reguły zakresowane ścieżkami, subagenci, pamięci podręczne, plany i historia projektu są zachowywane w raporcie migracji lub zgłaszane jako elementy do ręcznego przeglądu. OpenClaw nie wykonuje hooków, nie kopiuje szerokich list dozwolonych ani nie importuje automatycznie stanu danych uwierzytelniających OAuth/Desktop.

# Dostawca Codex

Wbudowany dostawca Codex domyślnie wykrywa stan Codex CLI w ~/.codex lub w CODEX_HOME, gdy ta zmienna środowiskowa jest ustawiona. Użyj --from <path>, aby zinwentaryzować określony katalog domowy Codex.

Użyj tego dostawcy, gdy przechodzisz na harness OpenClaw Codex i chcesz świadomie promować przydatne osobiste zasoby Codex CLI. Lokalne uruchomienia serwera aplikacji Codex używają katalogów CODEX_HOME i HOME dla danego agenta, więc domyślnie nie odczytują osobistego stanu Codex CLI.

Uruchomienie openclaw migrate codex w interaktywnym terminalu pokazuje podgląd pełnego planu, a następnie otwiera selektor pól wyboru dla elementów kopiowania Skills przed końcowym potwierdzeniem apply. Użyj Toggle all on lub Toggle all off do wyboru zbiorczego; zaplanowane Skills zaczynają jako zaznaczone, Skills z konfliktami jako niezaznaczone, a Skip for now pozostawia Skills bez zmian bez stosowania. Do uruchomień skryptowych lub dokładnych przekaż --skill <name> raz na Skills, na przykład:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

# Co importuje Codex

• Katalogi Skills Codex CLI pod $CODEX_HOME/skills, z wyłączeniem pamięci podręcznej .system Codex.
• Osobiste AgentSkills pod $HOME/.agents/skills, kopiowane do bieżącej przestrzeni roboczej agenta OpenClaw, gdy chcesz własności na poziomie agenta.

# Stan Codex do ręcznego przeglądu

Natywne Plugin Codex, config.toml i natywne hooks/hooks.json nie są aktywowane automatycznie. Plugin mogą udostępniać serwery MCP, aplikacje, hooki lub inne zachowanie wykonywalne, więc dostawca zgłasza je do przeglądu zamiast ładować je do OpenClaw. Pliki konfiguracji i hooków są kopiowane do raportu migracji do ręcznego przeglądu.

# Dostawca Hermes

Wbudowany dostawca Hermes domyślnie wykrywa stan w ~/.hermes. Użyj --from <path>, gdy Hermes znajduje się gdzie indziej.

# Co importuje Hermes

• Domyślną konfigurację modelu z config.yaml.
• Skonfigurowanych dostawców modeli i niestandardowe punkty końcowe zgodne z OpenAI z providers i custom_providers.
• Definicje serwerów MCP z mcp_servers lub mcp.servers.
• SOUL.md i AGENTS.md do przestrzeni roboczej agenta OpenClaw.
• memories/MEMORY.md i memories/USER.md dołączone do plików pamięci przestrzeni roboczej.
• Domyślne ustawienia konfiguracji pamięci dla pamięci plikowej OpenClaw oraz elementy archiwum lub ręcznego przeglądu dla zewnętrznych dostawców pamięci, takich jak Honcho.
• Skills, które zawierają plik SKILL.md pod skills/<name>/.
• Wartości konfiguracji dla poszczególnych Skills z skills.config.
• Obsługiwane klucze API z .env, tylko z --include-secrets.

# Obsługiwane klucze .env

OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY.

# Stan tylko do archiwum

Stan Hermes, którego OpenClaw nie może bezpiecznie zinterpretować, jest kopiowany do raportu migracji do ręcznego przeglądu, ale nie jest ładowany do aktywnej konfiguracji ani danych uwierzytelniających OpenClaw. Zachowuje to nieprzejrzysty lub niebezpieczny stan bez udawania, że OpenClaw może go automatycznie wykonać lub mu zaufać:

• plugins/
• sessions/
• logs/
• cron/
• mcp-tokens/
• auth.json
• state.db

# Po zastosowaniu

openclaw doctor

# Kontrakt Plugin

Źródła migracji to Plugin. Plugin deklaruje identyfikatory dostawców w openclaw.plugin.json:

{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}

W czasie działania Plugin wywołuje api.registerMigrationProvider(...). Dostawca implementuje detect, plan i apply. Core odpowiada za orkiestrację CLI, politykę kopii zapasowych, monity, wyjście JSON i wstępne sprawdzanie konfliktów. Core przekazuje przejrzany plan do apply(ctx, plan), a dostawcy mogą przebudować plan tylko wtedy, gdy ten argument jest nieobecny ze względu na zgodność.

Plugin dostawców mogą używać openclaw/plugin-sdk/migration do konstruowania elementów i zliczeń podsumowania oraz openclaw/plugin-sdk/migration-runtime do kopiowania plików z uwzględnieniem konfliktów, kopii raportów tylko do archiwum, buforowanych wrapperów config-runtime i raportów migracji.

# Integracja onboardingu

Onboarding może zaproponować migrację, gdy dostawca wykryje znane źródło. Zarówno openclaw onboard --flow import, jak i openclaw setup --wizard --import-from hermes używają tego samego dostawcy migracji Plugin i nadal pokazują podgląd przed zastosowaniem.

# Powiązane

• Migracja z Hermes: instrukcja dla użytkowników.
• Migracja z Claude: instrukcja dla użytkowników.
• Migracja: przenieś OpenClaw na nową maszynę.
• Doctor: kontrola kondycji po zastosowaniu migracji.
• Plugin: instalacja i rejestracja Plugin.