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.
Видеоинструкции есть на странице Видео по онбордингу.
Первый запуск: ты попадаешь в чат
При чистой установке никакого мастера нет. OpenCrabs открывает чат, включает встроенного провайдера и здоровается:
config.tomlиkeys.tomlсоздаются из поставляемого примера, если их ещё нет.[providers.opencrabs]включается. В примере он выключен, и именно это делает его активным провайдером.- Установка запрашивает у
inference.opencrabs.comсобственный токен и сохраняет его вkeys.toml. Токен переиспользуется при каждом следующем запуске, поэтому это происходит один раз. - Агент читает свои brain files и приветствует тебя моделью, на которой работает.
Если запрос токена не прошёл (нет сети, прокси недоступен), ты всё равно попадаешь в рабочий чат со строкой о том, что случилось. Набери /onboard, чтобы выбрать другого провайдера, или почини соединение и перезапусти. Onboarding помечается завершённым только когда встроенный провайдер действительно поднялся, поэтому следующий запуск пробует снова, а не оставляет тебя в чате без провайдера.
Что ты получаешь без всякой настройки
| Возможность | Model | Notes |
|---|---|---|
| Чат | deepseek-v4.1-flash | 200k контекста, фиксировано |
| Зрение | deepseek-v4.1-flash | Прикрепи изображение, и оно работает |
| Генерация изображений | gemini-2.5-flash-image | Отдаётся только по маршруту изображений, никогда как чат-модель |
| Голос на вход | qwen3.8-omni-flash | Голосовое сообщение распознаётся, ответ приходит текстом |
| Голос на выход | не поддерживается | Нужен другой движок TTS, см. Голос |
Бесплатно, без аккаунта, без ключа, без лимитов использования на время экспериментальной фазы. Прокси ограничивает злоупотребления (штормы запросов, массовое создание установок), и обычного использования это не касается. Запросы идут на inference.opencrabs.com, который пересылает их хосту модели в апстриме. Все детали, включая где живёт токен и как выйти: OpenCrabs (встроенный).
Чтобы позже перейти на другого провайдера, набери /models и выбери его, или запусти /onboard и выбери Advanced.
Быстрый старт (мастер, 1 минута)
Мастер опционален: opencrabs --onboard перед первым запуском или /onboard внутри сессии. Выбери QuickStart, чтобы оставить значения по умолчанию и пропустить шаги.
| Шаг | Действие |
|---|---|
| 1. Режим | Стрелками дойди до QuickStart и нажми Enter |
| 2. Рабочая область | Нажмите Enter, чтобы принять путь по умолчанию |
| 3. Провайдер | Стрелками выбери нужного провайдера и нажми Enter. OpenCrabs (встроенный) не требует ключа; любой другой его попросит |
| 4. API-ключ | Только для провайдера, которому он нужен. Вставь его (Cmd+V / Ctrl+V) и нажми Enter. Список моделей загружается вживую |
| 5. Модель | Стрелками выберите модель и нажмите Enter |
| 6. Демон | Стрелками выбери, запускать ли как фоновый daemon, и нажми Enter |
| 7. Vibe Check | Все проверки должны показать ✅. Нажмите Enter |
| 8. О вас | Напиши что-нибудь о себе. Чем больше агент знает, тем лучше. Нажми Enter |
| 9. Об агенте | Напишите что-нибудь о характере агента. Нажмите Enter |
| 10. Чат | Ты внутри. Агент здоровается и спрашивает только то, чего ещё не хватает |
Расширенная настройка (7 минут)
Полная настройка с Telegram, локальным голосом, Vision и генерацией изображений.
| Шаг | Действие |
|---|---|
| 1. Режим | Стрелками дойди до Advanced и нажми Enter |
| 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 полностью, выбирается именно эта модель, даже если в других моделях есть такая же подстрока.