> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Миграция с Claude

OpenClaw импортирует локальное состояние Claude с помощью встроенного провайдера миграции Claude. Перед изменением состояния провайдер показывает предварительный список всех элементов, скрывает секреты в планах и отчётах и создаёт проверенную резервную копию перед применением.

> [!NOTE]
>
> Для импорта при первоначальной настройке требуется новая конфигурация OpenClaw. Если у вас уже есть локальное состояние OpenClaw, сначала сбросьте конфигурацию, учётные данные, сеансы и рабочее пространство либо используйте `openclaw migrate` напрямую с `--overwrite` после проверки плана.

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

> [tab] Мастер первоначальной настройки
>
> Мастер предлагает импорт из Claude, когда обнаруживает локальное состояние Claude.
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --flow import
> ```
>
> Либо укажите конкретный источник:
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw onboard --import-from claude --import-source ~/.claude
> ```

> [tab] CLI
>
> Используйте `openclaw migrate` для запуска по сценарию или повторяемых запусков. Полное справочное руководство см. в разделе [`openclaw migrate`](https://docs2.openclaw.ai/ru/cli/migrate).
>
> ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
> openclaw migrate claude --dry-run
> openclaw migrate apply claude --yes
> ```
>
> Добавьте `--from <path>`, чтобы импортировать конкретный домашний каталог Claude Code или корень проекта.

## Что импортируется

> [accordion] Инструкции и память
>
> * Содержимое файлов проекта `CLAUDE.md` и `.claude/CLAUDE.md` копируется или добавляется в `AGENTS.md` рабочего пространства агента OpenClaw.
> * Содержимое пользовательского файла `~/.claude/CLAUDE.md` добавляется в `USER.md` рабочего пространства.

> [accordion] Серверы MCP
>
> Определения серверов MCP импортируются при наличии из файла проекта `.mcp.json`, файла Claude Code `~/.claude.json` и файла Claude Desktop `claude_desktop_config.json`.

> [accordion] Skills и команды
>
> * 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. Предварительно просмотрите план**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw migrate claude --dry-run
```

В плане перечислено всё, что будет изменено, включая конфликты, пропущенные элементы и конфиденциальные значения, скрытые во вложенных полях MCP `env` или `headers`.

**2. Примените с резервным копированием**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw migrate apply claude --yes
```

Перед применением OpenClaw создаёт и проверяет резервную копию.

**3. Запустите диагностику**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw doctor
```

[Диагностика](https://docs2.openclaw.ai/ru/gateway/doctor.md) проверяет наличие проблем с конфигурацией или состоянием после импорта.

**4. Перезапустите и проверьте**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway restart
openclaw status
```

Убедитесь, что Gateway работает нормально, а импортированные инструкции, серверы MCP и Skills загружены.

## Обработка конфликтов

Применение не продолжается, если в плане указаны конфликты: файл или значение конфигурации уже существует в целевом расположении.

> [!WARNING]
>
> Повторно запускайте с `--overwrite` только в том случае, если вы намеренно хотите заменить существующие целевые данные. Провайдеры всё равно могут создавать в каталоге отчёта о миграции резервные копии отдельных перезаписываемых файлов.

При новой установке OpenClaw конфликты встречаются редко. Обычно они возникают при повторном импорте в конфигурацию, которая уже содержит пользовательские изменения.

## Вывод JSON для автоматизации

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw migrate claude --dry-run --json
openclaw migrate apply claude --json --yes
```

Для `migrate apply` вне интерактивного терминала требуется `--yes`; без него OpenClaw возвращает ошибку вместо применения, поэтому сценарии и CI должны явно передавать `--yes`. Сначала выполните предварительный просмотр с `--dry-run --json`, а когда план будет выглядеть правильно, примените его с `--json --yes`.

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

> [accordion] Состояние Claude находится вне \~/.claude
>
> Передайте `--from /actual/path` для CLI или `--import-source /actual/path` для первоначальной настройки.

> [accordion] Первоначальная настройка отказывается выполнять импорт в существующую конфигурацию
>
> Для импорта при первоначальной настройке требуется новая конфигурация. Сбросьте состояние и повторите первоначальную настройку либо используйте `openclaw migrate apply claude` напрямую, где поддерживаются `--overwrite` и явное управление резервным копированием.

> [accordion] Серверы MCP из Claude Desktop не импортировались
>
> Claude Desktop считывает `claude_desktop_config.json` из пути, зависящего от платформы. Если OpenClaw не обнаружил его автоматически, укажите каталог этого файла в `--from`.

> [accordion] Команды Claude преобразовались в Skills с отключённым вызовом моделью
>
> Это предусмотрено. Команды Claude запускаются пользователем, поэтому OpenClaw импортирует их как Skills с `disable-model-invocation: true`. Измените метаданные frontmatter каждого Skill, если хотите, чтобы агент вызывал их автоматически.

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

* [`openclaw migrate`](https://docs2.openclaw.ai/ru/cli/migrate): полное справочное руководство по CLI, контракту плагина и структурам JSON.
* [Руководство по миграции](https://docs2.openclaw.ai/ru/install/migrating.md): все пути миграции.
* [Миграция с Hermes](https://docs2.openclaw.ai/ru/install/migrating-hermes.md): другой способ импорта между системами.
* [Первоначальная настройка](https://docs2.openclaw.ai/ru/cli/onboard.md): работа мастера и флаги неинтерактивного режима.
* [Диагностика](https://docs2.openclaw.ai/ru/gateway/doctor.md): проверка состояния после миграции.
* [Рабочее пространство агента](https://docs2.openclaw.ai/ru/concepts/agent-workspace.md): где находятся `AGENTS.md`, `USER.md` и Skills.