Перейти до основного вмісту

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.

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, якщо вони наявні.
  • Claude Skills із файлом SKILL.md копіюються до каталогу Skills робочого простору OpenClaw.
  • Markdown-файли команд Claude у .claude/commands/ або ~/.claude/commands/ перетворюються на OpenClaw Skills із 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, якщо хочете, щоб агент викликав їх автоматично.

​
Пов’язане