🐍 ClaudeClaw BANDA

Мультиагентная команда на Claude Code. Установи за 10 минут — получи 5 AI-агентов в Telegram.

Canonical source / источник

This project is maintained by Aleksei Ulianov / Sprut_AI.
Original repository: https://github.com/AlekseiUL/claudeclaw-BANDA

If you found this project mirrored, repackaged, or redistributed elsewhere, check this repository as the source of truth.

Attribution / атрибуция

Where permitted by the applicable license, if you reuse, fork, modify, package, or publish this work, keep the original copyright and license notice and link back to the canonical repository.

Что это

Готовая команда AI-агентов, каждый со своим характером, специализацией и Telegram-ботом. Работает на ClaudeClaw — обёртке вокруг Claude Code CLI.

Не чат-бот. Каждый агент запускает настоящий claude CLI на твоём Mac/Linux и отправляет результат в Telegram. Все твои файлы, скиллы и инструменты — доступны с телефона.

Команда

Архитектура по стоимости:

• Opus — для сложных задач (координация, код)
• Sonnet — для средних (маркетинг, проверки)
• Haiku — для рутины (быстро и дёшево)

Что нужно

Установка за 10 минут

1. Создай Telegram-ботов

Открой @BotFather и создай ботов (по одному на агента):

Сохрани токены — понадобятся через минуту.

2. Клонируй и установи

git clone https://github.com/AlekseiUL/claudeclaw-BANDA.git
cd claudeclaw-BANDA
npm install

3. Настрой ключи

cp .env.example .env

Открой .env и заполни:

TELEGRAM_BOT_TOKEN=твой_токен_Начо
ALLOWED_CHAT_ID=твой_telegram_id
TUCO_BOT_TOKEN=токен_Туко
LALO_BOT_TOKEN=токен_Лало
GALE_BOT_TOKEN=токен_Гейла
KIM_BOT_TOKEN=токен_Ким

Свой Telegram ID: напиши @userinfobot в Telegram.

4. Залогинься в Claude

claude login

5. Запусти

npm run build
npm start              # запуск Начо (главный)
npm run agent:start tuco   # запуск Туко
npm run agent:start lalo   # запуск Лало
npm run agent:start gale   # запуск Гейла
npm run agent:start kim    # запуск Ким

6. Проверь

Напиши каждому боту в Telegram. Если отвечают — всё работает.

npm run status         # проверка здоровья системы

Или пусть Claude сам поставит

git clone https://github.com/AlekseiUL/claudeclaw-BANDA.git
cd claudeclaw-BANDA
claude

И скажи:

Прочитай README.md и .env.example. Помоги мне настроить проект — установи зависимости, помоги заполнить .env, проверь что всё работает.

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

claudeclaw-BANDA/
├── agents/           # Агенты (характер, роль, скиллы)
│   ├── tuco/         # Туко Саламанка
│   ├── lalo/         # Лало Саламанка
│   ├── gale/         # Гейл Беттикер
│   ├── kim/          # Ким Уэксслер
│   └── _template/    # Шаблон для нового агента
├── skills/           # Скиллы (навыки агентов)
├── scripts/          # Утилиты и скрипты
├── src/              # Исходный код ClaudeClaw
├── store/            # БД и runtime (создаётся автоматически)
├── workspace/        # Рабочая папка агентов
├── .claudeclaw/      # Конфиг и память Начо
├── .env.example      # Шаблон ключей
└── package.json

Как добавить своего агента

npm run agent:create

Или вручную: скопируй agents/_template/, заполни agent.yaml и CLAUDE.md.

Память и Hive Mind

Все агенты делят одну SQLite базу (store/claudeclaw.db). Это не 5 отдельных ботов — это команда с общей памятью.

Как устроена память

3 слоя поиска:

1. Vector search — семантический поиск по смыслу (OpenAI embeddings)
2. FTS5 keyword — полнотекстовый поиск (fallback если нет API ключа)
3. High-importance — недавние важные воспоминания

Hive Mind — общая доска действий:

• Каждый агент записывает что сделал (agent_id, action, summary)
• Другие агенты видят историю команды
• Координатор (Начо) видит всё

Consolidation — автосжатие:

• Старые воспоминания сжимаются в инсайты
• Память не растёт бесконечно

Разделение по agent_id:

• Каждый агент пишет со своим agent_id
• При поиске видит и свои, и общие записи
• Никто не перезаписывает чужое

OpenAI API ключ (для embeddings)

Для полноценной векторной памяти нужен OPENAI_API_KEY в .env. Без него память работает через keyword search — проще, но менее точно.

Получить: platform.openai.com → API keys. Стоимость: ~$0.02 за 1M токенов (практически бесплатно).

Обновление

git pull
npm install
npm run build

FAQ

Нужен ли API ключ Anthropic?
Нет. Если у тебя Claude Max — используется твоя подписка через claude login.

Можно ли запустить только Начо без субагентов?
Да. npm start запускает только главного. Остальные — по желанию.

Что если я на Free плане Claude?
Работать будет, но сложные задачи (код, мультиагент) лучше на Opus (Max план).

Работает на Windows?
Через WSL2 — да.

Ссылки

• 📺 YouTube: https://youtube.com/@alekseiulianov
• 📱 Telegram-канал Sprut AI: https://t.me/Sprut_AI
• 💬 Чат Telegram-канала Sprut AI: https://t.me/+eH-qNIDmud8zNDZi
• AI Операционка: https://t.me/tribute/app?startapp=sJyg
• 🔧 Основа: ClaudeClaw

Лицензия

License review pending. This repository is maintained by Aleksei Ulianov / Sprut_AI, but it includes material based on ClaudeClaw (https://github.com/earlyaidopters/claudeclaw), where no GitHub license was detected during this cleanup pass. Do not remove upstream attribution.

"I'm not like them. I never was." — Начо Варгас