Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw obsługuje trzy ścieżki migracji: import z innego systemu agentów, przeniesienie istniejącej instalacji na nową maszynę oraz uaktualnienie Plugin na miejscu.

​
Import z innego systemu agentów

Użyj dołączonych dostawców migracji, aby przenieść instrukcje, serwery MCP, umiejętności, konfigurację modelu oraz (opcjonalnie) klucze API do OpenClaw. Plany są wyświetlane do podglądu przed jakąkolwiek zmianą, sekrety są redagowane 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, umiejętności oraz polecenia projektowe.

Migracja z Hermes

Importuj konfigurację Hermes, dostawców, serwery MCP, pamięć, umiejętności oraz obsługiwane klucze .env.
Punkt wejścia CLI to openclaw migrate. Onboarding może również zaproponować migrację, gdy wykryje znane źródło (openclaw onboard --flow import).

​
Przenieś OpenClaw na nową maszynę

Skopiuj katalog stanu (domyślnie ~/.openclaw/) oraz swój obszar roboczy, aby zachować:
  • Konfigurację — openclaw.json i wszystkie ustawienia Gateway.
  • Uwierzytelnianie — profile auth-profiles.json dla poszczególnych agentów (klucze API oraz OAuth), a także każdy stan kanału lub dostawcy w credentials/.
  • Sesje — historię rozmów i stan agenta.
  • Stan kanałów — logowanie WhatsApp, sesję Telegram i podobne.
  • Pliki obszaru roboczego — MEMORY.md, USER.md, umiejętności i prompty.
Uruchom openclaw status na starej maszynie, aby potwierdzić ścieżkę katalogu stanu. Profile niestandardowe używają ~/.openclaw-<profile>/ albo ścieżki ustawionej przez OPENCLAW_STATE_DIR.

​
Kroki migracji

1

Zatrzymaj gateway i wykonaj kopię zapasową

Na starej maszynie zatrzymaj gateway, aby pliki nie zmieniały się w trakcie kopiowania, a następnie utwórz archiwum:
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
Jeśli używasz wielu profili (na przykład ~/.openclaw-work), zarchiwizuj każdy osobno.
2

Zainstaluj OpenClaw na nowej maszynie

Zainstaluj CLI (i Node, jeśli jest potrzebny) na nowej maszynie. Nie szkodzi, jeśli onboarding utworzy świeży katalog ~/.openclaw/. Nadpiszesz go w następnym kroku.
3

Skopiuj katalog stanu i obszar roboczy

Przenieś archiwum przez scp, rsync -a albo dysk zewnętrzny, a następnie je rozpakuj:
cd ~
tar -xzf openclaw-state.tgz
Upewnij się, że katalogi ukryte zostały uwzględnione, a właściciel plików odpowiada użytkownikowi, który będzie uruchamiał gateway.
4

Uruchom doctor i zweryfikuj

Na nowej maszynie uruchom Doctor, aby zastosować migracje konfiguracji i naprawić usługi:
openclaw doctor
openclaw gateway restart
openclaw status
Jeśli Telegram lub Discord używa domyślnego fallbacku env (TELEGRAM_BOT_TOKEN albo DISCORD_BOT_TOKEN), sprawdź, czy przeniesiony plik .env w katalogu stanu zawiera te klucze, bez wypisywania wartości sekretów: 
awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env
openclaw doctor ostrzega również wtedy, gdy włączone domyślne konto Telegram lub Discord nie ma skonfigurowanego tokenu, a pasująca zmienna env jest niedostępna dla procesu doctor.

​
Typowe problemy

Jeśli stary gateway używał --profile albo 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 migruj cały katalog stanu.
Jeśli pliki zostały skopiowane jako root albo zmienił się użytkownik, gateway może nie być w stanie odczytać poświadczeń. Upewnij się, że katalog stanu i obszar roboczy należą do użytkownika uruchamiającego gateway.
Jeśli Twój UI wskazuje na zdalny gateway, to zdalny host jest właścicielem sesji i obszaru roboczego. Migruj sam host gateway, a nie lokalny laptop. Zobacz FAQ.
Katalog stanu zawiera profile uwierzytelniania, poświadczenia kanałów oraz inny stan dostawców. Przechowuj kopie zapasowe w postaci zaszyfrowanej, unikaj niezabezpieczonych kanałów przesyłania i rotuj klucze, jeśli podejrzewasz ujawnienie.

​
Lista kontrolna weryfikacji

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

​
Uaktualnij Plugin na miejscu

Uaktualnienia Plugin na miejscu zachowują ten sam identyfikator Plugin i klucze konfiguracji, ale mogą przenieść stan na dysku do bieżącego układu. Przewodniki uaktualniania właściwe dla Plugin znajdują się obok ich kanałów:
  • Migracja Matrix: limity odzyskiwania stanu szyfrowanego, automatyczne zachowanie migawek oraz ręczne polecenia odzyskiwania.

​
Powiązane