Архитектура Clawdbot

Обзор архитектуры Clawdbot

Clawdbot следует архитектуре Gateway-Agent, которая разделяет ответственность между транспортировкой сообщений и обработкой ИИ. Такой дизайн обеспечивает масштабируемость, надёжность и поддержку нескольких каналов.

Компоненты системы

Уровень шлюза

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

Уровень агентов

Агенты Clawdbot обрабатывают ИИ:

Поток сообщений

Входящий поток

Provider → Gateway → Router → Agent → Runtime

1. Провайдер получает сообщение
2. Шлюз нормализует формат
3. Маршрутизатор выбирает целевого агента
4. Агент обрабатывает сообщение
5. Runtime генерирует ответ

Исходящий поток

Runtime → Agent → Gateway → Provider → User

1. Runtime генерирует ответ
2. Агент форматирует сообщение
3. Шлюз направляет к провайдеру
4. Провайдер доставляет сообщение

WebSocket API

Подключение

const ws = new WebSocket('ws://localhost:3010');

ws.on('open', () => {
  ws.send(JSON.stringify({
    type: 'auth',
    token: 'your-token'
  }));
});

Типы сообщений

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

Состояние сессии

Clawdbot поддерживает состояние на нескольких уровнях:

Global State
  └── Agent State
        └── Session State
              └── Message State

Сохранение состояния

Масштабируемость

Горизонтальное масштабирование

Clawdbot поддерживает горизонтальное масштабирование:

• Несколько экземпляров шлюза за балансировщиком нагрузки
• Общее хранилище сессий для согласованности
• Обработка сообщений без сохранения состояния

Лимиты ресурсов

Модель безопасности

Аутентификация

• Аутентификация по API-ключу
• Аутентификация WebSocket на основе токена
• Учётные данные для каждого провайдера

Авторизация

• Разрешения на уровне инструмента
• Изоляция на уровне агента
• Контроль доступа на уровне сессии

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

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