Міграція з Claude

OpenClaw імпортує локальний стан Claude через вбудований провайдер міграції Claude. Провайдер попередньо показує кожен елемент перед зміною стану, редагує секрети в планах і звітах та створює перевірену резервну копію перед застосуванням.

Імпорт під час онбордингу потребує свіжого налаштування OpenClaw. Якщо у вас уже є локальний стан OpenClaw, спершу скиньте конфігурацію, облікові дані, сеанси та робочий простір або скористайтеся openclaw migrate напряму з --overwrite після перегляду плану.

​

Два способи імпорту

Майстер онбордингу

Майстер пропонує Claude, коли виявляє локальний стан Claude.

openclaw onboard --flow import

Або вкажіть конкретне джерело:

openclaw onboard --import-from claude --import-source ~/.claude

CLI

Використовуйте openclaw migrate для скриптованих або повторюваних запусків. Повну довідку див. у openclaw migrate.

openclaw migrate claude --dry-run
openclaw migrate apply claude --yes

Додайте --from <path>, щоб імпортувати конкретний домашній каталог Claude Code або корінь проєкту.

​

Що імпортується

Інструкції та пам’ять

• Вміст проєктних CLAUDE.md і .claude/CLAUDE.md копіюється або додається до AGENTS.md у робочому просторі агента OpenClaw.
• Вміст користувацького ~/.claude/CLAUDE.md додається до USER.md у робочому просторі.

MCP-сервери

Визначення MCP-серверів імпортуються з проєктного .mcp.json, Claude Code ~/.claude.json і Claude Desktop claude_desktop_config.json, якщо вони наявні.

Skills і команди

• Claude Skills із файлом SKILL.md копіюються до каталогу Skills робочого простору OpenClaw.
• Markdown-файли команд Claude у .claude/commands/ або ~/.claude/commands/ перетворюються на OpenClaw Skills із disable-model-invocation: true.

​

Що залишається лише в архіві

Провайдер копіює це до звіту міграції для ручного перегляду, але не завантажує в активну конфігурацію OpenClaw:

• Хуки Claude
• Дозволи Claude і широкі списки дозволених інструментів
• Стандартні значення середовища Claude
• CLAUDE.local.md
• .claude/rules/
• Субагенти Claude у .claude/agents/ або ~/.claude/agents/
• Каталоги кешів, планів та історії проєктів Claude Code
• Розширення Claude Desktop і облікові дані, збережені ОС

OpenClaw відмовляється автоматично виконувати хуки, довіряти спискам дозволів або декодувати непрозорий стан облікових даних OAuth і Desktop. Перенесіть потрібне вручну після перегляду архіву.

​

Вибір джерела

Без --from OpenClaw перевіряє типовий домашній каталог Claude Code у ~/.claude, вибраний файл стану Claude Code ~/.claude.json і конфігурацію MCP Claude Desktop на macOS.

Коли --from вказує на корінь проєкту, OpenClaw імпортує лише файли Claude цього проєкту, як-от CLAUDE.md, .claude/settings.json, .claude/commands/, .claude/skills/ і .mcp.json. Під час імпорту з кореня проєкту він не читає ваш глобальний домашній каталог Claude.

​

Рекомендований процес

1. Попередньо перегляньте план

   openclaw migrate claude --dry-run
   

   У плані перелічено все, що буде змінено, зокрема конфлікти, пропущені елементи та чутливі значення, відредаговані з вкладених полів MCP env або headers.

2. Застосуйте з резервною копією

   openclaw migrate apply claude --yes
   

   OpenClaw створює та перевіряє резервну копію перед застосуванням.

3. Запустіть doctor

   openclaw doctor
   

   Doctor перевіряє проблеми конфігурації або стану після імпорту.

4. Перезапустіть і перевірте

   openclaw gateway restart
   openclaw status
   

   Переконайтеся, що Gateway справний, а імпортовані інструкції, MCP-сервери та Skills завантажено.

​

Обробка конфліктів

Застосування відмовляється продовжувати, коли план повідомляє про конфлікти (файл або значення конфігурації вже існує в цільовому місці).

Повторно запускайте з --overwrite лише тоді, коли заміна наявної цілі є навмисною. Провайдери все одно можуть записувати резервні копії на рівні елементів для перезаписаних файлів у каталозі звіту міграції.

Для свіжого встановлення OpenClaw конфлікти незвичні. Вони зазвичай з’являються, коли ви повторно запускаєте імпорт у налаштуванні, яке вже має користувацькі зміни.

​

Вивід JSON для автоматизації

openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes

З --json і без --yes застосування друкує план і не змінює стан. Це найбезпечніший режим для CI і спільних скриптів.

​

Усунення несправностей

Стан Claude розміщений поза ~/.claude

Передайте --from /actual/path (CLI) або --import-source /actual/path (онбординг).

Онбординг відмовляється імпортувати в наявне налаштування

Імпорт під час онбордингу потребує свіжого налаштування. Або скиньте стан і повторіть онбординг, або скористайтеся openclaw migrate apply claude напряму, що підтримує --overwrite і явне керування резервними копіями.

MCP-сервери з Claude Desktop не імпортувалися

Claude Desktop читає claude_desktop_config.json зі шляху, специфічного для платформи. Вкажіть --from на каталог цього файла, якщо OpenClaw не виявив його автоматично.

Команди Claude стали Skills із вимкненим викликом моделі

Це очікувана поведінка. Команди Claude запускає користувач, тому OpenClaw імпортує їх як Skills із disable-model-invocation: true. Відредагуйте frontmatter кожного Skill, якщо хочете, щоб агент викликав їх автоматично.

​

Пов’язане

• openclaw migrate: повна довідка CLI, контракт Plugin і форми JSON.
• Посібник із міграції: усі шляхи міграції.
• Міграція з Hermes: інший шлях міжсистемного імпорту.
• Онбординг: процес майстра й неінтерактивні прапорці.
• Doctor: перевірка справності після міграції.
• Робочий простір агента: де розміщено AGENTS.md, USER.md і Skills.