Krabobot - ИИ агент для офисного использования: Руководство

Привет.

Хочу простым языком рассказать, как поставить Krabobot — ИИ агент для офисного использования.

Это локальный помощник, который отвечает в Telegram, VK, по почте и в обычном браузере.

Без лишней «магии для программистов»: шаги, короткие команды, скриншоты и бытовые сценарии из офиса.

Официальный сайт: https://крабобот.рф/. Исходники на GitHub: https://github.com/andretisch/krabobot.

Зачем это офисному сотруднику

Коротко: бот живёт у вас на компьютере (или на офисном ПК). С ним удобно:

перефразировать письмо клиенту;
набросать ответ на жалобу или служебную записку;
разложить длинный текст на пункты;
держать контекст по задаче — у каждого пользователя своя память;
писать из Telegram или VK (если настроите каналы);
зайти в веб-чат через браузер.

Что умеет krabobot: каналы, профиль, регистрация, память

Один агент — Telegram, ВКонтакте и Email

Это не «ещё один чат на чужом сайте». Файлы и память лежат у вас на диске, а к модели вы подключаетесь так, как удобнее: локально или через облачный ключ Ollama.

Что нужно заранее

Компьютер на Windows, Linux или macOS (ниже — шаги для Windows, в офисе чаще так).
Python 3.11+. В PowerShell: python --version.
Интернет на время установки.
Аккаунт на ollama.com — если нет локальной Ollama на машине (ниже покажу, как взять ключ и вставить его в настройки).

Если Python ещё не стоит: скачайте установщик с python.org и на Windows поставьте галочку «Add python.exe to PATH».

Установка

Откройте PowerShell и выполните по порядку.

Скачайте проект (или распакуйте архив с GitHub):

git clone https://github.com/andretisch/krabobot.git
cd krabobot

Подготовьте отдельную «песочницу» для программ и включите её:

python -m venv .venv
.\.venv\Scripts\Activate.ps1

В начале строки должно появиться (.venv) — значит, всё правильно.

Поставьте krabobot:

python -m pip install --upgrade pip
pip install -e ".[dev,api]"

Если pip в России капризничает

Иногда пакеты скачиваются с таймаутами и обрывами. Подробный разбор и рабочие варианты — в отдельной заметке: pip в России начал работать с перебоями. В этой статье шаги по зеркалам не дублирую — просто откройте ссылку, если установка зависла.

На сайте проекта тот же смысл старта свёрнут в блок «Быстрый старт»:

Первый запуск

Один раз инициализируем рабочую папку:

krabobot onboard

Появится каталог вроде C:\Users\<вы>\.krabobot — туда складываются настройки, логи и память. Дальше почти всё удобно править через вкладку «Настройки» в браузере (об этом ниже).

После onboard можно сразу поднять веб-чат

Ключ Ollama Cloud — чтобы бот заработал сразу

По умолчанию krabobot умеет работать с Ollama. Если на компьютере уже крутится локальная Ollama — ключ не нужен. Если локальной нет — берём облако Ollama Cloud: регистрируемся, создаём ключ и вставляем его в веб-настройки. После этого можно сразу писать в чат.

Зайдите на ollama.com и создайте аккаунт (или войдите, если аккаунт уже есть).

Откройте раздел ключей в аккаунте: https://ollama.com/settings/keys (Settings → Keys). Создайте ключ и скопируйте его.
Запустите веб-чат (если ещё не запущен):

krabobot serve

Откройте в браузере http://127.0.0.1:8900/, меню → «Настройки».

Проверьте, что провайдер — Ollama, модель — например gemma4:cloud (или другая облачная модель из кабинета Ollama).

В настройках выбран Ollama и облачная модель

Пролистайте до блока ollama, в поле Api Key вставьте скопированный ключ и нажмите «Сохранить».

Сюда вставляется ключ из кабинета Ollama (на скрине — замазанный пример)

Важно: ключ — только в ваши настройки / ваш конфиг на компьютере. Не публикуйте его в статьях, чатах и не кладите в git. На скриншотах выше — заглушка, не настоящий ключ.

После сохранения можно вернуться в чат и написать «Привет» — бот должен ответить.

Веб-чат

Самый простой способ «просто поболтать» без Telegram:

krabobot serve

Адрес обычно такой: http://127.0.0.1:8900/

Вкладка «Настройки» — удобная форма вместо правки файлов вручную: провайдер, модель, каналы, ключи. Пустое секретное поле при сохранении не затирает уже сохранённый ключ. Перед сохранением делается резервная копия — если что-то сменили случайно, можно откатиться.

Настройки в браузере: провайдер, модель, workspace

Страница настроек по умолчанию без отдельного логина. Не открывайте этот адрес «в интернет как есть» — держите на своём компьютере.

Если нужны мессенджеры круглосуточно, обычно поднимают ещё:

krabobot gateway

Для первой пробы в офисе хватает serve и браузера.

Базовые команды в чате

Пишите их прямо сообщением боту:

/help — список команд;
/tts on / /tts off — голосовые ответы для себя;
/reg — заявка на регистрацию, если вы не первый пользователь;
/new — новый диалог;
/clear_memory — очистить память, когда нужно «забыть» лишнее;
/link — связать аккаунты между каналами (один человек = один профиль).

Первый, кто написал боту, становится владельцем. Остальные проходят /reg и ждут подтверждения. Так коллега не «вломится» в вашего бота без вашего ведома.

Сценарии на каждый день

Обычный рабочий стол: бот под рукой в мессенджере

1. Письмо «помягче»

«Перепиши вежливо, без воды, до 5 предложений: …» — вставляете черновик, получаете нормальный тон для клиента.

2. Разбор длинной переписки

«Выпиши обязательства сторон и сроки из текста ниже» — удобно перед совещанием.

3. Шаблон служебной записки

«Сделай шаблон служебки: тема, основание, просьба, срок» — правите цифры сами, каркас уже есть.

4. Память по людям

Каждый зарегистрированный пользователь — свой профиль. Коллега со своим Telegram не увидит вашу историю.

5. Голос, когда руки заняты

Включили /tts on — ответы можно слушать в Telegram/VK. Голосовые сообщения бот тоже умеет понимать, если канал это поддерживает.

Мини-чек-лист «я всё сделал»

Python 3.11+ установлен.
Проект скачан, окружение включено ((.venv) в строке).
pip install -e ".[dev,api]" прошёл (если нет — см. ссылку про pip выше).
krabobot onboard создал папку ~/.krabobot.
Ключ Ollama Cloud вставлен в «Настройки» или работает локальная Ollama.
krabobot serve → открыли чат → написали «Привет».
По желанию: токен Telegram/VK в настройках и krabobot gateway.

Где читать дальше

Сайт: https://крабобот.РФ/
GitHub: https://github.com/andretisch/krabobot
В репозитории — подробный README (каналы, команды, структура рабочей папки).
Про перебои pip: hostlip.ru — pip в России

На этом всё. Поставьте, напишите боту пару рабочих писем — и станет понятно, нужен ли вам gateway или пока хватает веб-чата. Работает. Пробуйте.