Skip to main content
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.
Import wymaga świeżej konfiguracji OpenClaw. Jeśli masz już lokalny stan OpenClaw, najpierw zresetuj konfigurację, dane uwierzytelniające, sesje i obszar roboczy albo użyj bezpośrednio polecenia openclaw migrate apply hermes z opcją --overwrite po przejrzeniu planu.

​
Dwa sposoby importowania

Wykrywa Hermes w ~/.hermes i wyświetla podgląd przed zastosowaniem zmian.
Możesz też wskazać konkretne źródło:

​
Co jest importowane

  • 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.
Definicje serwerów MCP z mcp_servers lub mcp.servers.
  • 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.
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 zawierające plik SKILL.md w katalogu skills/<name>/ są kopiowane wraz z wartościami konfiguracji poszczególnych Skills z skills.config.
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

1

Wyświetl podgląd planu

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

Zastosuj z kopią zapasową

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

Uruchom narzędzie doctor

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

Uruchom ponownie i zweryfikuj

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.
Uruchom ponownie z opcją --overwrite tylko wtedy, gdy zamierzasz zastąpić istniejący element docelowy. Providerzy mogą nadal tworzyć kopie zapasowe nadpisywanych plików na poziomie poszczególnych elementów w katalogu raportu migracji.
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

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

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.
Przekaż --from /actual/path w CLI lub --import-source /actual/path podczas wdrażania.
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.
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.