// dokumentacja openclaw

Migracja OpenClaw — przenoszenie Gateway na nową maszynę

Migracja OpenClaw na nową maszynę

Ten poradnik opisuje przenoszenie Gateway OpenClaw na nowy serwer lub komputer z zachowaniem całej konfiguracji i stanu. Proces jest bezpieczny i odwracalny — oryginalna maszyna nie jest modyfikowana destrukcyjnie.

Co zostaje zachowane

Migracja przenosi wszystkie kluczowe dane:

  • Konfiguracja — ustawienia Gateway w pliku openclaw.json.
  • Uwierzytelnianie — profil auth-profiles.json z kluczami API, tokenami OAuth i stanem providerów.
  • Dane konwersacji — historia sesji i stan agentów.
  • Integracje kanałów — sesje logowania WhatsApp, dane uwierzytelniające Telegram, Discord i inne.
  • Workspace — pliki pamięci, dokumentacja użytkownika, własne umiejętności (skills) i szablony promptów.

Krok 1 — Backup na starej maszynie

Zatrzymaj Gateway i utwórz skompresowane archiwum katalogu stanu:

# Zatrzymaj Gateway
openclaw gateway stop

# Utwroz backup
openclaw backup create
# lub recznie:
tar czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

Archiwum zawiera pełny stan — konfigurację, sesje, klucze i dane workspace.

Krok 2 — Przygotowanie nowej maszyny

# Zainstaluj Node.js i OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# Pozwol na utworzenie swiezego katalogu stanu
openclaw --version

Krok 3 — Transfer i rozpakowanie

Przenieś archiwum na nową maszynę i rozpakuj:

# Transfer przez SCP
scp openclaw-backup-20260409.tar.gz user@nowa-maszyna:~/

# Na nowej maszynie — rozpakuj
cd ~
tar xzf openclaw-backup-20260409.tar.gz

# Zweryfikuj uprawnienia
ls -la ~/.openclaw/

Upewnij się, że właściciel plików odpowiada bieżącemu użytkownikowi. W razie potrzeby:

chown -R $(whoami):$(whoami) ~/.openclaw/

Krok 4 — Walidacja

# Diagnostyka i migracja konfiguracji
openclaw doctor

# Uruchom Gateway
openclaw gateway start

# Sprawdz status
openclaw gateway status

Weryfikacja po migracji

  • Sprawdź status Gateway — powinien działać bez błędów.
  • Zweryfikuj łączność kanałów — WhatsApp, Telegram i inne powinny działać bez konieczności ponownego uwierzytelniania.
  • Otwórz panel sterowania — istniejące sesje i historia powinny być widoczne.
  • Sprawdź pliki workspace — pamięć agentów, skills i szablony powinny być dostępne.

Ważne ostrzeżenia

  • Nazwy profili — używaj identycznych nazw profili lub zmiennych środowiskowych na nowej maszynie, aby uniknąć problemów z uwierzytelnianiem.
  • Cały katalog stanu — nie kopiuj tylko pliku konfiguracyjnego. Migruj cały katalog ~/.openclaw, aby zachować wszystkie dane.
  • Uprawnienia plików — nieprawidłowe uprawnienia mogą uniemożliwić dostęp do kluczy i tokenów.
  • Serwer zdalny — migruj serwer Gateway, a nie maszynę z interfejsem użytkownika.
  • Bezpieczeństwo — przechowuj kopie zapasowe w zaszyfrowanej formie, unikaj niezabezpieczonych kanałów transferu i rotuj klucze, jeśli podejrzewasz ich wyciek.
Wróc do dokumentacji