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

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

Майстер пропонує Claude, коли виявляє локальний стан Claude.
openclaw onboard --flow import
Або вкажіть конкретне джерело:
openclaw onboard --import-from claude --import-source ~/.claude

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

  • Вміст проєктних CLAUDE.md і .claude/CLAUDE.md копіюється або додається до AGENTS.md у workspace агента OpenClaw.
  • Вміст користувацького ~/.claude/CLAUDE.md додається до USER.md у workspace.
Визначення серверів MCP імпортуються з проєктного .mcp.json, Claude Code ~/.claude.json і Claude Desktop claude_desktop_config.json, якщо вони присутні.
  • Claude Skills із файлом SKILL.md копіюються до каталогу Skills у workspace OpenClaw.
  • Markdown-файли команд Claude у .claude/commands/ або ~/.claude/commands/ перетворюються на Skills OpenClaw з disable-model-invocation: true.

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

Провайдер копіює це до звіту міграції для ручної перевірки, але не завантажує до активного config OpenClaw:
  • hooks Claude
  • permissions Claude і широкі allowlist інструментів
  • defaults середовища Claude
  • CLAUDE.local.md
  • .claude/rules/
  • subagents Claude у .claude/agents/ або ~/.claude/agents/
  • кеші, плани та каталоги історії проєктів Claude Code
  • розширення Claude Desktop і credentials, що зберігаються в ОС
OpenClaw автоматично відмовляється виконувати hooks, довіряти permission allowlist або декодувати непрозорий стан OAuth і credentials Desktop. Перенесіть потрібне вручну після перевірки архіву.

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

Без --from OpenClaw перевіряє типовий домашній каталог Claude Code у ~/.claude, вибірковий файл стану Claude Code ~/.claude.json і config 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 перевіряє проблеми config або стану після імпорту.
4

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

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

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

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

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

openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
З --json і без --yes apply виводить план і не змінює стан. Це найбезпечніший режим для CI і спільних сценаріїв.

​
Усунення проблем

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

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