Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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 открывает чат, включает встроенного провайдера и здоровается:

  1. config.toml и keys.toml создаются из поставляемого примера, если их ещё нет.
  2. [providers.opencrabs] включается. В примере он выключен, и именно это делает его активным провайдером.
  3. Установка запрашивает у inference.opencrabs.com собственный токен и сохраняет его в keys.toml. Токен переиспользуется при каждом следующем запуске, поэтому это происходит один раз.
  4. Агент читает свои brain files и приветствует тебя моделью, на которой работает.

Если запрос токена не прошёл (нет сети, прокси недоступен), ты всё равно попадаешь в рабочий чат со строкой о том, что случилось. Набери /onboard, чтобы выбрать другого провайдера, или почини соединение и перезапусти. Onboarding помечается завершённым только когда встроенный провайдер действительно поднялся, поэтому следующий запуск пробует снова, а не оставляет тебя в чате без провайдера.

Что ты получаешь без всякой настройки

ВозможностьModelNotes
Чатdeepseek-v4.1-flash200k контекста, фиксировано
Зрение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, сообщи, когда закончишь, и выполни перенос только после моего подтверждения и одобрения.

Агент:

  1. Ищет в файловой системе каталоги конфигурации другого инструмента
  2. Читает и разбирает все нужные файлы (память, команды, skills, предпочтения)
  3. Составляет аудит с точным указанием, что куда переносится
  4. Ждёт вашего подтверждения
  5. Выполняет миграцию и выдаёт полный отчёт

Автономная миграция

Если нужно просто всё сделать:

Найди мои существующие данные агента или harness локально и перенеси всё в наши brain files без моего одобрения. Спланируй и выполни миграцию сразу, по завершении сообщи полный отчёт.

Агент пропускает этап аудита, планирует миграцию внутренне, выполняет её и выдаёт сводку всего перенесённого.

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

ИсточникНазначениеПример
Память / CLAUDE.md / файлы контекстаMEMORY.mdРешения по проекту, прошлый контекст
Пользовательские командыcommands.tomlSlash-команды и их определения
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 полностью, выбирается именно эта модель, даже если в других моделях есть такая же подстрока.