OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Maintenance

Przewodnik migracji

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.

Kroki migracji

  • 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:

    bash
    openclaw gateway stopcd ~tar -czf openclaw-state.tgz .openclaw

    Jeśli używasz wielu profili (na przykład ~/.openclaw-work), zarchiwizuj każdy z nich osobno.

  • 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.

  • Skopiuj katalog stanu i obszar roboczy

    Przenieś archiwum za pomocą scp, rsync -a lub dysku zewnętrznego, a następnie je rozpakuj:

    bash
    cd ~tar -xzf openclaw-state.tgz

    Upewnij się, że uwzględniono ukryte katalogi, a właścicielem plików jest użytkownik, który będzie uruchamiać Gateway.

  • Uruchom narzędzie diagnostyczne i przeprowadź weryfikację

    Na nowej maszynie uruchom narzędzie diagnostyczne, aby zastosować migracje konfiguracji i naprawić usługi:

    bash
    openclaw doctoropenclaw gateway restartopenclaw status

    • 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:

    bash
    awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env

    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

    Niezgodność profilu lub katalogu stanu

    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.

    Kopiowanie tylko pliku openclaw.json

    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.

    Uprawnienia i własność

    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.

    Tryb zdalny

    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.

    Sekrety w kopiach zapasowych

    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

    Was this useful?
    On this page

    On this page