openclaw migrate

Importuj stan z innego systemu agentów przez należący do pluginu dostawca migracji. Wbudowani dostawcy obejmują stan Codex CLI, Claude i Hermes; pluginy firm trzecich mogą rejestrować dodatkowych dostawców.

Polecenia

openclaw migrate listopenclaw migrate claude --dry-runopenclaw migrate codex --dry-runopenclaw migrate codex --skill gog-vault77-google-workspaceopenclaw migrate codex --plugin google-calendar --dry-runopenclaw migrate codex --plugin google-calendar --verify-plugin-apps --dry-runopenclaw migrate hermes --dry-runopenclaw migrate hermesopenclaw migrate apply codex --yes --skill gog-vault77-google-workspaceopenclaw migrate apply codex --yes --plugin google-calendaropenclaw migrate apply codex --yesopenclaw migrate apply claude --yesopenclaw migrate apply hermes --yesopenclaw migrate apply hermes --include-secrets --yesopenclaw onboard --flow importopenclaw onboard --import-from claude --import-source ~/.claudeopenclaw 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.

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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tcGx1Z2luIDxuYW1l " type="string"> Wybierz jeden element instalacji pluginu Codex według nazwy pluginu lub identyfikatora elementu. Powtórz flagę, aby zmigrować wiele pluginów Codex. Gdy pominięte, interaktywne migracje Codex pokazują natywny selektor pól wyboru pluginów Codex, a migracje nieinteraktywne zachowują wszystkie zaplanowane pluginy. Dotyczy to tylko zainstalowanych w źródle pluginów Codex openai-curated, odkrytych przez inwentarz serwera aplikacji Codex.

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 zaimportować konkretny katalog domowy lub katalog główny projektu Claude Code.

Co importuje Claude

• Projektowe CLAUDE.md i .claude/CLAUDE.md do przestrzeni roboczej agenta OpenClaw.
• Użytkownika ~/.claude/CLAUDE.md dołączone do roboczego USER.md.
• 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żką, podagenci, 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 zezwoleń ani nie importuje automatycznie stanu danych uwierzytelniających OAuth/Desktop.

Dostawca Codex

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

Użyj tego dostawcy, gdy przechodzisz na uprząż Codex OpenClaw i chcesz świadomie promować przydatne osobiste zasoby Codex CLI. Lokalne uruchomienia serwera aplikacji Codex używają CODEX_HOME przypisanego do agenta, więc domyślnie nie odczytują Twojego osobistego ~/.codex. Zwykły proces HOME jest nadal dziedziczony, więc Codex może widzieć współdzielone wpisy skills/marketplace pluginów $HOME/.agents/*, a podprocesy mogą znaleźć konfigurację i tokeny z katalogu domowego użytkownika.

Uruchomienie openclaw migrate codex w interaktywnym terminalu pokazuje pełny plan, a następnie otwiera selektory pól wyboru przed końcowym potwierdzeniem zastosowania. Elementy kopiowania skills są wyświetlane najpierw. Użyj Toggle all on lub Toggle all off do masowego wyboru. Naciśnij Spację, aby przełączać wiersze, albo naciśnij Enter, aby aktywować podświetlony wiersz i kontynuować. Zaplanowane skills zaczynają jako zaznaczone, konfliktowe skills jako odznaczone, a Skip for now pomija kopie skills dla tego uruchomienia, nadal przechodząc do wyboru pluginów. Gdy zainstalowane w źródle kuratorowane pluginy Codex można migrować i nie podano --plugin, migracja następnie pyta o natywną aktywację pluginów Codex według nazwy pluginu. Elementy pluginów zaczynają jako zaznaczone, chyba że docelowa konfiguracja pluginu OpenClaw Codex już ma ten plugin. Istniejące docelowe pluginy zaczynają jako odznaczone i pokazują wskazówkę konfliktu, taką jak conflict: plugin exists; wybierz Toggle all off, aby nie migrować żadnych natywnych pluginów Codex w tym uruchomieniu, albo Skip for now, aby zatrzymać się przed zastosowaniem. Dla skryptowanych lub dokładnych uruchomień przekaż --skill <name> raz na skill, na przykład:

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

Użyj --plugin <name>, aby nieinteraktywnie ograniczyć migrację natywnych pluginów Codex do jednego lub większej liczby zainstalowanych w źródle kuratorowanych pluginów:

openclaw migrate codex --dry-run --plugin google-calendaropenclaw migrate apply codex --yes --plugin google-calendar

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.
• Zainstalowane w źródle pluginy Codex openai-curated, odkryte przez plugin/list serwera aplikacji Codex. Planowanie odczytuje plugin/read dla każdego włączonego zainstalowanego pluginu. Pluginy wspierane przez aplikacje wymagają, aby odpowiedź konta źródłowego serwera aplikacji Codex była kontem subskrypcji ChatGPT; odpowiedzi kont inne niż ChatGPT lub brakujące są pomijane z codex_subscription_required. Domyślnie migracja nie wywołuje źródłowego app/list, więc pluginy wspierane przez aplikacje, które przechodzą bramkę konta, są planowane bez weryfikacji dostępności aplikacji źródłowej, a awarie transportu wyszukiwania konta pomijają z codex_account_unavailable. Przekaż --verify-plugin-apps, gdy chcesz, aby migracja wymusiła świeży snapshot źródłowego app/list i wymagała, aby każda posiadana aplikacja była obecna, włączona i dostępna przed planowaniem natywnej aktywacji. W tym trybie awarie transportu wyszukiwania konta przechodzą do weryfikacji inwentarza aplikacji źródłowych. Snapshot inwentarza aplikacji źródłowych jest przechowywany w pamięci dla bieżącego procesu; nie jest zapisywany w wyjściu migracji ani docelowej konfiguracji. Wyłączone pluginy, nieczytelne szczegóły pluginów, konta źródłowe ograniczone subskrypcją oraz, gdy żądana jest weryfikacja, brakujące aplikacje, wyłączone aplikacje, niedostępne aplikacje lub awarie inwentarza aplikacji źródłowych stają się ręcznie pominiętymi elementami z typowanymi powodami zamiast wpisami docelowej konfiguracji. Zastosowanie wywołuje plugin/install serwera aplikacji dla każdego wybranego kwalifikującego się pluginu, nawet jeśli docelowy serwer aplikacji już zgłasza ten plugin jako zainstalowany i włączony. Zmigrowane pluginy Codex są używalne tylko w sesjach, które wybierają natywną uprząż Codex; nie są wystawiane na uruchomienia dostawców OpenClaw, powiązania konwersacji ACP ani inne uprzęże.

Stan Codex do ręcznego przeglądu

Codex config.toml, natywne hooks/hooks.json, niekuratorowane marketplace'y, buforowane pakiety pluginów, które nie są zainstalowanymi w źródle kuratorowanymi pluginami, oraz zainstalowane w źródle pluginy, które nie przechodzą źródłowej bramki subskrypcji, nie są aktywowane automatycznie. Gdy ustawiono --verify-plugin-apps, pluginy, które nie przechodzą bramki inwentarza aplikacji źródłowych, również są pomijane. Są kopiowane lub zgłaszane w raporcie migracji do ręcznego przeglądu.

Dla zmigrowanych zainstalowanych w źródle kuratorowanych pluginów zastosowanie zapisuje:

• plugins.entries.codex.enabled: true
• plugins.entries.codex.config.codexPlugins.enabled: true
• plugins.entries.codex.config.codexPlugins.allow_destructive_actions: true
• jeden jawny wpis pluginu z marketplaceName: "openai-curated" i pluginName dla każdego wybranego pluginu

Migracja nigdy nie zapisuje plugins["*"] i nigdy nie przechowuje ścieżek lokalnej pamięci podręcznej marketplace. Błędy subskrypcji po stronie źródła są zgłaszane w pozycjach ręcznych z typowanymi powodami, takimi jak codex_subscription_required, codex_account_unavailable, plugin_disabled lub plugin_read_unavailable. Z --verify-plugin-apps błędy inwentarza aplikacji źródłowych mogą też pojawiać się jako app_inaccessible, app_disabled, app_missing lub app_inventory_unavailable. Pominięte Pluginy nie są zapisywane w konfiguracji docelowej. Instalacje wymagające autoryzacji po stronie docelowej są zgłaszane przy odpowiedniej pozycji Pluginu z status: "skipped", reason: "auth_required" i oczyszczonymi identyfikatorami aplikacji. Ich jawne wpisy konfiguracji są zapisywane jako wyłączone, dopóki ponownie nie autoryzujesz ich i nie włączysz. Inne błędy instalacji są wynikami error ograniczonymi do pozycji.

Jeśli inwentarz Pluginów serwera aplikacji Codex jest niedostępny podczas planowania, migracja korzysta z buforowanych pozycji doradczych pakietu zamiast przerywać całą migrację.

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 dopisane do plików pamięci przestrzeni roboczej.
• Domyślne ustawienia konfiguracji pamięci plikowej OpenClaw oraz pozycje archiwum lub ręcznej weryfikacji dla zewnętrznych dostawców pamięci, takich jak Honcho.
• Skills, które zawierają plik SKILL.md w skills/<name>/.
• Wartości konfiguracji poszczególnych Skills z skills.config.
• Dane uwierzytelniające OpenCode OpenAI OAuth z OpenCode auth.json, gdy interaktywna migracja danych uwierzytelniających zostanie zaakceptowana albo gdy ustawiono --include-secrets. Wpisy OAuth Hermes auth.json są stanem starszego typu zgłaszanym do ręcznej ponownej autoryzacji OpenAI lub naprawy przez doctor.
• Obsługiwane klucze API i tokeny z Hermes .env oraz OpenCode auth.json, gdy interaktywna migracja danych uwierzytelniających zostanie zaakceptowana albo gdy ustawiono --include-secrets.

Obsługiwane klucze .env

• AI_GATEWAY_API_KEY
• ALIBABA_API_KEY
• ANTHROPIC_API_KEY
• ARCEEAI_API_KEY
• CEREBRAS_API_KEY
• CHUTES_API_KEY
• CLOUDFLARE_AI_GATEWAY_API_KEY
• COPILOT_GITHUB_TOKEN
• DASHSCOPE_API_KEY
• DEEPINFRA_API_KEY
• DEEPSEEK_API_KEY
• FIREWORKS_API_KEY
• GEMINI_API_KEY
• GH_TOKEN
• GITHUB_TOKEN
• GLM_API_KEY
• GOOGLE_API_KEY
• GROQ_API_KEY
• HF_TOKEN
• HUGGINGFACE_HUB_TOKEN
• KILOCODE_API_KEY
• KIMICODE_API_KEY
• KIMI_API_KEY
• MINIMAX_API_KEY
• MINIMAX_CODING_API_KEY
• MISTRAL_API_KEY
• MODELSTUDIO_API_KEY
• MOONSHOT_API_KEY
• NVIDIA_API_KEY
• OPENAI_API_KEY
• OPENCODE_API_KEY
• OPENCODE_GO_API_KEY
• OPENCODE_ZEN_API_KEY
• OPENROUTER_API_KEY
• QIANFAN_API_KEY
• QWEN_API_KEY
• TOGETHER_API_KEY
• VENICE_API_KEY
• XAI_API_KEY
• XIAOMI_API_KEY
• ZAI_API_KEY
• Z_AI_API_KEY

Stan tylko do archiwum

Stan Hermes, którego OpenClaw nie może bezpiecznie zinterpretować, jest kopiowany do raportu migracji do ręcznej weryfikacji, 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 wykonywać lub mu ufać:

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

Po zastosowaniu

openclaw doctor

Kontrakt Pluginu

Źródła migracji są Pluginami. Plugin deklaruje swoje identyfikatory dostawców w openclaw.plugin.json:

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

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

Pluginy dostawców mogą używać openclaw/plugin-sdk/migration do tworzenia pozycji i zliczeń podsumowania oraz openclaw/plugin-sdk/migration-runtime do świadomego konfliktów kopiowania plików, kopii raportów tylko do archiwum, buforowanych opakowań środowiska wykonywania konfiguracji i raportów migracji.

Integracja onboardingu

Onboarding może zaoferować 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 Pluginu i nadal pokazują podgląd przed zastosowaniem.

Powiązane

• Migracja z Hermes: przewodnik dla użytkownika.
• Migracja z Claude: przewodnik dla użytkownika.
• Migracja: przenieś OpenClaw na nowy komputer.
• Doctor: kontrola stanu po zastosowaniu migracji.
• Pluginy: instalacja i rejestracja Pluginów.