# openclaw migrate

Імпортуйте стан з іншої агентної системи через провайдера міграції, що належить Plugin. Вбудовані провайдери охоплюють стан Codex CLI, Claude і Hermes; сторонні Plugin можуть реєструвати додаткових провайдерів.

# Команди

openclaw migrate list
openclaw migrate claude --dry-run
openclaw migrate codex --dry-run
openclaw migrate codex --skill gog-vault77-google-workspace
openclaw migrate hermes --dry-run
openclaw migrate hermes
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes
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

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ijxwcm92aWRlcg " type="string"> Назва зареєстрованого провайдера міграції, наприклад hermes. Запустіть openclaw migrate list, щоб переглянути встановлених провайдерів.

--dry-runboolean

Побудувати план і вийти без зміни стану.

OPENCLAW_DOCS_MARKER:paramOpen:IHBhdGg9Ii0tZnJvbSA8cGF0aA " type="string"> Перевизначити каталог початкового стану. Hermes за замовчуванням використовує ~/.hermes.

--include-secretsboolean

Імпортувати підтримувані облікові дані. Вимкнено за замовчуванням.

--overwriteboolean

Дозволити apply замінювати наявні цільові об'єкти, коли план повідомляє про конфлікти.

--yesboolean

Пропустити запит підтвердження. Потрібно в неінтерактивному режимі.

"--skill

--no-backupboolean

Пропустити резервну копію перед застосуванням. Потребує --force, коли існує локальний стан OpenClaw.

--forceboolean

Потрібно разом із --no-backup, коли apply інакше відмовився б пропустити резервну копію.

--jsonboolean

Вивести план або результат застосування як JSON. З --json і без --yes apply виводить план і не змінює стан.

# Модель безпеки

openclaw migrate спочатку показує попередній перегляд.

# Провайдер Claude

Вбудований провайдер Claude за замовчуванням виявляє стан Claude Code у ~/.claude. Використовуйте --from <path>, щоб імпортувати конкретний домашній каталог Claude Code або корінь проєкту.

# Що імпортує Claude

• Проєктні CLAUDE.md і .claude/CLAUDE.md у робочу область агента OpenClaw.
• Користувацький ~/.claude/CLAUDE.md, доданий до USER.md робочої області.
• Визначення серверів MCP з проєктного .mcp.json, Claude Code ~/.claude.json і Claude Desktop claude_desktop_config.json.
• Каталоги Claude skill, які містять SKILL.md.
• Markdown-файли команд Claude, перетворені на OpenClaw skills лише з ручним викликом.

# Стан архіву й ручного перегляду

Хуки Claude, дозволи, типові значення середовища, локальна пам'ять, правила з областю дії за шляхами, субагенти, кеші, плани та історія проєкту зберігаються у звіті міграції або повідомляються як елементи для ручного перегляду. OpenClaw не виконує хуки, не копіює широкі списки дозволів і не імпортує стан облікових даних OAuth/Desktop автоматично.

# Провайдер Codex

Вбудований провайдер Codex за замовчуванням виявляє стан Codex CLI у ~/.codex або в CODEX_HOME, коли ця змінна середовища встановлена. Використовуйте --from <path>, щоб інвентаризувати конкретний домашній каталог Codex.

Використовуйте цього провайдера під час переходу до OpenClaw Codex harness, коли потрібно свідомо просунути корисні особисті ресурси Codex CLI. Локальні запуски app-server Codex використовують окремі для кожного агента каталоги CODEX_HOME і HOME, тому за замовчуванням не читають ваш особистий стан Codex CLI.

Запуск openclaw migrate codex в інтерактивному терміналі показує попередній перегляд повного плану, потім відкриває селектор із прапорцями для елементів копіювання skill перед фінальним підтвердженням застосування. Використовуйте Toggle all on або Toggle all off для масового вибору; заплановані skills спочатку позначені, конфліктні skills спочатку не позначені, а Skip for now залишає skills без змін і без застосування. Для скриптованих або точних запусків передайте --skill <name> один раз для кожного skill, наприклад:

openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace

# Що імпортує Codex

• Каталоги skill Codex CLI у $CODEX_HOME/skills, за винятком кешу Codex .system.
• Особисті AgentSkills у $HOME/.agents/skills, скопійовані в поточну робочу область агента OpenClaw, коли потрібне володіння на рівні агента.

# Стан Codex для ручного перегляду

Нативні Plugin Codex, config.toml і нативний hooks/hooks.json не активуються автоматично. Plugin можуть надавати сервери MCP, застосунки, хуки або іншу виконувану поведінку, тому провайдер повідомляє про них для перегляду замість завантаження в OpenClaw. Файли конфігурації та хуків копіюються до звіту міграції для ручного перегляду.

# Провайдер Hermes

Вбудований провайдер Hermes за замовчуванням виявляє стан у ~/.hermes. Використовуйте --from <path>, коли Hermes розташований деінде.

# Що імпортує Hermes

• Типову конфігурацію моделі з config.yaml.
• Налаштованих провайдерів моделей і власні OpenAI-сумісні кінцеві точки з providers і custom_providers.
• Визначення серверів MCP з mcp_servers або mcp.servers.
• SOUL.md і AGENTS.md у робочу область агента OpenClaw.
• memories/MEMORY.md і memories/USER.md, додані до файлів пам'яті робочої області.
• Типові значення конфігурації пам'яті для файлової пам'яті OpenClaw, а також архівні елементи або елементи ручного перегляду для зовнішніх провайдерів пам'яті, як-от Honcho.
• Skills, які містять файл SKILL.md у skills/<name>/.
• Значення конфігурації для кожного skill з skills.config.
• Підтримувані API-ключі з .env, лише з --include-secrets.

# Підтримувані ключі .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.

# Стан лише для архіву

Стан Hermes, який OpenClaw не може безпечно інтерпретувати, копіюється до звіту міграції для ручного перегляду, але не завантажується в активну конфігурацію або облікові дані OpenClaw. Це зберігає непрозорий або небезпечний стан без удавання, що OpenClaw може автоматично виконувати його або довіряти йому:

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

# Після застосування

openclaw doctor

# Контракт Plugin

Джерела міграції є Plugin. Plugin оголошує свої ідентифікатори провайдерів у openclaw.plugin.json:

{
  "contracts": {
    "migrationProviders": ["hermes"]
  }
}

Під час виконання Plugin викликає api.registerMigrationProvider(...). Провайдер реалізує detect, plan і apply. Ядро відповідає за оркестрацію CLI, політику резервного копіювання, запити, вивід JSON і попередню перевірку конфліктів. Ядро передає переглянутий план у apply(ctx, plan), а провайдери можуть перебудовувати план лише тоді, коли цей аргумент відсутній для сумісності.

Plugin-провайдери можуть використовувати openclaw/plugin-sdk/migration для побудови елементів і підрахунків у підсумку, а також openclaw/plugin-sdk/migration-runtime для копіювання файлів з урахуванням конфліктів, копій звітів лише для архіву, кешованих обгорток config-runtime і звітів міграції.

# Інтеграція з онбордингом

Онбординг може запропонувати міграцію, коли провайдер виявляє відоме джерело. І openclaw onboard --flow import, і openclaw setup --wizard --import-from hermes використовують того самого Plugin-провайдера міграції та все одно показують попередній перегляд перед застосуванням.

# Пов'язане

• Міграція з Hermes: користувацька покрокова інструкція.
• Міграція з Claude: користувацька покрокова інструкція.
• Міграція: перенесення OpenClaw на нову машину.
• Doctor: перевірка працездатності після застосування міграції.
• Plugins: встановлення та реєстрація Plugin.