Skip to main content
OpenClaw obsługuje trzy ścieżki migracji: import z innego systemu agentowego, przeniesienie istniejącej instalacji na nową maszynę oraz uaktualnienie pluginu w miejscu.

​
Import z innego systemu agentowego

Wbudowani dostawcy migracji przenoszą do OpenClaw instrukcje, serwery MCP, Skills, konfigurację modeli oraz — opcjonalnie — klucze API. Plany są wyświetlane do wglądu przed wprowadzeniem jakichkolwiek zmian, sekrety są utajniane w raportach, a zastosowanie zmian jest zabezpieczone zweryfikowaną kopią zapasową.

Migracja z Claude

Importuj stan Claude Code i Claude Desktop, w tym CLAUDE.md, serwery MCP, Skills oraz polecenia projektowe.

Migracja z Hermes

Importuj konfigurację Hermes, dostawców, serwery MCP, pamięć, Skills oraz obsługiwane klucze .env.
Punktem wejścia CLI jest openclaw migrate. Proces wdrażania może również zaproponować migrację po wykryciu znanego źródła (openclaw onboard --flow import).

​
Przenoszenie OpenClaw na nową maszynę

Skopiuj katalog stanu (domyślnie ~/.openclaw/) oraz swój obszar roboczy, aby zachować:
  • Konfigurację — plik openclaw.json i wszystkie ustawienia Gateway.
  • Uwierzytelnianie — plik auth-profiles.json każdego agenta (klucze API i OAuth) oraz wszelkie dane stanu kanałów lub dostawców w katalogu credentials/.
  • Sesje — historię rozmów i stan agentów.
  • Stan kanałów — dane logowania WhatsApp, sesję Telegram i podobne dane.
  • Pliki obszaru roboczego — MEMORY.md, USER.md, Skills oraz prompty.
Uruchom openclaw status na starej maszynie, aby potwierdzić ścieżkę katalogu stanu. Profile niestandardowe używają katalogu ~/.openclaw-<profile>/ lub ścieżki ustawionej za pomocą OPENCLAW_STATE_DIR.

​
Kroki migracji

1

Zatrzymaj Gateway i utwórz kopię zapasową

Na starej maszynie zatrzymaj Gateway, aby pliki nie zmieniały się podczas kopiowania, a następnie utwórz archiwum:
Jeśli używasz wielu profili (na przykład ~/.openclaw-work), zarchiwizuj każdy z nich osobno.
2

Zainstaluj OpenClaw na nowej maszynie

Zainstaluj CLI (oraz Node, jeśli jest potrzebny) na nowej maszynie. Nie szkodzi, jeśli proces wdrażania utworzy nowy katalog ~/.openclaw/ — zostanie on zastąpiony w następnym kroku.
3

Skopiuj katalog stanu i obszar roboczy

Przenieś archiwum za pomocą scp, rsync -a lub dysku zewnętrznego, a następnie je rozpakuj:
Upewnij się, że uwzględniono ukryte katalogi, a właścicielem plików jest użytkownik, który będzie uruchamiać Gateway.
4

Uruchom narzędzie diagnostyczne i przeprowadź weryfikację

Na nowej maszynie uruchom narzędzie diagnostyczne, aby zastosować migracje konfiguracji i naprawić usługi:
Jeśli Telegram lub Discord korzysta z domyślnego mechanizmu awaryjnego opartego na zmiennych środowiskowych (TELEGRAM_BOT_TOKEN lub DISCORD_BOT_TOKEN), sprawdź bez wyświetlania wartości sekretów, czy przeniesiony plik .env w katalogu stanu zawiera te klucze:
Polecenie openclaw doctor ostrzega również, gdy włączone domyślne konto Telegram lub Discord nie ma skonfigurowanego tokenu, a odpowiadająca mu zmienna środowiskowa jest niedostępna dla procesu diagnostycznego.

​
Typowe pułapki

Jeśli stary Gateway używał --profile lub OPENCLAW_STATE_DIR, a nowy ich nie używa, kanały będą wyglądać na wylogowane, a sesje będą puste. Uruchom Gateway z tym samym profilem lub katalogiem stanu, który został przeniesiony, a następnie ponownie uruchom openclaw doctor.
Sam plik konfiguracyjny nie wystarczy. Profile uwierzytelniania modeli znajdują się w agents/<agentId>/agent/auth-profiles.json, a stan kanałów i dostawców znajduje się w credentials/. Zawsze przenoś cały katalog stanu.
Jeśli pliki skopiowano jako użytkownik root lub zmieniono użytkownika, Gateway może nie być w stanie odczytać danych uwierzytelniających. Upewnij się, że katalog stanu i obszar roboczy należą do użytkownika uruchamiającego Gateway.
Jeśli interfejs użytkownika wskazuje zdalny Gateway, to host zdalny przechowuje sesje i obszar roboczy. Przenieś sam host Gateway, a nie lokalny laptop. Zobacz często zadawane pytania.
Katalog stanu zawiera profile uwierzytelniania, dane uwierzytelniające kanałów oraz inne dane stanu dostawców. Przechowuj kopie zapasowe w postaci zaszyfrowanej, unikaj niezabezpieczonych kanałów przesyłania i zmień klucze, jeśli podejrzewasz ich ujawnienie.

​
Lista kontrolna weryfikacji

Na nowej maszynie potwierdź, że:
  • openclaw status pokazuje, że Gateway działa.
  • Kanały są nadal połączone (ponowne parowanie nie jest potrzebne).
  • Panel otwiera się i wyświetla istniejące sesje.
  • Pliki obszaru roboczego (pamięć, konfiguracje) są dostępne.

​
Uaktualnianie pluginu w miejscu

Uaktualnienia pluginu w miejscu zachowują ten sam identyfikator pluginu i klucze konfiguracji, ale mogą przenieść stan zapisany na dysku do bieżącego układu. Instrukcje uaktualniania poszczególnych pluginów znajdują się obok dokumentacji ich kanałów:
  • Migracja Matrix: ograniczenia odzyskiwania zaszyfrowanego stanu, automatyczne tworzenie migawek oraz polecenia ręcznego odzyskiwania.

​
Powiązane materiały