Onboarding
A first run does not open the wizard. OpenCrabs goes straight to the chat, with its built-in provider already provisioned and the agent greeting you. The onboarding wizard is opt-in: run opencrabs --onboard, or /onboard from inside a session.
Видеоинструкции есть на странице Видео по онбордингу.
Быстрый старт (3 минуты)
Быстрый путь позволяет начать разговор с агентом меньше чем за 3 минуты.
| Шаг | Действие |
|---|---|
| 1. Режим | Нажмите Enter на QuickStart |
| 2. Рабочая область | Нажмите Enter, чтобы принять путь по умолчанию |
| 3. Провайдер | Стрелками выберите провайдера (например, z.ai) и нажмите Enter. Стрелкой вниз выберите тариф (например, Coding) и нажмите Enter |
| 4. API-ключ | Вставьте ключ (Cmd+V / Ctrl+V / Cmd+Shift+V / Ctrl+Shift+V) и нажмите Enter. Список моделей загружается сразу |
| 5. Модель | Стрелками выберите модель (например, gemini-2.5-pro) и нажмите Enter |
| 6. Демон | Стрелками выберите, запускать ли демон в фоне, и нажмите Enter |
| 7. Vibe Check | Все проверки должны показать ✅. Нажмите Enter |
| 8. О вас | Напишите что-нибудь о себе. Чем больше агент знает, тем лучше. Нажмите Enter |
| 9. Об агенте | Напишите что-нибудь о характере агента. Нажмите Enter |
| 10. Чат | Готово. Начните разговор с агентом |
Расширенная настройка (7 минут)
Полная настройка с Telegram, локальным голосом, Vision и генерацией изображений.
| Шаг | Действие |
|---|---|
| 1. Режим | Нажмите Enter на QuickStart |
| 2. Рабочая область | Нажмите Enter, чтобы принять путь по умолчанию |
| 3. Провайдер | Стрелками выберите провайдера (например, z.ai) и нажмите Enter. Стрелкой вниз выберите тариф и нажмите Enter |
| 4. API-ключ | Вставьте ключ и нажмите Enter. Список моделей загружается сразу |
| 5. Модель | Стрелками выберите модель и нажмите Enter |
| 6. Каналы | Стрелками выберите Other, нажмите Space, чтобы выбрать Telegram, и нажмите Enter. Вставьте токен бота и следуйте инструкциям, чтобы получить ID чата, затем нажмите Enter. Выберите режим упоминаний и нажмите Enter. Когда появится Connected, снова нажмите Enter. Стрелкой вниз выберите Continue и нажмите Enter |
| 7. STT | Выберите Local и нажмите Enter. Выберите размер модели (например, tiny для скорости) и нажмите Enter |
| 8. TTS | Снова выберите Local и нажмите Enter. Выберите голос (например, Ryan) и нажмите Enter. Дождитесь загрузки модели, стрелкой вниз выберите Continue и нажмите Enter |
| 9. Изображения | Нажмите Space, чтобы выбрать Vision и Image Generation, и нажмите Enter. Вставьте API-ключ Gemini и нажмите Enter |
| 10. Демон | Стрелками выберите, запускать ли демон в фоне, и нажмите Enter |
| 11. Vibe Check | Все проверки должны показать ✅. Нажмите Enter |
| 12. О вас | Напишите что-нибудь о себе. Чем больше агент знает, тем лучше. Нажмите Enter |
| 13. Об агенте | Напишите что-нибудь о характере агента. Нажмите Enter |
| 14. Чат | Готово. Начните разговор с агентом |
Ход онбординга
Мастер работает с клавиатуры в TUI и состоит из 8 шагов. Перемещайтесь стрелками, Tab переходит вперёд, Esc возвращает назад.
| Шаг | Экран | Что нужно сделать |
|---|---|---|
| 1 | Выбор режима | Выберите QuickStart (без каналов) или Advanced |
| 2 | Рабочая область | Выберите рабочую папку для файловых операций |
| 3 | Провайдер и авторизация | Выберите провайдера → вставьте API-ключ → выберите модель (список загружается сразу) |
| 4 | Каналы | Space включает и выключает каналы → Enter на каждом для настройки |
| 5 | Голос | Провайдер STT (Groq, локальный Whisper или выключено) и голос TTS |
| 6 | Изображения | Переключатель Vision + модель генерации + API-ключ |
| 7 | Демон | Установить фоновый демон (необязательно) |
| 8 | Настройка brain files | Автоматически создать SOUL.md из вашего профиля |
Настройка каналов (шаг 4)
На экране каналов доступно 5 интеграций: Telegram, Discord, WhatsApp, Slack, Trello.
Spaceвключает и выключает каналEnterна включённом канале открывает экран его настройки (токен, ID, списки разрешённых)Enterна Continue илиTabпереходит к следующему шагу- На каждом экране настройки канала есть кнопка Test Connection
Полное руководство по навигации см. в разделе Обзор каналов.
Повторный запуск настройки
Можно перейти к любому шагу, не запуская весь мастер заново:
| Команда | Шаг |
|---|---|
/onboard | Полный мастер |
/onboard:provider | Выбор провайдера и модели |
/onboard:channels | Выбор каналов |
/onboard:voice | Настройка голоса |
/onboard:image | Настройка изображений |
/onboard:brain | Создание brain files |
После онбординга агент запускается и представляется. Он читает свои brain files (SOUL.md, AGENTS.md, TOOLS.md) и начинает разговор.
Bootstrap
При самом первом запуске агент проходит фазу bootstrap:
- Знакомится с вами (имя, предпочтения, стиль работы)
- Определяет свою идентичность (имя, характер, эмодзи)
- Вместе с вами открывает
SOUL.md, чтобы обсудить ценности - Заполняет
USER.mdвашим профилем
Файл bootstrap (BOOTSTRAP.md) удаляется сам после завершения.
Перенос из другого инструмента
Уже используете ClaudeCode, OpenClaw, Hermes или другой harness для AI-агентов? Ваш агент может перенести существующие данные (память, skills, пользовательские команды, предпочтения) в свои brain files на естественном языке. Ручное перекладывание файлов не нужно.
Это работает с любым агентом или harness для программирования, который хранит конфигурацию локально. Миграция ищет каталоги конфигурации другого инструмента в вашей файловой системе, читает их содержимое и переносит его в формат brain files OpenCrabs (SOUL.md, USER.md, TOOLS.md, MEMORY.md, AGENTS.md, CODE.md).
Миграция под контролем
Если хотите проверить, что будет перенесено, до начала переноса:
Найди мои данные ClaudeCode/OpenClaw/Hermes локально (или данные любого другого агентского harness, который я использовал), проведи аудит миграции в наши brain files, сообщи, когда закончишь, и выполни перенос только после моего подтверждения и одобрения.
Агент:
- Ищет в файловой системе каталоги конфигурации другого инструмента
- Читает и разбирает все нужные файлы (память, команды, skills, предпочтения)
- Составляет аудит с точным указанием, что куда переносится
- Ждёт вашего подтверждения
- Выполняет миграцию и выдаёт полный отчёт
Автономная миграция
Если нужно просто всё сделать:
Найди мои существующие данные агента или harness локально и перенеси всё в наши brain files без моего одобрения. Спланируй и выполни миграцию сразу, по завершении сообщи полный отчёт.
Агент пропускает этап аудита, планирует миграцию внутренне, выполняет её и выдаёт сводку всего перенесённого.
Что переносится
| Источник | Назначение | Пример |
|---|---|---|
| Память / CLAUDE.md / файлы контекста | MEMORY.md | Решения по проекту, прошлый контекст |
| Пользовательские команды | commands.toml | Slash-команды и их определения |
| Skills / инструкции агента | AGENTS.md, TOOLS.md | Правила workflow, настройки инструментов |
| Предпочтения и профиль пользователя | USER.md | Имя, часовой пояс, стиль кода |
| Стандарты кода / правила линтера | CODE.md | Руководства по стилю, соглашения |
Совет: запускайте миграцию сразу после онбординга, пока контекст свежий. У агента уже есть
USER.mdиSOUL.mdиз мастера, поэтому он может объединить данные, а не перезаписывать их.
Основные команды
| Команда | Описание |
|---|---|
/help | Показать все доступные команды |
/models | Переключить провайдера или модель |
/new | Создать новую session |
/sessions | Переключение между sessions |
/cd | Сменить рабочую папку |
/compact | Вручную сжать контекст |
/evolve | Скачать последнюю версию |
/rebuild | Собрать из исходников |
/approve | Задать политику одобрения |
Режимы одобрения
Настройте, насколько автономен агент:
| Режим | Поведение |
|---|---|
/approve | Запрашивать подтверждение перед каждым использованием инструмента (по умолчанию) |
/approve auto | Автоматически одобрять в этой session |
/approve yolo | Всегда одобрять автоматически (сохраняется) |
Рабочая папка
Агент работает в рабочей папке для файловых операций. Изменить её можно так:
- Команда
/cdв чате - Выбор папки в TUI (Tab для выбора)
- Инструмент
config_manager set_working_directory
Рабочая папка сохраняется для каждой session. При переключении session папка восстанавливается автоматически.
Подсказка фильтра моделей (v0.3.78)
В выборе модели при онбординге теперь всегда показывается подсказка фильтра над списком моделей (“Type to filter…”). Раньше подсказка появлялась только после начала ввода, поэтому пользователи не знали о фильтре. Кроме того, точно введённый ID модели теперь важнее совпадения по подстроке: если ввести claude-opus-4-8 полностью, выбирается именно эта модель, даже если в других моделях есть такая же подстрока.