Clawmatic

Концепции

Основные концепции платформы Clawmatic: агенты, шаблоны, SOUL.md, тарифы, токены и хранилище

Основные понятия

Прежде чем погружаться в настройку, полезно разобраться в ключевых концепциях платформы Clawmatic.

Агенты

Агент — это развёрнутый экземпляр AI-бота, привязанный к вашему Telegram-боту. Каждый агент:

  • Работает в изолированном Docker-контейнере — независимо от других агентов
  • Имеет собственную базу данных — PostgreSQL-схему для хранения данных
  • Подключён к LLM-провайдеру — через виртуальный ключ LiteLLM
  • Управляется через SOUL.md — конфигурационный файл, определяющий поведение

В рамках одного тарифа вы можете запустить несколько агентов для разных задач.

Шаблоны

Шаблоны — это предварительно настроенные конфигурации агентов для типовых бизнес-сценариев. Каждый шаблон включает:

  • SOUL.md — промпт с описанием роли, навыков и правил поведения
  • Рекомендованную модель — подобранная LLM для данного типа задач
  • Набор навыков — предустановленные возможности агента

Доступные шаблоны

| Шаблон | Описание | Использование | |--------|----------|---------------| | Поддержка | Ответы на вопросы, работа с FAQ | Техподдержка, консультации | | Продажи | Каталог товаров, помощь с выбором | Интернет-магазины, услуги | | HR | Приём откликов, скрининг кандидатов | Подбор персонала |

Вы можете использовать шаблон как есть или адаптировать его под свои потребности.

SOUL.md

SOUL.md — это файл в формате Markdown, который определяет «личность» и поведение агента. Он включает:

Секции SOUL.md

  • Роль — кто такой агент, какую задачу выполняет
  • Контекст — информация о компании, продуктах, услугах
  • Правила — что агент должен и не должен делать
  • Тон — стиль общения (формальный, дружелюбный, нейтральный)
  • Навыки — что агент умеет делать (работа с данными, поиск и т.д.)

Пример

# Роль
Ты — AI-ассистент компании "ТехноМагазин".
Помогаешь клиентам с выбором электроники.

# Контекст
- Магазин работает с 10:00 до 22:00
- Доставка по Москве — бесплатно при заказе от 5000 руб
- Возврат в течение 14 дней

# Правила
- Отвечай только на вопросы о товарах и услугах
- Не обсуждай конкурентов
- При сложных вопросах — предложи связаться с оператором

Подробнее о формате в разделе конфигурация SOUL.md.

Тарифные планы

Clawmatic предлагает три тарифа, рассчитанных на разные потребности:

Free (Бесплатный)

  • 1 агент
  • 3 таблицы в хранилище
  • Базовый лимит токенов
  • Подходит для тестирования

Pro

  • До 5 агентов
  • 20 таблиц на агента
  • Увеличенный лимит токенов
  • Приоритетная поддержка

Business

  • Неограниченное количество агентов
  • Неограниченное хранилище
  • Максимальный лимит токенов
  • Выделенная поддержка
  • SLA

Оплата через ЮKassa (карты, СБП). Подробнее на странице тарифов.

Токены

Токены — единицы измерения использования LLM. Каждое сообщение, отправленное агенту и полученное в ответ, потребляет определённое количество токенов. Один токен примерно равен 4 символам на английском или 1-2 символам на русском языке.

Использование токенов отслеживается в реальном времени и доступно в личном кабинете. При приближении к лимиту система отправит уведомление.

Хранилище данных

Каждый агент получает изолированную PostgreSQL-схему — собственное пространство в базе данных. Агент может:

  • Создавать таблицы для хранения данных
  • Выполнять SQL-запросы (INSERT, SELECT, UPDATE, DELETE)
  • Хранить информацию о клиентах, заказах, обращениях

Объём хранилища зависит от тарифа. Использование отслеживается автоматически и отображается в дашборде.

Подробнее о работе с хранилищем — в разделе хранилище данных.

Следующие шаги

Теперь, когда вы знакомы с основными концепциями, переходите к практике: