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

Maintenance

Migracja z Hermes

Dostarczony provider migracji Hermes wykrywa stan w ~/.hermes, wyświetla podgląd każdej zmiany przed jej zastosowaniem, redaguje sekrety w planach i raportach oraz tworzy zweryfikowaną kopię zapasową OpenClaw, zanim cokolwiek zmodyfikuje.

Dwa sposoby importowania

Kreator wdrażania

Wykrywa Hermes w ~/.hermes i wyświetla podgląd przed zastosowaniem zmian.

bash
openclaw onboard --flow import

Możesz też wskazać konkretne źródło:

bash
openclaw onboard --import-from hermes --import-source ~/.hermes

CLI

Użyj openclaw migrate do uruchomień skryptowych lub powtarzalnych. Pełną dokumentację znajdziesz w sekcji openclaw migrate.

bash
openclaw migrate hermes --dry-run    # tylko podglądopenclaw migrate apply hermes --yes  # zastosowanie z pominięciem potwierdzenia

Dodaj --from <path>, jeśli Hermes znajduje się poza ~/.hermes.

Co jest importowane

Konfiguracja modelu
  • Domyślny wybór modelu z pliku Hermes config.yaml.
  • Skonfigurowani providerzy modeli i niestandardowe punkty końcowe zgodne z OpenAI z providers oraz custom_providers.
Serwery MCP

Definicje serwerów MCP z mcp_servers lub mcp.servers.

Pliki obszaru roboczego
  • Pliki SOUL.md i AGENTS.md są kopiowane do obszaru roboczego agenta OpenClaw.
  • Pliki memories/MEMORY.md i memories/USER.md są dołączane do odpowiednich plików pamięci OpenClaw zamiast ich nadpisywania.
Konfiguracja pamięci

Domyślna konfiguracja pamięci plikowej OpenClaw. Zewnętrzni providerzy pamięci, tacy jak Honcho, są zapisywani jako elementy archiwalne lub wymagające ręcznego przeglądu, aby można było przenieść je świadomie.

Skills

Skills zawierające plik SKILL.md w katalogu skills/<name>/ są kopiowane wraz z wartościami konfiguracji poszczególnych Skills z skills.config.

Dane uwierzytelniające

Interaktywne polecenie openclaw migrate pyta przed zaimportowaniem danych uwierzytelniających, przy czym domyślnie wybrana jest odpowiedź „tak”. Zaakceptowanie powoduje import wpisów OpenCode OpenAI OAuth i GitHub Copilot z pliku auth.json OpenCode oraz obsługiwanych kluczy .env Hermes. Wpisy OAuth z własnego pliku auth.json Hermes stanowią starszy stan: zamiast importowania ich do aktywnego uwierzytelniania są zgłaszane jako element wymagający ręcznego ponownego uwierzytelnienia lub użycia narzędzia doctor. Użyj --include-secrets, aby zaimportować dane uwierzytelniające podczas uruchomienia nieinteraktywnego, --no-auth-credentials, aby całkowicie pominąć ich import, albo flagi --import-secrets kreatora wdrażania.

Co pozostaje wyłącznie w archiwum

Provider kopiuje poniższe elementy do katalogu raportu migracji w celu ręcznego przeglądu, ale nie wczytuje ich do aktywnej konfiguracji ani danych uwierzytelniających OpenClaw:

  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db

OpenClaw odmawia automatycznego wykonywania lub uznawania tego stanu za zaufany, ponieważ formaty i założenia dotyczące zaufania mogą różnić się między systemami. Po przejrzeniu archiwum przenieś ręcznie potrzebne elementy.

Zalecany przebieg

  • Wyświetl podgląd planu

    bash
    openclaw migrate hermes --dry-run

    Plan zawiera wszystkie przyszłe zmiany, w tym konflikty, pominięte elementy i elementy poufne. Zagnieżdżone klucze przypominające sekrety są redagowane w danych wyjściowych.

  • Zastosuj z kopią zapasową

    bash
    openclaw migrate apply hermes --yes

    Przed zastosowaniem zmian OpenClaw tworzy i weryfikuje kopię zapasową. Ten przykład nieinteraktywny importuje wyłącznie stan niezawierający sekretów. Uruchom polecenie bez --yes, aby interaktywnie odpowiedzieć na pytanie dotyczące danych uwierzytelniających, albo dodaj --include-secrets, aby uwzględnić obsługiwane dane uwierzytelniające podczas uruchomienia bez nadzoru.

  • Uruchom narzędzie doctor

    bash
    openclaw doctor

    Doctor ponownie stosuje wszystkie oczekujące migracje konfiguracji i sprawdza problemy powstałe podczas importowania.

  • Uruchom ponownie i zweryfikuj

    bash
    openclaw gateway restartopenclaw status

    Sprawdź, czy Gateway działa prawidłowo oraz czy zaimportowany model, pamięć i Skills zostały wczytane.

    • Obsługa konfliktów

    Zastosowanie zmian nie będzie kontynuowane, jeśli plan zgłosi konflikty — plik lub wartość konfiguracji już istnieje w miejscu docelowym.

    Konflikty występują rzadko w świeżej instalacji. Zwykle pojawiają się po ponownym uruchomieniu importu względem konfiguracji, która zawiera już zmiany użytkownika.

    Jeśli konflikt wystąpi w trakcie stosowania zmian, na przykład z powodu nieoczekiwanego wyścigu dotyczącego pliku konfiguracyjnego, Hermes oznaczy pozostałe zależne elementy konfiguracji jako skipped z powodem blocked by earlier apply conflict, zamiast zapisywać je częściowo. Raport migracji rejestruje każdy zablokowany element, aby umożliwić rozwiązanie pierwotnego konfliktu i ponowne uruchomienie importu.

    Sekrety

    Interaktywne polecenie openclaw migrate pyta, czy zaimportować wykryte dane uwierzytelniające, przy czym domyślnie wybrana jest odpowiedź „tak”.

    • Zaakceptowanie powoduje import wpisów OpenCode OpenAI OAuth i GitHub Copilot z pliku auth.json OpenCode oraz obsługiwanych kluczy .env. Wpisy OAuth z własnego pliku auth.json Hermes są natomiast zgłaszane do ręcznego ponownego uwierzytelnienia OpenAI lub naprawy za pomocą narzędzia doctor.
    • Użyj --no-auth-credentials lub odpowiedz „nie” na pytanie, aby zaimportować wyłącznie stan niezawierający sekretów.
    • Użyj --include-secrets, aby zaimportować dane uwierzytelniające podczas uruchomienia --yes bez nadzoru.
    • Użyj flagi --import-secrets kreatora wdrażania, aby zaimportować dane uwierzytelniające za pomocą kreatora.

    Dane wyjściowe JSON na potrzeby automatyzacji

    bash
    openclaw migrate hermes --dry-run --jsonopenclaw migrate apply hermes --json --yes

    W przypadku użycia --json bez --yes zastosowanie zmian wyświetla plan i nie modyfikuje stanu — jest to najbezpieczniejszy tryb dla CI i współdzielonych skryptów.

    Rozwiązywanie problemów

    Zastosowanie zmian zostaje odrzucone z powodu konfliktów

    Sprawdź dane wyjściowe planu. Każdy konflikt wskazuje ścieżkę źródłową i istniejący element docelowy. Dla każdego elementu zdecyduj, czy go pominąć, edytować element docelowy, czy ponownie uruchomić polecenie z opcją --overwrite.

    Hermes znajduje się poza ~/.hermes

    Przekaż --from /actual/path w CLI lub --import-source /actual/path podczas wdrażania.

    Kreator wdrażania odmawia importu do istniejącej konfiguracji

    Importowanie podczas wdrażania wymaga świeżej konfiguracji. Zresetuj stan i ponownie przeprowadź wdrażanie albo użyj bezpośrednio polecenia openclaw migrate apply hermes, które obsługuje --overwrite oraz jawne sterowanie kopiami zapasowymi.

    Klucze API nie zostały zaimportowane

    Interaktywne polecenie openclaw migrate importuje klucze API tylko po zaakceptowaniu pytania dotyczącego danych uwierzytelniających. Nieinteraktywne uruchomienia z --yes wymagają opcji --include-secrets, a importowanie podczas wdrażania wymaga --import-secrets. Rozpoznawane są wyłącznie obsługiwane klucze .env — pozostałe zmienne .env są ignorowane.

    Powiązane materiały

    • openclaw migrate: pełna dokumentacja CLI, kontrakt Pluginu i struktury JSON.
    • Wdrażanie: przebieg kreatora i flagi trybu nieinteraktywnego.
    • Migracja: przenoszenie instalacji OpenClaw między komputerami.
    • Doctor: kontrola stanu po migracji.
    • Obszar roboczy agenta: lokalizacja plików SOUL.md, AGENTS.md i plików pamięci.
    Was this useful?
    On this page

    On this page