Przejdź do głównej treści
OpenClaw importuje stan Hermes przez dołączonego dostawcę migracji. Dostawca pokazuje podgląd wszystkiego przed zmianą stanu, redaguje sekrety w planach i raportach oraz tworzy zweryfikowaną kopię zapasową przed zastosowaniem.
Importy wymagają ś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 openclaw migrate z --overwrite po przejrzeniu planu.

​
Dwa sposoby importu

Najszybsza ścieżka. Kreator wykrywa Hermes w ~/.hermes i pokazuje podgląd przed zastosowaniem.
openclaw onboard --flow import
Albo wskaż konkretne źródło:
openclaw onboard --import-from hermes --import-source ~/.hermes

​
Co jest importowane

  • Domyślny wybór modelu z Hermes config.yaml.
  • Skonfigurowani dostawcy modeli i niestandardowe punkty końcowe zgodne z OpenAI z providers i custom_providers.
Definicje serwerów MCP z mcp_servers lub mcp.servers.
  • SOUL.md i AGENTS.md są kopiowane do obszaru roboczego agenta OpenClaw.
  • memories/MEMORY.md i memories/USER.md są dołączane do odpowiadających im plików pamięci OpenClaw zamiast je nadpisywać.
Domyślne ustawienia konfiguracji pamięci dla pamięci plikowej OpenClaw. Zewnętrzni dostawcy 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 z plikiem SKILL.md w skills/<name>/ są kopiowane razem z wartościami konfiguracji dla poszczególnych Skills z skills.config.
Interaktywne openclaw migrate pyta przed zaimportowaniem danych uwierzytelniających, z domyślnie wybraną odpowiedzią tak. Akceptowane importy obejmują dane uwierzytelniające OpenCode OpenAI OAuth z OpenCode auth.json, wpisy OpenCode i GitHub Copilot z OpenCode auth.json oraz obsługiwane klucze .env. Wpisy OAuth Hermes auth.json są stanem starszego typu i są pokazywane jako ręczne ponowne uwierzytelnienie lub praca dla doctor zamiast importowania ich do aktywnego uwierzytelniania. Użyj --include-secrets przy nieinteraktywnym imporcie danych uwierzytelniających przez openclaw migrate, --no-auth-credentials, aby go pominąć, albo onboarding --import-secrets podczas importowania z kreatora wdrażania.

​
Co pozostaje tylko w archiwum

Dostawca kopiuje te elementy do katalogu raportu migracji do ręcznego przeglądu, ale nie ładuje ich do aktywnej konfiguracji ani danych uwierzytelniających OpenClaw:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
OpenClaw odmawia automatycznego wykonywania lub zaufania temu stanowi, ponieważ formaty i założenia zaufania mogą różnić się między systemami. Przenieś potrzebne elementy ręcznie po przejrzeniu archiwum.

​
Zalecany przepływ

1

Podejrzyj plan

openclaw migrate hermes --dry-run
Plan wymienia wszystko, co zostanie zmienione, w tym konflikty, pominięte elementy i wszelkie elementy wrażliwe. Dane wyjściowe planu redagują zagnieżdżone klucze wyglądające na sekrety.
2

Zastosuj z kopią zapasową

openclaw migrate apply hermes --yes
OpenClaw tworzy i weryfikuje kopię zapasową przed zastosowaniem. Ten nieinteraktywny przykład importuje stan bez sekretów. Uruchom bez --yes, aby odpowiedzieć na monit o dane uwierzytelniające, albo dodaj --include-secrets, aby uwzględnić obsługiwane dane uwierzytelniające w uruchomieniach bez nadzoru.
3

Uruchom doctor

openclaw doctor
Doctor ponownie stosuje oczekujące migracje konfiguracji i sprawdza problemy wprowadzone podczas importu.
4

Uruchom ponownie i zweryfikuj

openclaw gateway restart
openclaw status
Potwierdź, że Gateway jest sprawny, a zaimportowany model, pamięć i Skills są załadowane.

​
Obsługa konfliktów

Zastosowanie odmawia kontynuacji, gdy plan zgłasza konflikty (plik lub wartość konfiguracji już istnieje w miejscu docelowym).
Uruchom ponownie z --overwrite tylko wtedy, gdy zastąpienie istniejącego celu jest zamierzone. Dostawcy nadal mogą zapisywać kopie zapasowe na poziomie elementów dla nadpisanych plików w katalogu raportu migracji.
W przypadku świeżej instalacji OpenClaw konflikty są nietypowe. Zwykle pojawiają się, gdy ponownie uruchamiasz import w konfiguracji, która ma już edycje użytkownika. Jeśli konflikt pojawi się w trakcie stosowania (na przykład nieoczekiwany wyścig na pliku konfiguracji), Hermes oznaczy pozostałe zależne elementy konfiguracji jako skipped z powodem blocked by earlier apply conflict zamiast zapisywać je częściowo. Raport migracji zapisuje każdy zablokowany element, aby można było rozwiązać pierwotny konflikt i ponownie uruchomić import.

​
Sekrety

Interaktywne openclaw migrate pyta, czy zaimportować wykryte dane uwierzytelniające, z domyślnie wybraną odpowiedzią tak.
  • Akceptacja monitu importuje dane uwierzytelniające OpenCode OpenAI OAuth z OpenCode auth.json, wpisy OpenCode i GitHub Copilot z OpenCode auth.json oraz obsługiwane klucze .env. Wpisy OAuth Hermes auth.json są zgłaszane do ręcznego ponownego uwierzytelnienia OpenAI lub naprawy przez doctor.
  • Użyj --no-auth-credentials albo wybierz nie w monicie, aby zaimportować tylko stan bez sekretów.
  • Użyj --include-secrets podczas uruchamiania bez nadzoru z --yes.
  • Użyj onboarding --import-secrets podczas importowania danych uwierzytelniających z kreatora wdrażania.
  • W przypadku danych uwierzytelniających zarządzanych przez SecretRef skonfiguruj źródło SecretRef po zakończeniu importu.

​
Dane wyjściowe JSON do automatyzacji

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes
Z --json i bez --yes zastosowanie wypisuje plan i nie modyfikuje stanu. To najbezpieczniejszy tryb dla CI i współdzielonych skryptów.

​
Rozwiązywanie problemów

Sprawdź dane wyjściowe planu. Każdy konflikt identyfikuje ścieżkę źródłową i istniejący cel. Dla każdego elementu zdecyduj, czy go pominąć, edytować cel, czy uruchomić ponownie z --overwrite.
Przekaż --from /actual/path (CLI) albo --import-source /actual/path (onboarding).
Importy przez onboarding wymagają świeżej konfiguracji. Zresetuj stan i ponownie przejdź onboarding albo użyj bezpośrednio openclaw migrate apply hermes, które obsługuje --overwrite i jawne sterowanie kopią zapasową.
Interaktywne openclaw migrate importuje klucze API tylko wtedy, gdy zaakceptujesz monit o dane uwierzytelniające. Nieinteraktywne uruchomienia --yes wymagają --include-secrets; importy przez onboarding wymagają --import-secrets. Rozpoznawane są tylko obsługiwane klucze .env; inne zmienne w .env są ignorowane.

​
Powiązane

  • openclaw migrate: pełny opis CLI, kontrakt Plugin i kształty JSON.
  • Onboarding: przepływ kreatora i flagi nieinteraktywne.
  • Migracja: przenieś instalację OpenClaw między maszynami.
  • Doctor: kontrola kondycji po migracji.
  • Obszar roboczy agenta: miejsce, w którym znajdują się SOUL.md, AGENTS.md i pliki pamięci.