Основные концепции для понимания архитектуры ИИ-ассистента Clawdbot, сессий, многоагентной маршрутизации и обработки сообщений.

Обзор концепций Clawdbot

Понимание основных концепций Clawdbot поможет вам эффективно настроить и использовать ИИ-ассистента. В этом разделе рассматриваются фундаментальные строительные блоки Clawdbot.

Ключевые концепции

Архитектура шлюза

Шлюз — это центральный демон, который:

Поддерживает все соединения с мессенджерами
Предоставляет типизированный WebSocket API
Управляет runtime агентов и сессиями
Обрабатывает маршрутизацию сообщений

Узнать больше об архитектуре шлюза

Сессии

Clawdbot рассматривает одну сессию прямого чата на агента как основную:

Прямые чаты сворачиваются в agent:<agentId>:<mainKey>
Групповые/канальные чаты получают собственные ключи
Состояние сессии принадлежит шлюзу

Многоагентная маршрутизация

Запускайте несколько изолированных агентов с отдельными:

Рабочими пространствами (файлы, правила персоны)
Директориями состояния
Хранилищами сессий
Профилями аутентификации

Runtime агента

Runtime агента обрабатывает:

Обработку сообщений
Выполнение инструментов
Управление контекстом
Генерацию ответов

Управление сессиями

Параметры области ЛС

Область	Описание
`main` (по умолчанию)	Все ЛС делят основную сессию
`per-peer`	Изоляция по ID отправителя между каналами
`per-channel-peer`	Изоляция по каналу + отправителю
`per-account-channel-peer`	Изоляция по аккаунту + каналу + отправителю

Ключи сессий

Источник	Формат ключа
Прямые чаты	`agent:<agentId>:<mainKey>`
Групповые чаты	`agent:<agentId>:<channel>:group:<id>`
Cron-задачи	`cron:<job.id>`
Webhooks	`hook:<uuid>`

Жизненный цикл сессии

Сессии переиспользуются до истечения срока
Ежедневный сброс по умолчанию в 4:00 по местному времени
Опциональный сброс при бездействии через idleMinutes

Настройка нескольких агентов

Что такое агент?

Агент — это полностью изолированный мозг с:

Рабочим пространством: файлы, AGENTS.md, SOUL.md, правила персоны
Директорией состояния: профили аутентификации, реестр моделей
Хранилищем сессий: история чата + состояние маршрутизации
Навыками: для каждого агента через папку skills/ рабочего пространства

Режим одного агента (по умолчанию)

agentId по умолчанию main
Ключи сессий agent:main:<mainKey>
Рабочее пространство в ~/.clawdbot/workspace

Добавление агентов

# Добавить нового агента
clawdbot agents add work

# Список агентов с привязками
clawdbot agents list --bindings

Правила маршрутизации

Сообщения направляются к агентам через привязки:

{
  "bindings": [
    {
      "agentId": "alex",
      "match": {
        "channel": "whatsapp",
        "peer": { "kind": "dm", "id": "+15551230001" }
      }
    }
  ]
}

Обработка сообщений

Потоковая передача и разбиение

Clawdbot поддерживает потоковые ответы:

Частичные обновления сообщений
Индикаторы набора текста
Разбиение на части для длинных ответов

Политика повторов

Неудачные сообщения повторяются с:

Экспоненциальной задержкой
Настраиваемыми лимитами повторов
Обработкой ошибок

Где хранится состояние

Элемент	Расположение
Конфигурация	`~/.clawdbot/clawdbot.json`
Сессии	`~/.clawdbot/agents/<agentId>/sessions/`
Транскрипты	`~/.clawdbot/agents/<agentId>/sessions/<SessionId>.jsonl`
Профили аутентификации	`~/.clawdbot/agents/<agentId>/agent/auth-profiles.json`

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

Шлюз Clawdbot - Настройка шлюза
Инструменты Clawdbot - Настройка инструментов
Каналы Clawdbot - Настройка каналов

Концепции Clawdbot