Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw migrate

Importuj stan z innego systemu agentów przez dostawcę migracji należącego do pluginu. Wbudowani dostawcy obejmują Claude i Hermes; pluginy firm trzecich mogą rejestrować dodatkowych dostawców.
Instrukcje dla użytkowników znajdziesz w Migracja z Claude i Migracja z Hermes. Centrum migracji zawiera listę wszystkich ścieżek.

​
Polecenia

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply claude --yes
openclaw migrate apply hermes --yes
openclaw migrate apply hermes --include-secrets --yes
openclaw onboard --flow import
openclaw onboard --import-from claude --import-source ~/.claude
openclaw onboard --import-from hermes --import-source ~/.hermes
​
<provider>
string
Nazwa zarejestrowanego dostawcy migracji, na przykład hermes. Uruchom openclaw migrate list, aby zobaczyć zainstalowanych dostawców.
​
--dry-run
boolean
Zbuduj plan i zakończ bez zmieniania stanu.
​
--from <path>
string
Zastąp katalog stanu źródłowego. Hermes domyślnie używa ~/.hermes.
​
--include-secrets
boolean
Importuj obsługiwane dane uwierzytelniające. Domyślnie wyłączone.
​
--overwrite
boolean
Zezwól, aby zastosowanie zastępowało istniejące cele, gdy plan zgłasza konflikty.
​
--yes
boolean
Pomiń monit o potwierdzenie. Wymagane w trybie nieinteraktywnym.
​
--no-backup
boolean
Pomiń kopię zapasową przed zastosowaniem. Wymaga --force, gdy istnieje lokalny stan OpenClaw.
​
--force
boolean
Wymagane razem z --no-backup, gdy zastosowanie w przeciwnym razie odmówiłoby pominięcia kopii zapasowej.
​
--json
boolean
Wypisz plan lub wynik zastosowania jako JSON. Z --json i bez --yes zastosowanie wypisuje plan i nie modyfikuje stanu.

​
Model bezpieczeństwa

openclaw migrate działa najpierw w trybie podglądu.
Dostawca zwraca szczegółowy plan przed jakimikolwiek zmianami, w tym konflikty, pominięte elementy i elementy wrażliwe. Plany JSON, dane wyjściowe zastosowania i raporty migracji redagują zagnieżdżone klucze wyglądające na tajne, takie jak klucze API, tokeny, nagłówki autoryzacji, pliki cookie i hasła.openclaw migrate apply <provider> wyświetla podgląd planu i pyta przed zmianą stanu, chyba że ustawiono --yes. W trybie nieinteraktywnym zastosowanie wymaga --yes.
Zastosowanie tworzy i weryfikuje kopię zapasową OpenClaw przed zastosowaniem migracji. Jeśli lokalny stan OpenClaw jeszcze nie istnieje, krok kopii zapasowej jest pomijany i migracja może być kontynuowana. Aby pominąć kopię zapasową, gdy stan istnieje, przekaż zarówno --no-backup, jak i --force.
Zastosowanie odmawia kontynuowania, gdy plan zawiera konflikty. Przejrzyj plan, a następnie uruchom ponownie z --overwrite, jeśli zastąpienie istniejących celów jest zamierzone. Dostawcy nadal mogą zapisywać kopie zapasowe na poziomie elementu dla nadpisanych plików w katalogu raportu migracji.
Sekrety nigdy nie są importowane domyślnie. Użyj --include-secrets, aby importować obsługiwane dane uwierzytelniające.

​
Dostawca Claude

Wbudowany dostawca Claude domyślnie wykrywa stan Claude Code w ~/.claude. Użyj --from <path>, aby zaimportować określony katalog domowy Claude Code lub katalog główny projektu.
Instrukcję dla użytkowników znajdziesz w Migracja z Claude.

​
Co importuje Claude

  • Projektowe CLAUDE.md i .claude/CLAUDE.md do obszaru roboczego agenta OpenClaw.
  • Użytkownika ~/.claude/CLAUDE.md dołączone do obszaru roboczego USER.md.
  • Definicje serwerów MCP z projektowego .mcp.json, Claude Code ~/.claude.json i Claude Desktop claude_desktop_config.json.
  • Katalogi Skills Claude zawierające SKILL.md.
  • Pliki Markdown poleceń Claude przekonwertowane na Skills OpenClaw tylko z ręcznym wywołaniem.

​
Stan archiwum i ręcznego przeglądu

Hooki Claude, uprawnienia, domyślne wartości środowiska, pamięć lokalna, reguły zakresowane ścieżką, podagenci, pamięci podręczne, plany i historia projektu są zachowywane w raporcie migracji lub zgłaszane jako elementy do ręcznego przeglądu. OpenClaw nie wykonuje hooków, nie kopiuje szerokich list dozwolonych ani nie importuje automatycznie stanu danych uwierzytelniających OAuth/Desktop.

​
Dostawca Hermes

Wbudowany dostawca Hermes domyślnie wykrywa stan w ~/.hermes. Użyj --from <path>, gdy Hermes znajduje się gdzie indziej.

​
Co importuje Hermes

  • Domyślną konfigurację modelu z config.yaml.
  • Skonfigurowanych dostawców 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 do obszaru roboczego agenta OpenClaw.
  • memories/MEMORY.md i memories/USER.md dołączone do plików pamięci obszaru roboczego.
  • Domyślne wartości konfiguracji pamięci dla pamięci plikowej OpenClaw oraz elementy archiwum lub ręcznego przeglądu dla zewnętrznych dostawców pamięci, takich jak Honcho.
  • Skills zawierające plik SKILL.md pod skills/<name>/.
  • Wartości konfiguracji dla poszczególnych Skills z skills.config.
  • Obsługiwane klucze API z .env, tylko z --include-secrets.

​
Obsługiwane klucze .env

OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY.

​
Stan tylko archiwizowany

Stan Hermes, którego OpenClaw nie może bezpiecznie zinterpretować, jest kopiowany do raportu migracji do ręcznego przeglądu, ale nie jest ładowany do aktywnej konfiguracji ani danych uwierzytelniających OpenClaw. Zachowuje to nieprzezroczysty lub niebezpieczny stan bez udawania, że OpenClaw może go automatycznie wykonać lub mu zaufać:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • auth.json
  • state.db

​
Po zastosowaniu

openclaw doctor

​
Kontrakt pluginu

Źródła migracji są pluginami. Plugin deklaruje identyfikatory swoich dostawców w openclaw.plugin.json: 
{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}
W czasie działania plugin wywołuje api.registerMigrationProvider(...). Dostawca implementuje detect, plan i apply. Rdzeń odpowiada za orkiestrację CLI, zasady kopii zapasowych, monity, dane wyjściowe JSON i wstępną kontrolę konfliktów. Rdzeń przekazuje przejrzany plan do apply(ctx, plan), a dostawcy mogą ponownie zbudować plan tylko wtedy, gdy ten argument jest nieobecny ze względu na zgodność. Pluginy dostawców mogą używać openclaw/plugin-sdk/migration do konstruowania elementów i zliczania podsumowań oraz openclaw/plugin-sdk/migration-runtime do kopiowania plików świadomego konfliktów, kopii raportów tylko do archiwum, buforowanych wrapperów config-runtime i raportów migracji.

​
Integracja wdrażania

Wdrażanie może zaoferować migrację, gdy dostawca wykryje znane źródło. Zarówno openclaw onboard --flow import, jak i openclaw setup --wizard --import-from hermes używają tego samego dostawcy migracji pluginu i nadal pokazują podgląd przed zastosowaniem.
Importy podczas wdrażania wymagają świeżej konfiguracji OpenClaw. Jeśli masz już lokalny stan, najpierw zresetuj konfigurację, dane uwierzytelniające, sesje i obszar roboczy. Importy typu kopia zapasowa plus nadpisanie lub scalanie są kontrolowane flagą funkcji dla istniejących konfiguracji.

​
Powiązane