16 KiB
| read_when | summary | title | x-i18n | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Довідник CLI для `openclaw migrate` (імпорт стану з іншої агентської системи) | Міграція |
|
openclaw migrate
Імпортуйте стан з іншої агентної системи через постачальника міграції, що належить Plugin. Вбудовані постачальники охоплюють стан Codex CLI, Claude і Hermes; сторонні plugins можуть реєструвати додаткових постачальників.
Покрокові інструкції для користувачів див. у [Міграція з Claude](/uk/install/migrating-claude) і [Міграція з Hermes](/uk/install/migrating-hermes). [Центр міграції](/uk/install/migrating) перелічує всі шляхи.Команди
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 migrate спочатку показує попередній перегляд.
`openclaw migrate apply <provider>` попередньо показує план і запитує підтвердження перед зміною стану, якщо не задано `--yes`. У неінтерактивному режимі apply потребує `--yes`.
Постачальник 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 Desktopclaude_desktop_config.json. - Каталоги skills Claude, які містять
SKILL.md. - Markdown-файли команд Claude, перетворені на skills OpenClaw лише з ручним викликом.
Стан архівування та ручного перегляду
Hooks Claude, дозволи, типові значення середовища, локальна пам’ять, правила з областю дії за шляхом, субагенти, кеші, плани й історія проєкту зберігаються у звіті міграції або повідомляються як елементи для ручного перегляду. OpenClaw не виконує hooks, не копіює широкі allowlists і не імпортує стан облікових даних OAuth/Desktop автоматично.
Постачальник Codex
Вбудований постачальник Codex типово виявляє стан Codex CLI у ~/.codex або
в CODEX_HOME, коли цю змінну середовища задано. Використовуйте --from <path>, щоб
інвентаризувати конкретний домашній каталог Codex.
Використовуйте цього постачальника під час переходу на harness OpenClaw Codex, коли потрібно
свідомо просунути корисні особисті ресурси Codex CLI. Локальні запуски app-server Codex
використовують каталоги CODEX_HOME і HOME для кожного агента, тому типово вони не читають
ваш особистий стан Codex CLI.
Запуск openclaw migrate codex в інтерактивному терміналі попередньо показує повний
план, а потім відкриває селектор із прапорцями для елементів копіювання skill перед фінальним
підтвердженням apply. Усі skills спочатку вибрані; зніміть прапорець із будь-якого skill, який не потрібно
копіювати в цього агента. Для скриптових або точних запусків передайте --skill <name> по одному разу
для кожного skill, наприклад:
openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
Що імпортує Codex
- Каталоги skills Codex CLI у
$CODEX_HOME/skills, окрім кешу.systemCodex. - Особисті AgentSkills у
$HOME/.agents/skills, скопійовані в поточну робочу область агента OpenClaw, коли потрібне володіння на рівні агента.
Стан Codex для ручного перегляду
Нативні plugins Codex, config.toml і нативні hooks/hooks.json не
активуються автоматично. Plugins можуть відкривати MCP-сервери, apps, hooks або іншу
виконувану поведінку, тому постачальник повідомляє про них для перегляду замість завантаження
їх в OpenClaw. Файли config і hook копіюються у звіт міграції
для ручного перегляду.
Постачальник Hermes
Вбудований постачальник Hermes типово виявляє стан у ~/.hermes. Використовуйте --from <path>, коли Hermes розташований в іншому місці.
Що імпортує Hermes
- Типову конфігурацію моделі з
config.yaml. - Налаштованих постачальників моделей і власні OpenAI-сумісні endpoints із
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.jsonstate.db
Після застосування
openclaw doctor
Контракт Plugin
Джерела міграції є plugins. Plugin оголошує свої ідентифікатори постачальників в openclaw.plugin.json:
{
"contracts": {
"migrationProviders": ["hermes"]
}
}
Під час виконання Plugin викликає api.registerMigrationProvider(...). Постачальник реалізує detect, plan і apply. Core відповідає за оркестрацію CLI, політику резервного копіювання, запити, JSON-вивід і попередню перевірку конфліктів. Core передає переглянутий план у apply(ctx, plan), а постачальники можуть перебудовувати план лише коли цей аргумент відсутній для сумісності.
Provider plugins можуть використовувати openclaw/plugin-sdk/migration для створення елементів і підрахунків у підсумку, а також openclaw/plugin-sdk/migration-runtime для копіювання файлів з урахуванням конфліктів, архівних копій у звітах, кешованих wrappers config-runtime і звітів міграції.
Інтеграція з onboarding
Onboarding може пропонувати міграцію, коли постачальник виявляє відоме джерело. І openclaw onboard --flow import, і openclaw setup --wizard --import-from hermes використовують того самого постачальника міграції Plugin і все одно показують попередній перегляд перед застосуванням.
Пов’язане
- Міграція з Hermes: покрокова інструкція для користувачів.
- Міграція з Claude: покрокова інструкція для користувачів.
- Міграція: перенесіть OpenClaw на новий комп’ютер.
- Doctor: перевірка справності після застосування міграції.
- Plugins: встановлення та реєстрація plugins.