Przejdź do głównej treści

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.

​
openclaw migrate

Importuj stan z innego systemu agentów za pośrednictwem dostawcy migracji należącego do pluginu. Dostawcy dołączeni w pakiecie obejmują stan Codex CLI, Claude i Hermes; pluginy firm trzecich mogą rejestrować dodatkowych dostawców.
Instrukcje krok po kroku dla użytkowników znajdziesz w sekcjach Migracja z Claude i Migracja z Hermes. Centrum migracji zawiera listę wszystkich ścieżek.

​
Polecenia

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate codex --plugin google-calendar --dry-run
openclaw migrate codex --plugin google-calendar --verify-plugin-apps --dry-run
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --plugin google-calendar
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
​
<provider>
string
Nazwa zarejestrowanego dostawcy migracji, na przykład hermes. Uruchom openclaw migrate list, aby zobaczyć zainstalowanych dostawców.
​
--dry-run
boolean
Zbuduj plan i zakończ bez zmieniania stanu.
​
--from <path>
string
Zastąp katalog stanu źródłowego. Hermes domyślnie używa ~/.hermes.
​
--include-secrets
boolean
Importuj obsługiwane poświadczenia. Domyślnie wyłączone.
​
--overwrite
boolean
Zezwól operacji apply na zastępowanie istniejących celów, gdy plan zgłasza konflikty.
​
--yes
boolean
Pomiń monit o potwierdzenie. Wymagane w trybie nieinteraktywnym.
​
--skill <name>
string
Wybierz jeden element kopiowania Skills według nazwy Skills lub identyfikatora elementu. Powtórz flagę, aby migrować wiele Skills. Po pominięciu interaktywne migracje Codex pokazują selektor pól wyboru, a migracje nieinteraktywne zachowują wszystkie zaplanowane Skills.
​
--plugin <name>
string
Wybierz jeden element instalacji pluginu Codex według nazwy pluginu lub identyfikatora elementu. Powtórz flagę, aby migrować wiele pluginów Codex. Po pominięciu 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 wykrytych przez inwentarz serwera aplikacji Codex.
​
--verify-plugin-apps
boolean
Tylko Codex. Wymuś świeże przejście app/list źródłowego serwera aplikacji Codex przed zaplanowaniem natywnej aktywacji pluginów. Domyślnie wyłączone, aby planowanie migracji było szybkie.
​
--no-backup
boolean
Pomiń kopię zapasową przed zastosowaniem. Wymaga --force, gdy lokalny stan OpenClaw istnieje.
​
--force
boolean
Wymagane razem z --no-backup, gdy operacja apply w przeciwnym razie odmówiłaby pominięcia kopii zapasowej.
​
--json
boolean
Wypisz plan lub wynik apply jako JSON. Z --json i bez --yes operacja apply wypisuje plan i nie modyfikuje stanu.

​
Model bezpieczeństwa

openclaw migrate najpierw pokazuje podgląd.
Dostawca zwraca wyszczególniony plan przed jakimikolwiek zmianami, w tym konflikty, pominięte elementy i elementy wrażliwe. Plany JSON, dane wyjściowe apply i raporty migracji redagują zagnieżdżone klucze wyglądające na sekrety, takie jak klucze API, tokeny, nagłówki autoryzacji, pliki cookie i hasła.openclaw migrate apply <provider> pokazuje podgląd planu i prosi o potwierdzenie przed zmianą stanu, chyba że ustawiono --yes. W trybie nieinteraktywnym operacja apply wymaga --yes.
Operacja apply tworzy i weryfikuje kopię zapasową OpenClaw przed zastosowaniem migracji. Jeśli lokalny stan OpenClaw jeszcze nie istnieje, krok kopii zapasowej jest pomijany, a migracja może kontynuować. Aby pominąć kopię zapasową, gdy stan istnieje, przekaż zarówno --no-backup, jak i --force.
Operacja apply odmawia kontynuowania, gdy plan ma konflikty. Przejrzyj plan, a następnie uruchom ponownie z --overwrite, jeśli zastąpienie istniejących celów jest zamierzone. Dostawcy nadal mogą zapisywać kopie zapasowe na poziomie elementów dla nadpisanych plików w katalogu raportu migracji.
Sekrety nigdy nie są importowane domyślnie. Użyj --include-secrets, aby importować obsługiwane poświadczenia.

​
Dostawca Claude

Dołączony dostawca Claude domyślnie wykrywa stan Claude Code w ~/.claude. Użyj --from <path>, aby importować konkretny katalog domowy lub katalog główny projektu Claude Code.
Instrukcję krok po kroku dla użytkowników znajdziesz w sekcji Migracja z Claude.

​
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 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 wyłącznie z ręcznym wywołaniem.

​
Stan archiwum i ręcznego przeglądu

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

​
Dostawca Codex

Dołączony 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 podczas przechodzenia na uprząż OpenClaw Codex, gdy chcesz świadomie wypromować przydatne osobiste zasoby Codex CLI. Lokalne uruchomienia serwera aplikacji Codex używają katalogów CODEX_HOME i HOME przypisanych do agenta, więc domyślnie nie czytają osobistego stanu Codex CLI. Uruchomienie openclaw migrate codex w terminalu interaktywnym pokazuje podgląd pełnego planu, a następnie otwiera selektory pól wyboru przed ostatecznym potwierdzeniem apply. Elementy kopiowania Skills są monitowane jako pierwsze. Użyj Toggle all on lub Toggle all off do masowego wyboru. Naciśnij spację, aby przełączać wiersze, albo Enter, aby aktywować podświetlony wiersz i kontynuować. Zaplanowane Skills zaczynają jako zaznaczone, Skills z konfliktem zaczynają jako niezaznaczone, a Skip for now pomija kopiowanie Skills w tym uruchomieniu, 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 monituje 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 pluginy docelowe zaczynają jako niezaznaczone 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 uruchomień skryptowych lub dokładnych przekaż --skill <name> raz dla każdego Skills, na przykład: 
openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw 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-calendar
openclaw migrate apply codex --yes --plugin google-calendar

​
Co importuje Codex

  • Katalogi Skills Codex CLI w $CODEX_HOME/skills, z wyłączeniem pamięci podręcznej .system Codex.
  • Osobiste AgentSkills w $HOME/.agents/skills, kopiowane do bieżącej przestrzeni roboczej agenta OpenClaw, gdy chcesz własności przypisanej do agenta.
  • Zainstalowane w źródle pluginy Codex openai-curated wykryte przez plugin/list serwera aplikacji Codex. Planowanie odczytuje plugin/read dla każdego włączonego zainstalowanego pluginu. Pluginy oparte na aplikacjach wymagają, aby odpowiedź konta źródłowego serwera aplikacji Codex była kontem subskrypcji ChatGPT; odpowiedzi spoza ChatGPT lub brakujące odpowiedzi konta są pomijane z codex_subscription_required. Domyślnie migracja nie wywołuje źródłowego app/list, więc pluginy oparte na aplikacjach, które przejdą bramkę konta, są planowane bez weryfikacji dostępności aplikacji źródłowej, a awarie transportu wyszukiwania konta są pomijane z codex_account_unavailable. Przekaż --verify-plugin-apps, gdy chcesz, aby migracja wymusiła świeżą migawkę źródłowego app/list i wymagała, by każda posiadana aplikacja była obecna, włączona i dostępna przed zaplanowaniem natywnej aktywacji. W tym trybie awarie transportu wyszukiwania konta przechodzą do weryfikacji inwentarza aplikacji źródłowych. Migawka inwentarza aplikacji źródłowych jest przechowywana w pamięci dla bieżącego procesu; nie jest zapisywana w danych wyjściowych migracji ani w konfiguracji docelowej. Wyłączone pluginy, nieczytelne szczegóły pluginów, konta źródłowe ograniczone subskrypcją oraz, gdy zażądano weryfikacji, 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 wpisów konfiguracji docelowej. Operacja apply 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żyteczne tylko w sesjach, które wybierają natywną uprząż Codex; nie są udostępniane Pi, zwykłym uruchomieniom dostawcy OpenAI, powiązaniom konwersacji ACP ani innym uprzężom.

​
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 przejdą źródłowej bramki subskrypcji, nie są aktywowane automatycznie. Gdy ustawiono --verify-plugin-apps, pluginy, które nie przejdą bramki inwentarza aplikacji źródłowych, również są pomijane. Są kopiowane albo zgłaszane w raporcie migracji do ręcznego przeglądu. Dla zmigrowanych zainstalowanych w źródle kuratorowanych pluginów operacja apply 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 lokalnych ścieżek pamięci podręcznej marketplace’u. Awarie subskrypcji po stronie źródła są zgłaszane przy elementach ręcznych z typowanymi powodami, takimi jak codex_subscription_required, codex_account_unavailable, plugin_disabled lub plugin_read_unavailable. Z --verify-plugin-apps awarie inwentarza aplikacji źródłowych mogą również pojawić 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 dotkniętym elemencie pluginu z status: "skipped", reason: "auth_required" i oczyszczonymi identyfikatorami aplikacji. Ich jawne wpisy konfiguracji są zapisywane jako wyłączone do czasu ponownej autoryzacji i włączenia ich. Inne awarie instalacji są wynikami error ograniczonymi do elementu. Jeśli inwentarz pluginów serwera aplikacji Codex jest niedostępny podczas planowania, migracja cofa się do doradczych elementów buforowanych pakietów zamiast kończyć całą migrację niepowodzeniem.

​
Dostawca Hermes

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

​
Co importuje Hermes

  • Domyślna konfiguracja modelu z config.yaml.
  • Skonfigurowani dostawcy modeli i niestandardowe punkty końcowe zgodne z OpenAI z providers oraz custom_providers.
  • Definicje serwerów MCP z mcp_servers lub mcp.servers.
  • SOUL.md i AGENTS.md do obszaru roboczego agenta OpenClaw.
  • memories/MEMORY.md i memories/USER.md dołączone do plików pamięci obszaru roboczego.
  • Domyślne ustawienia konfiguracji pamięci plikowej OpenClaw oraz elementy archiwalne lub do ręcznego przeglądu 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.
  • 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 wyłącznie archiwalny

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 poświadczeń OpenClaw. Zachowuje to nieprzezroczysty 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 są Plugin. Plugin deklaruje swoje 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, zasady tworzenia kopii zapasowych, monity, dane wyjściowe JSON i wstępną kontrolę konfliktów. Core przekazuje sprawdzony plan do apply(ctx, plan), a dostawcy mogą przebudować plan tylko wtedy, gdy ten argument jest nieobecny ze względów kompatybilności. Plugin dostawcy mogą używać openclaw/plugin-sdk/migration do tworzenia elementów i zliczania podsumowań oraz openclaw/plugin-sdk/migration-runtime do świadomego konfliktów kopiowania plików, kopiowania raportów wyłącznie do archiwum, buforowanych wrapperów środowiska uruchomieniowego konfiguracji i raportów migracji.

​
Integracja z onboardingiem

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 Plugin i nadal pokazują podgląd przed zastosowaniem.
Importy onboardingu wymagają świeżej konfiguracji OpenClaw. Najpierw zresetuj konfigurację, poświadczenia, sesje i obszar roboczy, jeśli masz już stan lokalny. Importy z kopią zapasową i nadpisaniem lub scalaniem są objęte flagą funkcji dla istniejących konfiguracji.

​
Powiązane