Перейти к основному содержанию
OpenClaw импортирует локальное состояние Claude через встроенный поставщик миграции Claude. Поставщик предварительно показывает каждый элемент перед изменением состояния, скрывает секреты в планах и отчетах и создает проверенную резервную копию перед применением.
Импорт при онбординге требует новой настройки OpenClaw. Если у вас уже есть локальное состояние OpenClaw, сначала сбросьте конфигурацию, учетные данные, сеансы и рабочую область либо используйте openclaw migrate напрямую с --overwrite после просмотра плана.

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

Мастер предлагает Claude, когда обнаруживает локальное состояние Claude.
openclaw onboard --flow import
Или укажите конкретный источник:
openclaw onboard --import-from claude --import-source ~/.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

Предварительно просмотрите план

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 и общих скриптов.

​
Устранение неполадок

Передайте --from /actual/path (CLI) или --import-source /actual/path (онбординг).
Импорт при онбординге требует новой настройки. Либо сбросьте состояние и пройдите онбординг заново, либо используйте openclaw migrate apply claude напрямую; он поддерживает --overwrite и явное управление резервными копиями.
Claude Desktop читает claude_desktop_config.json из пути, зависящего от платформы. Укажите --from на каталог этого файла, если OpenClaw не обнаружил его автоматически.
Так задумано. Команды Claude запускаются пользователем, поэтому OpenClaw импортирует их как Skills с disable-model-invocation: true. Отредактируйте frontmatter каждого Skill, если хотите, чтобы агент вызывал их автоматически.

​
См. также