--- read_when: - Ви хочете перейти з Hermes або іншої агентної системи на OpenClaw - Ви додаєте постачальника міграцій, що належить плагіну summary: Довідник CLI для `openclaw migrate` (імпорт стану з іншої агентної системи) title: Мігрувати x-i18n: generated_at: "2026-07-12T13:08:03Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 1160373bfec09de8ec1bac6fbe8a218e8af7ec6a5896bc1fdfe6a0db158d50a1 source_path: cli/migrate.md workflow: 16 --- # `openclaw migrate` Імпортуйте стан з іншої агентної системи через постачальника міграції, яким керує Plugin. Вбудовані постачальники підтримують Claude, Codex CLI та [Hermes](/uk/install/migrating-hermes); плагіни можуть реєструвати додаткових постачальників. Покрокові інструкції для користувачів дивіться в розділах [Міграція з Claude](/uk/install/migrating-claude) та [Міграція з Hermes](/uk/install/migrating-hermes). У [центрі міграції](/uk/install/migrating) перелічено всі шляхи. ## Команди ```bash openclaw migrate list openclaw migrate claude --dry-run openclaw migrate codex --dry-run openclaw migrate codex --skill gog-vault77-google-workspace openclaw migrate codex --plugin google-calendar --dry-run openclaw migrate codex --plugin google-calendar --verify-plugin-apps --dry-run openclaw migrate hermes --dry-run openclaw migrate hermes openclaw migrate apply codex --yes --skill gog-vault77-google-workspace openclaw migrate apply codex --yes --plugin google-calendar 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 migrate ` без інших прапорців створює план, показує попередній перегляд і (у TTY) запитує підтвердження перед застосуванням. `openclaw migrate plan ` та `openclaw migrate apply ` розділяють попередній перегляд і застосування на окремі підкоманди з тими самими прапорцями. Ім’я зареєстрованого постачальника міграції, наприклад `hermes`. Виконайте `openclaw migrate list`, щоб переглянути встановлених постачальників. Створити план і завершити роботу без зміни стану. Перевизначити каталог вихідного стану. Типове значення для Hermes — `~/.hermes`, для Codex — `~/.codex` (або `$CODEX_HOME`), для Claude — `~/.claude`. Імпортувати підтримувані облікові дані без запиту. Під час інтерактивного застосування перед імпортом виявлених облікових даних автентифікації з’являється запит, у якому типово вибрано «так»; для їх імпорту в неінтерактивному режимі з `--yes` потрібен прапорець `--include-secrets`. Пропустити імпорт облікових даних автентифікації, включно з інтерактивним запитом. Дозволити під час застосування замінювати наявні цільові об’єкти, якщо план повідомляє про конфлікти. Пропустити запит підтвердження. Обов’язковий у неінтерактивному режимі. Вибрати один елемент копіювання Skills за його назвою або ідентифікатором елемента. Повторіть прапорець, щоб перенести кілька Skills. Якщо прапорець не вказано, інтерактивні міграції Codex показують засіб вибору з прапорцями, а неінтерактивні міграції зберігають усі заплановані Skills. Вибрати один елемент установлення плагіна Codex за назвою плагіна або ідентифікатором елемента. Повторіть прапорець, щоб перенести кілька плагінів Codex. Якщо прапорець не вказано, інтерактивні міграції Codex показують вбудований засіб вибору плагінів Codex із прапорцями, а неінтерактивні міграції зберігають усі заплановані плагіни. Застосовується лише до встановлених із вихідного коду плагінів Codex `openai-curated`, виявлених інвентаризацією сервера застосунків Codex. Лише для Codex. Примусово виконує свіжий обхід `app/list` вихідного сервера застосунків Codex перед плануванням активації вбудованих плагінів. Типово вимкнено, щоб планування міграції залишалося швидким. Шлях до архіву або каталогу резервної копії перед міграцією. Передається без змін до `openclaw backup create`. Пропустити резервне копіювання перед застосуванням. Потребує `--force`, якщо існує локальний стан OpenClaw. Обов’язковий разом із `--no-backup`, якщо інакше застосування відмовилося б пропустити резервне копіювання. Вивести план або результат застосування у форматі JSON. Якщо вказано `--json` без `--yes`, команда застосування виводить план і не змінює стан. ## Модель безпеки `openclaw migrate` насамперед показує попередній перегляд. Постачальник повертає деталізований план до внесення будь-яких змін, включно з конфліктами, пропущеними та конфіденційними елементами. У планах JSON, виведенні застосування та звітах про міграцію приховуються вкладені ключі, схожі на секрети, зокрема ключі API, токени, заголовки авторизації, файли cookie та паролі. `openclaw migrate apply ` показує попередній перегляд плану й запитує підтвердження перед зміною стану, якщо не вказано `--yes`. У неінтерактивному режимі для застосування потрібен `--yes`. Перед застосуванням міграції команда застосування створює та перевіряє резервну копію OpenClaw. Якщо локального стану OpenClaw ще немає, етап резервного копіювання пропускається, а міграція продовжується. Щоб пропустити резервне копіювання за наявності стану, передайте одночасно `--no-backup` і `--force`. Команда застосування відмовляється продовжувати роботу, якщо план містить конфлікти. Перегляньте план, а потім повторіть запуск із `--overwrite`, якщо заміна наявних цільових об’єктів є навмисною. Постачальники все одно можуть створювати резервні копії перезаписаних файлів на рівні елементів у каталозі звіту про міграцію. Під час інтерактивного застосування з’являється запит, чи імпортувати виявлені облікові дані автентифікації, причому типово вибрано «так». Використовуйте `--no-auth-credentials`, щоб пропустити їх, або `--include-secrets` разом із `--yes` для автоматичного імпорту облікових даних. ## Постачальник Claude Вбудований постачальник Claude типово виявляє стан Claude Code у `~/.claude`. Використовуйте `--from `, щоб імпортувати конкретний домашній каталог або кореневий каталог проєкту Claude Code. Покрокову інструкцію для користувачів дивіться в розділі [Міграція з Claude](/uk/install/migrating-claude). ### Що імпортує Claude - Файли проєкту `CLAUDE.md` і `.claude/CLAUDE.md` до робочого простору агента OpenClaw (`AGENTS.md`). - Вміст користувацького `~/.claude/CLAUDE.md` додається до `USER.md` у робочому просторі. - Визначення серверів MCP із проєктного `.mcp.json`, Claude Code `~/.claude.json` (включно з окремими записами для кожного проєкту) і Claude Desktop `claude_desktop_config.json`. - Каталоги Skills Claude, що містять `SKILL.md` (користувацький `~/.claude/skills` і проєктний `.claude/skills`). - Файли команд Claude у форматі Markdown (користувацькі `~/.claude/commands` і проєктні `.claude/commands`), перетворені на Skills OpenClaw, доступні лише для ручного виклику. ### Архів і стан для ручної перевірки Хуки Claude, дозволи, типові значення середовища, проєктний `CLAUDE.local.md`, `.claude/rules`, користувацькі та проєктні каталоги `agents/`, а також історія проєктів (`projects`, `cache`, `plans` у `~/.claude`) зберігаються у звіті про міграцію або позначаються як елементи для ручної перевірки. OpenClaw не виконує хуки, не копіює широкі списки дозволів і не імпортує автоматично стан облікових даних OAuth/Desktop. ## Постачальник Codex Вбудований постачальник Codex типово виявляє стан Codex CLI у `~/.codex` або в `CODEX_HOME`, якщо цю змінну середовища встановлено. Використовуйте `--from `, щоб інвентаризувати конкретний домашній каталог Codex. Використовуйте цього постачальника під час переходу на середовище виконання Codex в OpenClaw, якщо хочете свідомо перенести корисні особисті ресурси Codex CLI. Локальні запуски сервера застосунків Codex використовують окремий для кожного агента `CODEX_HOME`, тому типово не читають ваш особистий `~/.codex`. Звичайний процес усе одно успадковує `HOME`, тому Codex бачить спільні Skills у `$HOME/.agents/*` і записи каталогу плагінів, а підпроцеси можуть знаходити конфігурацію та токени в домашньому каталозі користувача. Запуск `openclaw migrate codex` в інтерактивному терміналі показує попередній перегляд повного плану, а потім відкриває засоби вибору з прапорцями перед остаточним підтвердженням застосування. Спочатку пропонується вибрати елементи копіювання Skills. Використовуйте `Toggle all on` або `Toggle all off` для масового вибору. Натисніть пробіл, щоб перемикати рядки, або Enter, щоб активувати виділений рядок і продовжити. Заплановані Skills спочатку позначені, конфліктні Skills — не позначені, а `Skip for now` пропускає копіювання Skills для цього запуску, але продовжує перехід до вибору плагінів. Якщо встановлені з вихідного коду рекомендовані плагіни Codex можна перенести й не вказано `--plugin`, міграція далі пропонує активувати вбудовані плагіни Codex за назвою плагіна. Елементи плагінів спочатку позначені, якщо тільки цільова конфігурація плагінів Codex в OpenClaw уже не містить цей плагін. Наявні цільові плагіни спочатку не позначені й показують підказку про конфлікт, наприклад `conflict: plugin exists`; виберіть `Toggle all off`, щоб не переносити жодних вбудованих плагінів Codex під час цього запуску, або `Skip for now`, щоб зупинитися перед застосуванням. Для сценарних або точних запусків явно виберіть один чи кілька Skills або плагінів: ```bash openclaw migrate codex --dry-run --skill gog-vault77-google-workspace openclaw migrate apply codex --yes --skill gog-vault77-google-workspace openclaw migrate codex --dry-run --plugin google-calendar openclaw migrate apply codex --yes --plugin google-calendar ``` ### Що імпортує Codex - Каталоги Skills Codex CLI у `$CODEX_HOME/skills`, за винятком системного кешу Codex `.system`. - Особисті AgentSkills у `$HOME/.agents/skills`, скопійовані до поточного робочого простору агента OpenClaw для окремого володіння кожним агентом. - Встановлені з вихідного коду плагіни Codex `openai-curated`, виявлені через `plugin/list` сервера застосунків Codex. Під час планування виконується читання `plugin/read` для кожного ввімкненого встановленого плагіна. Міграція плагінів із підтримкою застосунків має додаткові обмеження: - Для плагінів із підтримкою застосунків обліковий запис вихідного сервера застосунків Codex має бути обліковим записом із підпискою ChatGPT. Відповіді для облікових записів, що не належать до ChatGPT, або за відсутності облікового запису пропускаються з причиною `codex_subscription_required`. - Типово міграція не викликає `app/list` джерела, тому плагіни з підтримкою застосунків, які проходять перевірку облікового запису, плануються без перевірки доступності вихідного застосунку, а помилки транспорту під час пошуку облікового запису призводять до пропуску з причиною `codex_account_unavailable`. - Передайте `--verify-plugin-apps`, щоб примусово отримати свіжий знімок `app/list` джерела та вимагати, щоб кожен власний застосунок був наявний, увімкнений і доступний до планування вбудованої активації. У цьому режимі після помилок транспорту під час пошуку облікового запису виконується перевірка інвентаризації вихідних застосунків. Знімок зберігається в пам’яті лише для поточного процесу; він ніколи не записується у вихідні дані міграції або цільову конфігурацію. Вимкнені плагіни, недоступні для читання відомості про плагіни, вихідні облікові записи з обмеженням за підпискою, а також (якщо встановлено `--verify-plugin-apps`) відсутні, вимкнені або недоступні застосунки стають пропущеними елементами для ручної перевірки з типізованими причинами замість записів цільової конфігурації. Для кожного вибраного придатного плагіна команда застосування викликає `plugin/install` сервера застосунків, навіть якщо цільовий сервер застосунків уже повідомляє, що цей плагін установлено й увімкнено. Перенесені плагіни Codex можна використовувати лише в сеансах, які вибирають вбудоване середовище виконання Codex; вони недоступні для запусків постачальника OpenClaw, прив’язок розмов ACP або інших середовищ виконання. ### Стан Codex для ручної перевірки Codex `config.toml`, вбудовані `hooks/hooks.json`, нерекомендовані каталоги, кешовані пакети плагінів, які не є встановленими з вихідного коду рекомендованими плагінами, та встановлені з вихідного коду плагіни, які не проходять вихідну перевірку підписки, не активуються автоматично. Якщо встановлено `--verify-plugin-apps`, плагіни, які не проходять перевірку інвентаризації вихідних застосунків, також пропускаються. Усе це копіюється або зазначається у звіті про міграцію для ручної перевірки. Для перенесених рекомендованих плагінів, установлених із вихідного коду, команда застосування записує: - `plugins.entries.codex.enabled: true` - `plugins.entries.codex.config.codexPlugins.enabled: true` - `plugins.entries.codex.config.codexPlugins.allow_destructive_actions: true` - один явний запис плагіна з `marketplaceName: "openai-curated"` і `pluginName` для кожного вибраного плагіна Міграція ніколи не записує `plugins["*"]` і ніколи не зберігає локальні шляхи кешу каталогу плагінів. Пропущені плагіни не записуються до цільової конфігурації. Помилки підписок на стороні джерела зазначаються для елементів, що потребують ручного втручання, із типізованими причинами: `codex_subscription_required`, `codex_account_unavailable`, `plugin_disabled` або `plugin_read_unavailable`. З параметром `--verify-plugin-apps` помилки інвентаризації застосунків джерела також можуть мати значення `app_inaccessible`, `app_disabled`, `app_missing` або `app_inventory_unavailable`. Інсталяції на цільовій стороні, що потребують автентифікації, зазначаються для відповідного елемента плагіна зі `status: "skipped"`, `reason: "auth_required"` і знеособленими ідентифікаторами застосунків; відповідні явні записи конфігурації записуються як вимкнені, доки ви повторно не авторизуєте та не ввімкнете їх. Інші помилки інсталяції повертаються як результати `error`, прив’язані до окремих елементів. Якщо під час планування інвентар плагінів сервера застосунків Codex недоступний, міграція замість збою всієї процедури використовує резервні рекомендаційні елементи з кешованого пакета. ## Провайдер Hermes Вбудований провайдер Hermes за замовчуванням виявляє стан у `~/.hermes`. Якщо Hermes розташований в іншому місці, використовуйте `--from `. ### Що імпортує 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//`. - Значення конфігурації окремих Skills із `skills.config`. - Облікові дані OpenAI OAuth з OpenCode `auth.json`, якщо інтерактивну міграцію облікових даних підтверджено або задано `--include-secrets`. Записи OAuth у Hermes `auth.json` є застарілим станом, для якого зазначається необхідність ручної повторної автентифікації OpenAI або виправлення за допомогою doctor. - Підтримувані ключі API й токени з Hermes `.env` і OpenCode `auth.json`, якщо інтерактивну міграцію облікових даних підтверджено або задано `--include-secrets`. ### Підтримувані ключі `.env` `AI_GATEWAY_API_KEY`, `ALIBABA_API_KEY`, `ANTHROPIC_API_KEY`, `ARCEEAI_API_KEY`, `CEREBRAS_API_KEY`, `CHUTES_API_KEY`, `CLOUDFLARE_AI_GATEWAY_API_KEY`, `COPILOT_GITHUB_TOKEN`, `DASHSCOPE_API_KEY`, `DEEPINFRA_API_KEY`, `DEEPSEEK_API_KEY`, `FIREWORKS_API_KEY`, `GEMINI_API_KEY`, `GH_TOKEN`, `GITHUB_TOKEN`, `GLM_API_KEY`, `GOOGLE_API_KEY`, `GROQ_API_KEY`, `HF_TOKEN`, `HUGGINGFACE_HUB_TOKEN`, `KILOCODE_API_KEY`, `KIMICODE_API_KEY`, `KIMI_API_KEY`, `MINIMAX_API_KEY`, `MINIMAX_CODING_API_KEY`, `MISTRAL_API_KEY`, `MODELSTUDIO_API_KEY`, `MOONSHOT_API_KEY`, `NVIDIA_API_KEY`, `OPENAI_API_KEY`, `OPENCODE_API_KEY`, `OPENCODE_GO_API_KEY`, `OPENCODE_ZEN_API_KEY`, `OPENROUTER_API_KEY`, `QIANFAN_API_KEY`, `QWEN_API_KEY`, `TOGETHER_API_KEY`, `VENICE_API_KEY`, `XAI_API_KEY`, `XIAOMI_API_KEY`, `ZAI_API_KEY`, `Z_AI_API_KEY`. ### Стан лише для архівування Стан Hermes, який OpenClaw не може безпечно інтерпретувати, копіюється до звіту про міграцію для ручної перевірки, але не завантажується до активної конфігурації чи облікових даних OpenClaw. Це зберігає непрозорий або небезпечний стан, не створюючи хибного враження, що OpenClaw може автоматично виконувати його або довіряти йому: `plugins/`, `sessions/`, `logs/`, `cron/`, `mcp-tokens/`, `state.db`. ### Після застосування ```bash openclaw doctor ``` ## Контракт плагіна Джерела міграції є плагінами. Плагін оголошує ідентифікатори своїх провайдерів у `openclaw.plugin.json`: ```json { "contracts": { "migrationProviders": ["hermes"] } } ``` Під час виконання плагін викликає `api.registerMigrationProvider(...)`. Провайдер реалізує `detect`, `plan` і `apply`. Ядро відповідає за оркестрацію CLI, політику резервного копіювання, запити до користувача, виведення JSON і попередню перевірку конфліктів. Ядро передає перевірений план до `apply(ctx, plan)`, а для сумісності провайдери можуть перебудувати план лише за відсутності цього аргументу. Плагіни провайдерів можуть використовувати `openclaw/plugin-sdk/migration` для створення елементів і підрахунку підсумків, а також `openclaw/plugin-sdk/migration-runtime` для копіювання файлів з урахуванням конфліктів, копіювання до звітів лише для архівування, кешованих обгорток середовища виконання конфігурації та звітів про міграцію. ## Інтеграція з початковим налаштуванням Початкове налаштування може запропонувати міграцію, коли провайдер виявляє відоме джерело. І `openclaw onboard --flow import`, і `openclaw setup --wizard --import-from hermes` використовують того самого провайдера міграції плагіна та показують попередній перегляд перед застосуванням. Для імпорту під час початкового налаштування потрібне нове налаштування OpenClaw. Якщо у вас уже є локальний стан, спочатку скиньте конфігурацію, облікові дані, сеанси та робочий простір. Імпорт із резервним копіюванням і перезаписом або зі злиттям для наявних налаштувань доступний лише за ввімкнення відповідної функції. ## Пов’язані матеріали - [Міграція з Hermes](/uk/install/migrating-hermes): посібник для користувачів. - [Міграція з Claude](/uk/install/migrating-claude): посібник для користувачів. - [Міграція](/uk/install/migrating): перенесення OpenClaw на новий комп’ютер. - [Doctor](/uk/gateway/doctor): перевірка стану після застосування міграції. - [Плагіни](/uk/tools/plugin): інсталяція та реєстрація плагінів.