ClawSwarm
The-Swarm-Corporation/ClawSwarmClawSwarm — лёгкая мультиагентная система на базе Swarms framework с поддержкой Claude. Единый API для Telegram, Discord и WhatsApp, иерархическая архитектура агентов, компиляция в Rust. Подходит для разработчиков AI-ботов и автоматизации мессенджеров.
Установка
pip install -U claw-swarmREADME
ClawSwarm
ClawSwarm — мультиагентная операционная система персональной продуктивности, работающая на базе сотен агентов и предназначенная для повышения эффективности работы.
Требования
- Python 3.10+
- Зависимости из
requirements.txt(без фиксации версий; используйте venv и фиксируйте версии локально при необходимости) - Фреймворк Swarms и экосистема Swarms; Claude Code (для инструмента Claude)
- Учётные данные платформ для подключаемых каналов: токен Telegram-бота, токен Discord-бота и ID каналов, и/или учётные данные WhatsApp Cloud API
Установка
pip3 install -U claw-swarm
Переменные окружения
Задайте их в оболочке или в файле .env (например, --env-file .env при использовании Docker). Чтобы отключить канал, просто не указывайте его учётные данные.
| Переменная | Назначение | По умолчанию |
|---|---|---|
| Gateway | ||
GATEWAY_HOST | Адрес привязки (gateway) или хост gateway (агент) | [::] (сервер), localhost (агент) |
GATEWAY_PORT | gRPC-порт | 50051 |
GATEWAY_TLS | Включить TLS: 1, true или yes | - |
GATEWAY_TLS_CERT_FILE | Путь к файлу TLS-сертификата | - |
GATEWAY_TLS_KEY_FILE | Путь к файлу приватного ключа TLS | - |
| Каналы | ||
TELEGRAM_BOT_TOKEN | Токен Telegram Bot API | - |
DISCORD_BOT_TOKEN | Токен Discord-бота | - |
DISCORD_CHANNEL_IDS | ID каналов Discord через запятую | - |
WHATSAPP_ACCESS_TOKEN | Токен доступа WhatsApp Cloud API | - |
WHATSAPP_PHONE_NUMBER_ID | ID номера телефона WhatsApp Cloud API | - |
WHATSAPP_QUEUE_PATH | Необязательный путь к очереди WhatsApp | - |
| Агент | ||
AGENT_MODEL | Модель директора Swarms / агента по умолчанию | gpt-4o-mini |
WORKER_MODEL_NAME | Модель рабочих агентов (Response/Search/TokenLaunch/Developer). Если задана, переопределяет AGENT_MODEL для воркеров. | - (fallback на AGENT_MODEL, затем gpt-4o-mini) |
OPENAI_API_KEY | Ключ OpenAI API (для модели агента) | - |
ANTHROPIC_API_KEY | Ключ Anthropic API (для инструмента Claude) | - |
| Память | ||
AGENT_MEMORY_FILE | Имя markdown-файла памяти агента (корень проекта) | agent_memory.md |
AGENT_MEMORY_MAX_CHARS | Максимальное количество символов памяти, загружаемых в контекст | 100000 |
Быстрый старт
1. Установка:
pip install -U claw-swarm
2. Создайте конфигурацию — запустите интерактивный мастер для генерации claw_config.yaml:
clawswarm onboarding
Нажмите Enter для принятия значений по умолчанию. Команда создаст claw_config.yaml в корне проекта с настройками хоста/порта/TLS gateway, порта и ключа HTTP API, имени агента, модели воркера и режима подробного вывода.
3. Задайте секреты — скопируйте .env.example в .env и заполните учётные данные:
cp .env.example .env
# затем отредактируйте .env, указав токены и ключи API4. Запустите полный стек:
clawswarm run # gateway + агент (только платформы для обмена сообщениями)
clawswarm run --api # + публичный REST API на настроенном портуОбзор
ClawSwarm — упрощённая мультиагентная альтернатива OpenClaw. Система обеспечивает нативно мультиагентный AI, отвечающий пользователям в Telegram, Discord и WhatsApp через централизованный Messaging Gateway. Gateway нормализует входящие сообщения; агент ClawSwarm (фреймворк Swarms, настраиваемый системный промпт, Claude как инструмент) обрабатывает каждое сообщение и отправляет ответ через Replier обратно в исходный канал. Построен на экосистеме Swarms для надёжности, безопасности и минимальных операционных затрат — с возможностью компиляции в Rust для повышения производительности и гибкости развёртывания.
Возможности
| Возможность | Описание |
|---|---|
| Мультиканальный обмен сообщениями | Единый API для Telegram, Discord и WhatsApp. Gateway нормализует сообщения; агент отвечает в нужный канал. |
| Иерархическая мультиагентная архитектура | Агент-директор (ClawSwarm) получает каждое сообщение, составляет план и делегирует задачи специализированным рабочим агентам через структурированные задания (SwarmSpec). Воркеры обрабатывают ответы, поиск, запуск токенов или код; директор оркестрирует процесс, а Telegram Summarizer преобразует итоговый вывод в лаконичный ответ без эмодзи для чата. |
| Специализированные воркеры | ClawSwarm-Response (приветствия, короткие ответы), ClawSwarm-Search (веб/семантический поиск через Exa), ClawSwarm-TokenLaunch (запуск токенов и получение комиссий на Swarms World/Solana), ClawSwarm-Developer (реализация кода с помощью Claude Code) |