Skip to content

Refusned/Kent-Overlay

Repository files navigation

Kent — Личный AI-ассистент в Telegram

Kent AI Assistant

Production-ready AI-ассистент в Telegram. 17 кастомных скиллов. Деплой одной командой на VPS.

Try the bot · Architecture · Deployment · Skills


О проекте

Kent — это не "ещё один чат-бот над ChatGPT". Это цифровой сотрудник, который доставляется клиенту как готовый Telegram-бот с собственной личностью, долговременной памятью, 17 кастомными скиллами и автоматизацией через cron.

Под капотом — overlay (надстройка) над платформой OpenClaw, упакованная в Docker Compose с идемпотентным деплоем, мониторингом, бэкапами, hardened-конфигом (cap_drop ALL, loopback) и интеграциями с Google Workspace, Telegram, ChatGPT/DALL-E, ElevenLabs TTS, Yandex IoT.

Цель — закрыть рутину малого бизнеса (SMM, CRM, документы, финансы, лиды) одним инструментом, который ставится на VPS клиента за 10 минут и стоит дешевле найма помощника.

Кому интересно

  • Предпринимателям — как упаковать AI-агента в продаваемый B2B-продукт: Product Blueprint (концепция, архитектура персоны, скиллов) и Tech Plan (3 варианта деплоя — от ручного MVP до автоматизированной SaaS)
  • Разработчикам — production-ready overlay над OpenClaw с 17 кастомными скиллами, hooks и cron
  • Клиентамbash install.sh → персональный бот на твоём VPS за 10 минут

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

bash <(curl -fsSL https://raw.githubusercontent.com/Refusned/Kent-Overlay/main/install.sh)

Ручной деплой: prerequisites.sh -> configure.sh -> deploy.sh

Что умеет Kent v1

Core Telegram-чат с личностью и памятью, онбординг, голосовые, файлы, генерация картинок, веб-поиск, TTS
Скиллы 7 core + 8 beta + 2 experimental (подробности)
Автоматизация 5 cron-задач: утренний брифинг, health-check, отчёт, SMM, бэкап
Рецепты 31 KentBytes в 6 категориях (бухгалтеры, предприниматели, фрилансеры, юристы, SMM, студенты)
API Gateway FastAPI на порту 8000: 17+ REST endpoints + WebSocket, Swagger UI на /docs, Bearer auth, rate limiting
RAG Memory PostgreSQL + pgvector для semantic search (vanilla psycopg + LangChain PGVector). LangChain LCEL chains, LangGraph workflow с conditional routing
Multi-LLM Унифицированный интерфейс для 4 провайдеров: OpenAI, Anthropic, YandexGPT, GigaChat (POST /llm/chat?provider=...)

Требования

  • Ubuntu 24.04 LTS
  • 4 GB RAM, 2 vCPU, 40 GB SSD
  • Docker 24+
  • Telegram Bot Token (от @BotFather)
  • Подписка OpenAI Codex (для моделей)

Документация

Документ Описание
READINESS.md Матрица готовности всех компонентов
docs/DEPLOYMENT.md Гайд по деплою
docs/CONFIG-REFERENCE.md Справочник по конфигурации
docs/INTEGRATIONS.md Настройка интеграций
docs/TROUBLESHOOTING.md Решение проблем
docs/CUSTOMIZATION.md Кастомизация под клиента

Тестирование

bash tests/run-all.sh          # static + deploy тесты
bash tests/run-all.sh smoke    # smoke-тесты (требуют запущенный инстанс)

Ручной чеклист: tests/MANUAL-SMOKE-CHECKLIST.md

Структура проекта

kent-overlay/
  workspace/           # Рантайм агента: личность, правила, память, скиллы
    SOUL.md            # Характер и тон (432 строки)
    SECURITY.md        # Неизменяемые правила безопасности
    AGENTS.md          # Операционное поведение (602 строки)
    skills/            # 17+ кастомных скиллов
    kentbytes/         # 31 рецепт в 6 категориях
  api/                 # FastAPI gateway
    main.py            # HTTP API: /health, /skills, /integrations, /metrics
    Dockerfile         # python:3.12-slim, non-root user, healthcheck
    requirements.txt   # fastapi + uvicorn + pydantic
  config/
    openclaw.json      # Конфиг OpenClaw (JSON5)
  docker/
    docker-compose.yml # openclaw + browser + api контейнеры
  tests/               # Автоматические и ручные тесты
  docs/                # 14 файлов документации

Версия

1.0.0 | OpenClaw 2026.4.10 | CHANGELOG.md


Author

Создан и поддерживается Романом Барминым (@Refusned).

Открыт к сотрудничеству по AI-инжинирингу, разработке агентов и автоматизации:

Try Kent in Telegram

About

Production-ready AI-ассистент в Telegram. 17+ скиллов на OpenClaw, FastAPI gateway с WebSocket, hardened Docker-деплой одной командой.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors