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 для автоматизации

Для migrate apply вне интерактивного терминала требуется --yes; без него 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, если хотите, чтобы агент вызывал их автоматически.

​
Связанные материалы