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

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

Майстер пропонує Claude, коли виявляє локальний стан Claude.
Або вкажіть конкретне джерело:

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

  • Вміст файлів проєкту CLAUDE.md і .claude/CLAUDE.md копіюється або додається до AGENTS.md у робочому просторі агента OpenClaw.
  • Вміст користувацького файлу ~/.claude/CLAUDE.md додається до USER.md у робочому просторі.
Визначення серверів MCP імпортуються за наявності з проєктного .mcp.json, файлу Claude Code ~/.claude.json і файлу Claude Desktop claude_desktop_config.json.
  • Skills Claude, що мають файл SKILL.md, копіюються до каталогу Skills у робочому просторі OpenClaw.
  • Markdown-файли команд Claude у .claude/commands/ або ~/.claude/commands/ перетворюються на Skills OpenClaw із 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

Перегляньте план

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

Застосуйте зі створенням резервної копії

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

Запустіть діагностику

Діагностика перевіряє наявність проблем із конфігурацією або станом після імпорту.
4

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

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

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

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

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

--yes є обов’язковим для migrate apply поза інтерактивним терміналом; без нього OpenClaw повертає помилку замість застосування, тому сценарії та CI мають явно передавати --yes. Спочатку виконайте попередній перегляд за допомогою --dry-run --json, а коли план матиме належний вигляд, застосуйте його за допомогою --json --yes.

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

Передайте --from /actual/path (CLI) або --import-source /actual/path (початкове налаштування).
Імпорт під час початкового налаштування потребує нового налаштування. Або скиньте стан і повторіть початкове налаштування, або скористайтеся безпосередньо openclaw migrate apply claude, що підтримує --overwrite і явне керування резервними копіями.
Claude Desktop зчитує claude_desktop_config.json зі шляху, що залежить від платформи. Якщо OpenClaw не виявив його автоматично, укажіть у --from каталог цього файлу.
Так передбачено. Команди Claude запускає користувач, тому OpenClaw імпортує їх як Skills із disable-model-invocation: true. Відредагуйте frontmatter кожного Skill, якщо хочете, щоб агент викликав їх автоматично.

​
Пов’язані матеріали