English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Maintenance

Przewodnik migracji

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.

Kroki migracji

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

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

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

  • 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

    Niezgodność profilu lub katalogu stanu

    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.

    Kopiowanie tylko 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 migruj cały katalog stanu.

    Uprawnienia i właściciel

    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.

    Tryb zdalny

    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.

    Sekrety w kopiach zapasowych

    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