tashfeenahmed/scallopbot

Что это?

Ключевые возможности

• 01Память со временем угасает, объединяется и архивируется; при поиске сочетаются BM25 и эмбеддинги.
• 02Маршрутизация запросов с учётом стоимости между семью провайдерами LLM, с переключением при сбоях и дневными/месячными лимитами.
• 03Поддержка MCP в обе стороны: агент использует MCP-серверы и предоставляет другим клиентам инструменты для работы с памятью.
• 04Ночная фоновая консолидация, самоанализ и проактивный поиск пробелов.
• 05Совместимость со skills для OpenClaw и в стиле agentskills.io; в комплекте 34 навыка.
• 06Варианты локальной транскрибации и синтеза речи, а также веб-панель, которую можно установить как приложение.

Сценарии использования

• Запустить приватного постоянно работающего ассистента на домашнем сервере или Raspberry Pi и общаться с ним через Telegram.
• Использовать одну общую долговременную память для чат-ассистента и инструментов разработки, например Claude Code, через MCP.
• Контролировать расходы на LLM, направляя запросы к более дешёвым или мощным моделям и задавая лимиты.
• Экспериментировать с устройством памяти агента, выходя за рамки простого хранения заметок.

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

1. 1

   Клонируйте репозиторий

   git clone https://github.com/tashfeenahmed/scallopbot.git
2. 2

   Перейдите в папку и установите зависимости

   cd scallopbot && npm install
3. 3

   Скопируйте .env.example в .env, добавьте как минимум один API-ключ провайдера LLM, затем выполните сборку

   npm run build
4. 4

   Запустите бота; панель управления доступна по адресу http://localhost:3000

   node dist/cli.js start

Что важно знать

• !Требуется Node.js версии 24 или новее.
• !Для работы нужен как минимум один API-ключ платного провайдера LLM.
• !Пакет ещё не опубликован в реестре npm, поэтому его нужно собрать из клонированного репозитория.

Темы

Частые вопросы

Что такое scallopbot?

Персональный ИИ-ассистент для собственного сервера с памятью по биологическим принципам: она объединяется, связывается и со временем забывается; доступна через MCP и совместима со skills для OpenClaw. ScallopBot — персональный ИИ-агент, который работает на вашем сервере и общается с вами через Telegram, веб-панель, CLI или такие каналы, как Discord, Slack, WhatsApp, Signal и Matrix. Его память хранится в одном файле SQLite и сочетает поиск по ключевым словам BM25 с эмбеддингами и опциональным ранжированием с помощью LLM. Воспоминания постепенно угасают в зависимости от категории, объединяются в сводки, а записи с низкой полезностью сначала помещаются в архив, а затем удаляются.

scallopbot можно использовать бесплатно? Какая у него лицензия?

scallopbot распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

scallopbot всё ещё поддерживается?

Активно поддерживается. Последний коммит в scallopbot — 16 окт. 2026 г..

Для чего можно использовать scallopbot?

Запустить приватного постоянно работающего ассистента на домашнем сервере или Raspberry Pi и общаться с ним через Telegram. Использовать одну общую долговременную память для чат-ассистента и инструментов разработки, например Claude Code, через MCP. Контролировать расходы на LLM, направляя запросы к более дешёвым или мощным моделям и задавая лимиты. Экспериментировать с устройством памяти агента, выходя за рамки простого хранения заметок.

Как установить scallopbot?

Клонируйте репозиторий: git clone https://github.com/tashfeenahmed/scallopbot.git Перейдите в папку и установите зависимости: cd scallopbot && npm install Скопируйте .env.example в .env, добавьте как минимум один API-ключ провайдера LLM, затем выполните сборку: npm run build Запустите бота; панель управления доступна по адресу http://localhost:3000: node dist/cli.js start

Где скачать scallopbot?

Исходный код и инструкции по установке — на GitHub: https://github.com/tashfeenahmed/scallopbot