English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaishiالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiruفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Maintenance

Миграция с Claude

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

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

Мастер онбординга

Мастер предлагает Claude, когда обнаруживает локальное состояние Claude.

bash
openclaw onboard --flow import

Или укажите конкретный источник:

bash
openclaw onboard --import-from claude --import-source ~/.claude

CLI

Используйте openclaw migrate для сценарных или повторяемых запусков. Полную справку см. в openclaw migrate.

bash
openclaw migrate claude --dry-runopenclaw migrate apply claude --yes

Добавьте --from <path>, чтобы импортировать конкретный домашний каталог Claude Code или корень проекта.

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

Инструкции и память
  • Содержимое проектных CLAUDE.md и .claude/CLAUDE.md копируется или добавляется в AGENTS.md рабочей области агента OpenClaw.
  • Содержимое пользовательского ~/.claude/CLAUDE.md добавляется в USER.md рабочей области.
Серверы MCP

Определения серверов MCP импортируются из проектного .mcp.json, Claude Code ~/.claude.json и Claude Desktop claude_desktop_config.json, если они существуют.

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.

Рекомендуемый процесс

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

    bash
    openclaw migrate claude --dry-run

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

  • Примените с резервной копией

    bash
    openclaw migrate apply claude --yes

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

  • Запустите doctor

    bash
    openclaw doctor

    Doctor проверяет наличие проблем с конфигурацией или состоянием после импорта.

  • Перезапустите и проверьте

    bash
    openclaw gateway restartopenclaw status

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

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

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

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

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

    bash
    openclaw migrate claude --dry-run --jsonopenclaw migrate apply claude --json --yes

    С --json и без --yes применение печатает план и не изменяет состояние. Это самый безопасный режим для CI и общих скриптов.

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

    Состояние Claude находится вне ~/.claude

    Передайте --from /actual/path (CLI) или --import-source /actual/path (онбординг).

    Онбординг отказывается импортировать в существующую настройку

    Импорт при онбординге требует новой настройки. Либо сбросьте состояние и пройдите онбординг заново, либо используйте openclaw migrate apply claude напрямую; он поддерживает --overwrite и явное управление резервными копиями.

    Серверы MCP из Claude Desktop не импортировались

    Claude Desktop читает claude_desktop_config.json из пути, зависящего от платформы. Укажите --from на каталог этого файла, если OpenClaw не обнаружил его автоматически.

    Команды Claude стали Skills с отключенным вызовом модели

    Так задумано. Команды Claude запускаются пользователем, поэтому OpenClaw импортирует их как Skills с disable-model-invocation: true. Отредактируйте frontmatter каждого Skill, если хотите, чтобы агент вызывал их автоматически.

    См. также

    Was this useful?
    On this page

    On this page