Миграция с OpenClaw

vibeos claw migrate импортирует вашу конфигурацию OpenClaw (или устаревших Clawdbot/Moldbot) в VibeOS. Это руководство описывает, что именно переносится, сопоставление ключей конфигурации и что нужно проверить после миграции.

подсказка

Если ваша конфигурация OpenClaw была мульти-провайдерной, vibeos setup --portal сворачивает её в единый OAuth — более 300 моделей плюс Tool Gateway в одном входе. См. Nous Portal.

Быстрый старт

# Предпросмотр, затем миграция (всегда показывает предпросмотр, затем запрашивает подтверждение)
vibeos claw migrate

# Только предпросмотр, без изменений
vibeos claw migrate --dry-run

# Полная миграция, включая API-ключи, без подтверждения
vibeos claw migrate --preset full --migrate-secrets --yes

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

По умолчанию читает из ~/.openclaw/. Устаревшие директории ~/.clawdbot/ или ~/.moltbot/ обнаруживаются автоматически. То же самое касается устаревших имён файлов конфигурации (clawdbot.json, moltbot.json).

Параметры

Параметр	Описание
--dry-run	Только предпросмотр — остановиться после отображения того, что будет перенесено.
--preset <имя>	full (все совместимые настройки) или user-data (исключает инфраструктурную конфигурацию). Ни один пресет не импортирует секреты по умолчанию — явно укажите --migrate-secrets.
--overwrite	Перезаписывать существующие файлы VibeOS при конфликтах (по умолчанию: отказ от применения, если в плане есть конфликты).
--migrate-secrets	Включает API-ключи. Требуется даже при --preset full — ни один пресет не импортирует секреты молча.
--no-backup	Пропустить создание zip-снимка ~/.vibeos/ перед миграцией (по умолчанию перед применением записывается один архив точки восстановления в ~/.vibeos/backups/pre-migration-*.zip; восстанавливается с помощью vibeos import).
--source <путь>	Пользовательская директория OpenClaw.
--workspace-target <путь>	Куда поместить AGENTS.md.
--skill-conflict <режим>	skip (по умолчанию), overwrite или rename.
--yes	Пропустить запрос подтверждения после предпросмотра.

Что переносится

Персона, память и инструкции

Что	Источник OpenClaw	Назначение VibeOS	Примечания
Персона	workspace/SOUL.md	~/.vibeos/SOUL.md	Прямое копирование
Инструкции рабочего пространства	workspace/AGENTS.md	AGENTS.md в --workspace-target	Требуется флаг --workspace-target
Долговременная память	workspace/MEMORY.md	~/.vibeos/memories/MEMORY.md	Разбирается на записи, объединяется с существующими, удаляются дубликаты. Используется разделитель §.
Профиль пользователя	workspace/USER.md	~/.vibeos/memories/USER.md	Та же логика слияния записей, что и для памяти.
Ежедневные файлы памяти	workspace/memory/*.md	~/.vibeos/memories/MEMORY.md	Все ежедневные файлы объединяются в основную память.

Файлы рабочего пространства также проверяются в workspace.default/ и workspace-main/ в качестве запасных путей (OpenClaw переименовал workspace/ в workspace-main/ в последних версиях и использует workspace-{agentId} для мульти-агентных конфигураций).

Навыки (4 источника)

Источник	Расположение OpenClaw	Назначение VibeOS
Навыки рабочего пространства	workspace/skills/	~/.vibeos/skills/openclaw-imports/
Управляемые/общие навыки	~/.openclaw/skills/	~/.vibeos/skills/openclaw-imports/
Личные межпроектные	~/.agents/skills/	~/.vibeos/skills/openclaw-imports/
Общие на уровне проекта	workspace/.agents/skills/	~/.vibeos/skills/openclaw-imports/

Конфликты навыков обрабатываются параметром --skill-conflict: skip оставляет существующий навык VibeOS, overwrite заменяет его, rename создаёт копию с суффиксом -imported.

Конфигурация модели и провайдера

Что	Путь конфига OpenClaw	Назначение VibeOS	Примечания
Модель по умолчанию	agents.defaults.model	config.yaml → model	Может быть строкой или объектом {primary, fallbacks}
Пользовательские провайдеры	models.providers.*	config.yaml → custom_providers	Сопоставляет baseUrl, apiType/api — обрабатывает как короткие ("openai", "anthropic"), так и дефисные ("openai-completions", "anthropic-messages", "google-generative-ai") значения
API-ключи провайдеров	models.providers.*.apiKey	~/.vibeos/.env	Требуется --migrate-secrets. См. Разрешение API-ключей ниже.

Поведение агента

Что	Путь конфига OpenClaw	Путь конфига VibeOS	Сопоставление
Макс. шагов	agents.defaults.timeoutSeconds	agent.max_turns	timeoutSeconds / 10, не более 200
Подробный режим	agents.defaults.verboseDefault	agent.verbose	"off" / "on" / "full"
Усилия рассуждения	agents.defaults.thinkingDefault	agent.reasoning_effort	"always"/"high"/"xhigh" → "high", "auto"/"medium"/"adaptive" → "medium", "off"/"low"/"none"/"minimal" → "low"
Сжатие	agents.defaults.compaction.mode	compression.enabled	"off" → false, всё остальное → true
Модель сжатия	agents.defaults.compaction.model	compression.summary_model	Прямое копирование строки
Задержка человека	agents.defaults.humanDelay.mode	human_delay.mode	"natural" / "custom" / "off"
Время задержки человека	agents.defaults.humanDelay.minMs / .maxMs	human_delay.min_ms / .max_ms	Прямое копирование
Часовой пояс	agents.defaults.userTimezone	timezone	Прямое копирование строки
Тайм-аут выполнения	tools.exec.timeoutSec	terminal.timeout	Прямое копирование (поле — timeoutSec, не timeout)
Docker-песочница	agents.defaults.sandbox.backend	terminal.backend	"docker" → "docker"
Docker-образ	agents.defaults.sandbox.docker.image	terminal.docker_image	Прямое копирование

Политики сброса сессии

Путь конфига OpenClaw	Путь конфига VibeOS	Примечания
session.reset.mode	session_reset.mode	"daily", "idle" или оба
session.reset.atHour	session_reset.at_hour	Час (0–23) для ежедневного сброса
session.reset.idleMinutes	session_reset.idle_minutes	Минуты бездействия

Примечание: OpenClaw также имеет session.resetTriggers (простой массив строк, например ["daily", "idle"]). Если структурированный session.reset отсутствует, миграция пытается вывести настройки из resetTriggers.

MCP-серверы

Поле OpenClaw	Поле VibeOS	Примечания
mcp.servers.*.command	mcp_servers.*.command	Stdio-транспорт
mcp.servers.*.args	mcp_servers.*.args
mcp.servers.*.env	mcp_servers.*.env
mcp.servers.*.cwd	mcp_servers.*.cwd
mcp.servers.*.url	mcp_servers.*.url	HTTP/SSE-транспорт
mcp.servers.*.tools.include	mcp_servers.*.tools.include	Фильтрация инструментов
mcp.servers.*.tools.exclude	mcp_servers.*.tools.exclude

TTS (текст-в-речь)

Настройки TTS читаются из двух расположений конфига OpenClaw со следующим приоритетом:

1. messages.tts.providers.{provider}.* (каноническое расположение)
2. talk.providers.{provider}.* верхнего уровня (запасной вариант)
3. Устаревшие плоские ключи messages.tts.{provider}.* (самый старый формат)

Что	Назначение VibeOS
Имя провайдера	config.yaml → tts.provider
ID голоса ElevenLabs	config.yaml → tts.elevenlabs.voice_id
ID модели ElevenLabs	config.yaml → tts.elevenlabs.model_id
Модель OpenAI	config.yaml → tts.openai.model
Голос OpenAI	config.yaml → tts.openai.voice
Голос Edge TTS	config.yaml → tts.edge.voice (OpenClaw переименовал "edge" в "microsoft" — оба распознаются)
Ресурсы TTS	~/.vibeos/tts/ (копирование файлов)

Платформы обмена сообщениями

Платформа	Путь конфига OpenClaw	Переменная .env VibeOS	Примечания
Telegram	channels.telegram.botToken или .accounts.default.botToken	TELEGRAM_BOT_TOKEN	Токен может быть строкой или SecretRef. Поддерживаются как плоская, так и аккаунтная структуры.
Telegram	credentials/telegram-default-allowFrom.json	TELEGRAM_ALLOWED_USERS	Объединены через запятую из массива allowFrom[]
Discord	channels.discord.token или .accounts.default.token	DISCORD_BOT_TOKEN
Discord	channels.discord.allowFrom или .accounts.default.allowFrom	DISCORD_ALLOWED_USERS
Slack	channels.slack.botToken или .accounts.default.botToken	SLACK_BOT_TOKEN
Slack	channels.slack.appToken или .accounts.default.appToken	SLACK_APP_TOKEN
Slack	channels.slack.allowFrom или .accounts.default.allowFrom	SLACK_ALLOWED_USERS
WhatsApp	channels.whatsapp.allowFrom или .accounts.default.allowFrom	WHATSAPP_ALLOWED_USERS	Аутентификация через QR-сопряжение Baileys — требуется повторное сопряжение после миграции
Signal	channels.signal.account или .accounts.default.account	SIGNAL_ACCOUNT
Signal	channels.signal.httpUrl или .accounts.default.httpUrl	SIGNAL_HTTP_URL
Signal	channels.signal.allowFrom или .accounts.default.allowFrom	SIGNAL_ALLOWED_USERS
Matrix	channels.matrix.accessToken или .accounts.default.accessToken	MATRIX_ACCESS_TOKEN	Использует accessToken (не botToken)
Mattermost	channels.mattermost.botToken или .accounts.default.botToken	MATTERMOST_BOT_TOKEN

Прочие настройки

Что	Путь OpenClaw	Путь VibeOS	Примечания
Режим одобрения	approvals.exec.mode	config.yaml → approvals.mode	"auto"→"off", "always"→"manual", "smart"→"smart"
Белый список команд	exec-approvals.json	config.yaml → command_allowlist	Шаблоны объединяются и дедуплицируются
URL браузера CDP	browser.cdpUrl	config.yaml → browser.cdp_url
Безголовый браузер	browser.headless	config.yaml → browser.headless
Ключ поиска Brave	tools.web.search.brave.apiKey	.env → BRAVE_API_KEY	Требуется --migrate-secrets
Токен аутентификации шлюза	gateway.auth.token	.env → VIBEOS_GATEWAY_TOKEN	Требуется --migrate-secrets
Рабочая директория	agents.defaults.workspace	config.yaml → terminal.cwd	Устаревшие миграции могут по-прежнему записывать MESSAGING_CWD в качестве запасного варианта для совместимости

Архивировано (нет прямого аналога в VibeOS)

Они сохраняются в ~/.vibeos/migration/openclaw/<timestamp>/archive/ для ручного просмотра:

Что	Файл архива	Как воссоздать в VibeOS
IDENTITY.md	archive/workspace/IDENTITY.md	Объединить в SOUL.md
TOOLS.md	archive/workspace/TOOLS.md	VibeOS имеет встроенные инструкции по инструментам
HEARTBEAT.md	archive/workspace/HEARTBEAT.md	Используйте cron-задачи для периодических действий
BOOTSTRAP.md	archive/workspace/BOOTSTRAP.md	Используйте контекстные файлы или навыки
Cron-задачи	archive/cron-config.json	Воссоздать с помощью vibeos cron create
Плагины	archive/plugins-config.json	См. руководство по плагинам
Хуки/вебхуки	archive/hooks-config.json	Используйте vibeos webhook или хуки шлюза
Бэкенд памяти	archive/memory-backend-config.json	Настроить через vibeos honcho
Реестр навыков	archive/skills-registry-config.json	Используйте vibeos skills config
UI/идентичность	archive/ui-identity-config.json	Используйте команду /skin
Логирование	archive/logging-diagnostics-config.json	Установить в разделе логирования config.yaml
Список мульти-агентов	archive/agents-list.json	Используйте профили VibeOS
Привязки каналов	archive/bindings.json	Ручная настройка для каждой платформы
Сложные каналы	archive/channels-deep-config.json	Ручная настройка платформы

Разрешение API-ключей

Когда включён --migrate-secrets, API-ключи собираются из четырёх источников в порядке приоритета:

1. Значения конфига — models.providers.*.apiKey и ключи провайдеров TTS в openclaw.json
2. Файл окружения — ~/.openclaw/.env (ключи типа OPENROUTER_API_KEY, ANTHROPIC_API_KEY и т.д.)
3. Подобъект env конфига — openclaw.json → "env" или "env"."vars" (некоторые конфигурации хранят ключи здесь вместо отдельного файла .env)
4. Профили аутентификации — ~/.openclaw/agents/main/agent/auth-profiles.json (учётные данные для каждого агента)

Значения конфига имеют приоритет. Каждый последующий источник заполняет оставшиеся пробелы.

Поддерживаемые целевые ключи

OPENROUTER_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, DEEPSEEK_API_KEY, GEMINI_API_KEY, ZAI_API_KEY, MINIMAX_API_KEY, ELEVENLABS_API_KEY, TELEGRAM_BOT_TOKEN, VOICE_TOOLS_OPENAI_KEY

Ключи, не входящие в этот белый список, никогда не копируются.

Обработка SecretRef

Значения токенов и API-ключей в конфиге OpenClaw могут быть в трёх форматах:

// Простая строка
"channels": { "telegram": { "botToken": "123456:ABC-DEF..." } }

// Шаблон окружения
"channels": { "telegram": { "botToken": "${TELEGRAM_BOT_TOKEN}" } }

// Объект SecretRef
"channels": { "telegram": { "botToken": { "source": "env", "id": "TELEGRAM_BOT_TOKEN" } } }

Миграция обрабатывает все три формата. Для шаблонов окружения и объектов SecretRef с source: "env" значение ищется в ~/.openclaw/.env и подобъекте env в openclaw.json. Объекты SecretRef с source: "file" или source: "exec" не могут быть разрешены автоматически — миграция предупреждает о них, и эти значения необходимо добавить в VibeOS вручную через vibeos config set.

После миграции

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

2. Просмотрите архивированные файлы — всё в ~/.vibeos/migration/openclaw/<timestamp>/archive/ требует ручного внимания.

3. Начните новую сессию — импортированные навыки и записи памяти вступают в силу в новых сессиях, а не в текущей.

4. Проверьте API-ключи — выполните vibeos status, чтобы проверить аутентификацию провайдеров.

5. Протестируйте обмен сообщениями — если вы перенесли токены платформ, перезапустите шлюз: systemctl --user restart vibeos-gateway

6. Проверьте политики сессий — выполните vibeos config show и убедитесь, что значение session_reset соответствует вашим ожиданиям.

7. Повторно сопрягите WhatsApp — WhatsApp использует QR-сопряжение (Baileys), а не перенос токенов. Выполните vibeos whatsapp для сопряжения.

8. Очистка архива — после подтверждения, что всё работает, выполните vibeos claw cleanup, чтобы переименовать оставшиеся директории OpenClaw в .pre-migration/ (предотвращает путаницу состояний).

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

«Директория OpenClaw не найдена»

Миграция проверяет ~/.openclaw/, затем ~/.clawdbot/, затем ~/.moltbot/. Если ваша установка находится в другом месте, используйте --source /путь/к/вашему/openclaw.

«Не найдены API-ключи провайдеров»

Ключи могут храниться в нескольких местах в зависимости от версии OpenClaw: встроенные в openclaw.json в models.providers.*.apiKey, в ~/.openclaw/.env, в подобъекте "env" в openclaw.json или в agents/main/agent/auth-profiles.json. Миграция проверяет все четыре. Если ключи используют SecretRef с source: "file" или source: "exec", они не могут быть разрешены автоматически — добавьте их через vibeos config set.

Навыки не отображаются после миграции

Импортированные навыки попадают в ~/.vibeos/skills/openclaw-imports/. Начните новую сессию, чтобы они вступили в силу, или выполните /skills, чтобы убедиться, что они загружены.

TTS-голос не перенесён

OpenClaw хранит настройки TTS в двух местах: messages.tts.providers.* и конфиг talk верхнего уровня. Миграция проверяет оба. Если ваш ID голоса был установлен через UI OpenClaw (хранится в другом пути), вам может потребоваться установить его вручную: vibeos config set tts.elevenlabs.voice_id YOUR_VOICE_ID.