# [🚀观看我的哔哩哔哩视频](https://space.bilibili.com/3493277319825652)

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Français | Español | Deutsch | Italiano | Русский | Português (Brasil)

🦞ClawTeam-OpenClaw

Координация мультиагентного роя для CLI-агентов программирования — OpenClaw по умолчанию

Upstream Quick Start License

Python Agents Transport Version

> **Форк [HKUDS/ClawTeam](https://github.com/HKUDS/ClawTeam)** с глубокой интеграцией OpenClaw: агент `openclaw` по умолчанию, изоляция сессий для каждого агента, автоматическая настройка разрешений на выполнение и бэкенды порождения агентов, готовые к продакшну. Все исправления из основного репозитория синхронизируются. Вы ставите цель. Агентный рой делает всё остальное — порождает рабочих, разбивает задачи, координирует и объединяет результаты. Работает с [OpenClaw](https://openclaw.ai) (по умолчанию), [Claude Code](https://claude.ai/claude-code), [Codex](https://openai.com/codex), [nanobot](https://github.com/HKUDS/nanobot), [Cursor](https://cursor.com) и любым CLI-агентом. --- ## Почему ClawTeam? Современные ИИ-агенты мощны, но работают **изолированно**. ClawTeam позволяет агентам самоорганизовываться в команды — разделять работу, общаться и объединять результаты без ручного микроменеджмента. | | ClawTeam | Другие мультиагентные фреймворки | |---|---------|----------------------------| | **Кто использует** | Сами ИИ-агенты | Люди, пишущие код оркестрации | | **Настройка** | `pip install` + один промпт | Docker, облачные API, YAML-конфиги | | **Инфраструктура** | Файловая система + tmux | Redis, очереди сообщений, базы данных | | **Поддержка агентов** | Любой CLI-агент | Только специфичные для фреймворка | | **Изоляция** | Git worktrees (реальные ветки) | Контейнеры или виртуальные окружения | --- ## Как это работает
### Агенты порождают агентов Лидер вызывает `clawteam spawn` для создания рабочих. Каждый получает свой **git worktree**, **окно tmux** и **идентичность**. ```bash clawteam spawn --team my-team \ --agent-name worker1 \ --task "Implement auth module" ``` ### Агенты общаются между собой Рабочие проверяют входящие, обновляют задачи и сообщают результаты — всё через CLI-команды, **автоматически внедрённые** в их промпт. ```bash clawteam task list my-team --owner me clawteam inbox send my-team leader \ "Auth done. All tests passing." ``` ### Вы просто наблюдаете Отслеживайте рой через мозаичное представление tmux или веб-интерфейс. Лидер занимается координацией. ```bash clawteam board attach my-team # Or web dashboard clawteam board serve --port 8080 ```
--- ## Быстрый старт ### Вариант 1: Пусть агент ведёт (Рекомендуется) Установите ClawTeam, затем дайте промпт вашему агенту: ``` "Build a web app. Use clawteam to split the work across multiple agents." ``` Агент автоматически создаёт команду, порождает рабочих, назначает задачи и координирует — всё через CLI `clawteam`. ### Вариант 2: Управляйте вручную ```bash # Create a team clawteam team spawn-team my-team -d "Build the auth module" -n leader # Spawn workers — each gets a git worktree + tmux window clawteam spawn --team my-team --agent-name alice --task "Implement OAuth2 flow" clawteam spawn --team my-team --agent-name bob --task "Write unit tests for auth" # Watch them work clawteam board attach my-team ``` ### Поддерживаемые агенты | Агент | Команда порождения | Статус | |-------|--------------|--------| | [OpenClaw](https://openclaw.ai) | `clawteam spawn tmux openclaw --team ...` | **По умолчанию** | | [Claude Code](https://claude.ai/claude-code) | `clawteam spawn tmux claude --team ...` | Полная поддержка | | [Codex](https://openai.com/codex) | `clawteam spawn tmux codex --team ...` | Полная поддержка | | [nanobot](https://github.com/HKUDS/nanobot) | `clawteam spawn tmux nanobot --team ...` | Полная поддержка | | [Cursor](https://cursor.com) | `clawteam spawn subprocess cursor --team ...` | Экспериментально | | Пользовательские скрипты | `clawteam spawn subprocess python --team ...` | Полная поддержка | --- ## Установка ### Шаг 1: Предварительные требования ClawTeam требует **Python 3.10+**, **tmux** и хотя бы один CLI-агент для программирования (OpenClaw, Claude Code, Codex и т.д.). **Проверьте, что у вас уже установлено:** ```bash python3 --version # Need 3.10+ tmux -V # Need any version openclaw --version # Or: claude --version / codex --version ``` **Установите недостающие компоненты:** | Инструмент | macOS | Ubuntu/Debian | |------|-------|---------------| | Python 3.10+ | `brew install python@3.12` | `sudo apt update && sudo apt install python3 python3-pip` | | tmux | `brew install tmux` | `sudo apt install tmux` | | OpenClaw | `pip install openclaw` | `pip install openclaw` | > Если вы используете Claude Code или Codex вместо OpenClaw, установите их согласно их документации. OpenClaw используется по умолчанию, но не является строго обязательным. ### Шаг 2: Установка ClawTeam > **⚠️ НЕ выполняйте `pip install clawteam` или `npm install -g clawteam` напрямую:** > - `pip install clawteam` установит версию из основного репозитория PyPI, которая по умолчанию использует `claude` и не содержит адаптаций для OpenClaw. > - `npm install -g clawteam` установит постороннюю пакет-сквоттер (издатель `a9logic`). Если `clawteam --version` показывает "Coming Soon", установлен неправильный пакет. Сначала выполните `npm uninstall -g clawteam`. > > **Используйте три команды ниже — `pip install -e .` после клонирования обязателен. Он устанавливает из локального репозитория, а не из PyPI.** ```bash git clone https://github.com/win4r/ClawTeam-OpenClaw.git cd ClawTeam-OpenClaw pip install -e . # ← Обязательно! Установка из локального репозитория, НЕ то же самое что pip install clawteam ``` Опционально — P2P-транспорт (ZeroMQ): ```bash pip install -e ".[p2p]" ``` ### Шаг 3: Создание символической ссылки `~/bin/clawteam` Порождённые агенты запускаются в чистых оболочках, которые могут не иметь директорию pip в PATH. Символическая ссылка в `~/bin` гарантирует, что `clawteam` всегда доступен: ```bash mkdir -p ~/bin ln -sf "$(which clawteam)" ~/bin/clawteam ``` Если `which clawteam` ничего не возвращает, найдите бинарный файл вручную: ```bash # Common locations: # ~/.local/bin/clawteam # /opt/homebrew/bin/clawteam # /usr/local/bin/clawteam # /Library/Frameworks/Python.framework/Versions/3.*/bin/clawteam find / -name clawteam -type f 2>/dev/null | head -5 ``` Затем убедитесь, что `~/bin` включён в PATH — добавьте следующее в `~/.zshrc` или `~/.bashrc`, если ещё не добавлено: ```bash export PATH="$HOME/bin:$PATH" ``` ### Шаг 4: Установка навыка OpenClaw (только для пользователей OpenClaw) Файл навыка обучает агентов OpenClaw работе с ClawTeam через естественный язык. Пропустите этот шаг, если вы не используете OpenClaw. ```bash mkdir -p ~/.openclaw/workspace/skills/clawteam cp skills/openclaw/SKILL.md ~/.openclaw/workspace/skills/clawteam/SKILL.md ``` ### Шаг 5: Настройка разрешений на выполнение (только для пользователей OpenClaw) Порождённым агентам OpenClaw требуется разрешение на выполнение команд `clawteam`. Без этого агенты будут блокироваться на интерактивных запросах разрешений. ```bash # Ensure security mode is "allowlist" (not "full") python3 -c " import json, pathlib p = pathlib.Path.home() / '.openclaw' / 'exec-approvals.json' if p.exists(): d = json.loads(p.read_text()) d.setdefault('defaults', {})['security'] = 'allowlist' p.write_text(json.dumps(d, indent=2)) print('exec-approvals.json updated: security = allowlist') else: print('exec-approvals.json not found — run openclaw once first, then re-run this step') " # Add clawteam to the allowlist (use the absolute path — OpenClaw 4.2+ requires it) openclaw approvals allowlist add --agent "*" "$(which clawteam)" ``` > Если `openclaw approvals` не работает, шлюз OpenClaw может быть не запущен. Сначала запустите его, затем повторите попытку. ### Шаг 6: Проверка ```bash clawteam --version # Should print version clawteam config health # Should show all green ``` Если вы используете OpenClaw, также проверьте, что навык загружен: ```bash openclaw skills list | grep clawteam ``` ### Автоматический установщик Шаги 2–6, описанные выше, также доступны в виде единого скрипта: ```bash git clone https://github.com/win4r/ClawTeam-OpenClaw.git cd ClawTeam-OpenClaw bash scripts/install-openclaw.sh ``` ### Устранение неполадок | Проблема | Причина | Решение | |---------|-------|-----| | `clawteam: command not found` | Директория pip не в PATH | Выполните Шаг 3 (символическая ссылка + PATH) | | Порождённые агенты не находят `clawteam` | Агенты запускаются в чистых оболочках без PATH pip | Убедитесь, что символическая ссылка `~/bin/clawteam` существует и `~/bin` в PATH | | `openclaw approvals` не работает | Шлюз не запущен | Сначала запустите `openclaw gateway`, затем повторите Шаг 5 | | `exec-approvals.json not found` | OpenClaw ни разу не запускался | Запустите `openclaw` один раз для генерации конфигурации, затем повторите Шаг 5 | | Агенты блокируются на запросах разрешений | Режим безопасности exec approvals — "full" | Выполните Шаг 5 для переключения на "allowlist" | | `pip install -e .` не работает | Отсутствуют зависимости сборки | Сначала выполните `pip install hatchling` | | `clawteam --version` показывает "Coming Soon" | Установлен npm-пакет-сквоттер (`a9logic`, не связан с этим проектом) | `npm uninstall -g clawteam`, затем переустановить по шагу 2 | --- ## Примеры использования ### 1. Автономное исследование в области МО — 8 агентов x 8 GPU На основе [@karpathy/autoresearch](https://github.com/karpathy/autoresearch). Один промпт запускает 8 исследовательских агентов на H100, которые автономно проектируют 2000+ экспериментов. ``` Human: "Use 8 GPUs to optimize train.py. Read program.md for instructions." Leader agent: ├── Spawns 8 agents, each assigned a research direction (depth, width, LR, batch size...) ├── Each agent gets its own git worktree for isolated experiments ├── Every 30 min: checks results, cross-pollinates best configs to new agents ├── Reassigns GPUs as agents finish — fresh agents start from best known config └── Result: val_bpb 1.044 → 0.977 (6.4% improvement) across 2430 experiments in ~30 GPU-hours ``` Полные результаты: [novix-science/autoresearch](https://github.com/novix-science/autoresearch) ### 2. Агентная разработка программного обеспечения ``` Human: "Build a full-stack todo app with auth, database, and React frontend." Leader agent: ├── Creates tasks with dependency chains (API schema → auth + DB → frontend → tests) ├── Spawns 5 agents (architect, 2 backend, frontend, tester) in separate worktrees ├── Dependencies auto-resolve: architect completes → backend unblocks → tester unblocks ├── Agents coordinate via inbox: "Here's the OpenAPI spec", "Auth endpoints ready" └── Leader merges all worktrees into main when complete ``` ### 3. ИИ-хедж-фонд — запуск из шаблона TOML-шаблон порождает полноценную инвестиционную команду из 7 агентов одной командой: ```bash clawteam launch hedge-fund --team fund1 --goal "Analyze AAPL, MSFT, NVDA for Q2 2026" ``` 5 агентов-аналитиков (стоимость, рост, технический анализ, фундаментальный анализ, настроения рынка) работают параллельно. Риск-менеджер синтезирует все сигналы. Портфельный управляющий принимает итоговые решения. Шаблоны — это файлы TOML. **Создавайте собственные** для любой предметной области. --- ## Возможности
### Самоорганизация агентов - Лидер порождает рабочих и управляет ими - Автоматически внедряемый промпт координации — нулевая ручная настройка - Рабочие самостоятельно сообщают статус и состояние простоя - Любой CLI-агент может участвовать ### Изоляция рабочих пространств - Каждый агент получает свой **git worktree** - Никаких конфликтов слияния между параллельными агентами - Команды для создания контрольных точек, слияния и очистки - Именование веток: `clawteam/{team}/{agent}` ### Отслеживание задач с зависимостями - Общая канбан-доска: `pending` → `in_progress` → `completed` / `blocked` - Цепочки `--blocked-by` с автоматической разблокировкой при завершении - `task wait` блокирует выполнение до завершения всех задач ### Межагентный обмен сообщениями - Двусторонние входящие (отправка, получение, просмотр) - Широковещательная рассылка всем участникам команды - Файловый транспорт (по умолчанию) или ZeroMQ P2P ### Мониторинг и панели управления - `board show` — канбан-доска в терминале - `board live` — автообновляемая панель - `board attach` — мозаичное представление всех агентов в tmux - `board serve` — веб-интерфейс с обновлениями в реальном времени ### Шаблоны команд - TOML-файлы определяют архетипы команд (роли, задачи, промпты) - Одна команда: `clawteam launch