Paperclip — open-source инструмент для оркестрации команд AI-агентов. Не один ассистент, а целая организация: с ролями, бюджетами, аудитом и структурой подчинения.
База знаний
Paperclip — оркестрация команд AI-агентов как автономной компании
Open-source платформа для управления командами AI-агентов через оргструктуры, бюджеты, тикеты и governance. 32 000+ звёзд на GitHub, плагинная система, 10+ совместимых агентов. Не фреймворк для агентов, а система управления организацией из агентов.
Когда у вас один ИИ-агент — это ассистент. Когда их двадцать — это уже компания. И ей нужно управление: кто за что отвечает, сколько тратит, кому отчитывается. Paperclip — open-source платформа, которая решает именно эту задачу.
Это не очередной фреймворк для создания агентов. Это система управления организацией, состоящей из агентов.
Что это такое
Paperclip — open-source платформа (MIT-лицензия), которая позволяет собрать из разных AI-агентов полноценную «автономную компанию». Вы определяете бизнес-цель, выстраиваете оргструктуру из агентов (CEO, CTO, маркетологи, инженеры), задаёте бюджеты — и агенты работают самостоятельно, координируясь через систему тикетов.
Технический стек: Node.js (сервер) + React (UI) + встроенный PostgreSQL. Написан на TypeScript (97.5% кодовой базы). Проект запущен в марте 2026 года и за три недели набрал 32 000+ звёзд.
Ключевые возможности
- Bring Your Own Agent — подключайте любых агентов: OpenClaw, Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Pi, Hermes и другие. Если агент может принять heartbeat-сигнал — он нанят
- Goal Alignment — каждая задача несёт полную цепочку целей: от тикета через проект до миссии компании. Агент всегда знает что делать и зачем
- Heartbeats — агенты просыпаются по расписанию, проверяют задачи и действуют. Делегирование идёт вверх и вниз по оргструктуре автоматически. Оптимизация: redundant token usage пропускается
- Cost Control — месячный бюджет на каждого агента. При 80% — предупреждение, при 100% — автоматическая пауза. Трекинг расходов через отдельный
costService - Multi-Company — один инстанс, много компаний. Полная изоляция данных. Логотипы компаний с SVG-санитизацией
- Ticket System — каждый разговор трассируется, каждое решение объясняется. Полный аудит. Поддержка inline-документов, вложений, permalink-якорей на комментариях
- Governance — вы — совет директоров. Одобряете найм, утверждаете стратегии, можете приостановить любого агента. Approval gates обязательны, изменения конфигурации версионируются, можно безопасно откатить
- Org Chart — иерархии, роли, линии подчинения. Wizard для создания агентов, человекочитаемые названия ролей
- Plugin System (новое) — полноценная плагинная система с SDK, lifecycle-менеджментом, CLI-тулингом, UI-слотами и event bridge. Можно расширять функциональность без изменения ядра
- PWA — устанавливается как приложение, service worker с network-first стратегией. Управляйте автономными бизнесами с телефона
- Inbox — отслеживание прочитанных/непрочитанных тикетов per-user, badge-индикаторы в браузере, join-реквесты и approval-уведомления
Как это работает
Три шага:
- Определите цель — например, «Построить #1 AI-приложение для заметок с MRR $1M»
- Наймите команду — CEO, CTO, инженеры, дизайнеры, маркетологи. Любой бот, любой провайдер
- Утвердите и запустите — рассмотрите стратегию CEO, установите бюджеты, нажмите «Go»
Под капотом работают важные механизмы:
- Атомарное выполнение — нет двойной работы и неконтролируемых расходов
- Персистентное состояние — агенты возобновляют контекст между heartbeats, а не начинают с нуля. Session compaction учитывает контекстные лимиты каждого адаптера
- Runtime Skill Injection — агенты получают навыки в рантайме через
SKILLS.mdбез переобучения - Execution Workspaces (экспериментально) — изолированные рабочие пространства для запусков агентов с дедупликацией и управлением артефактами
- Goal-aware execution — каждая задача несёт полное «дерево целей»
- Портативные шаблоны — экспорт/импорт оргструктур, агентов и навыков с автоматической очисткой секретов
- Live run output — вывод агентов стримится через WebSocket в реальном времени
Какие проблемы решает
| Без Paperclip | С Paperclip |
| 20 вкладок с агентами, непонятно кто что делает | Задачи в тикетах, сессии сохраняются |
| Вручную собираете контекст из разных мест | Контекст автоматически течёт от задачи к целям компании |
| Бесконечные циклы сжигают сотни долларов токенов | Бюджетные лимиты, автоматическая пауза |
| Повторяющиеся задачи надо запускать вручную | Heartbeats по расписанию |
| Каждый плагин и интеграция — отдельная разработка | Plugin SDK с lifecycle, слотами и event bridge |
Совместимые агенты
Paperclip не привязан к конкретному агенту — он работает с любым рантаймом, который может принять heartbeat-сигнал.
| Агент / Рантайм | Тип интеграции | С версии |
| OpenClaw | Gateway-адаптер (SSE-стриминг, device-key pairing, invite-онбординг) | v0.3.0 |
| Claude Code | Рекомендуемый адаптер, сессии и heartbeats | v0.3.0 |
| OpenAI Codex | Рекомендуемый адаптер | v0.3.0 |
| Cursor | First-class адаптер: model discovery, run-log streaming, skill injection | v0.3.0 |
| OpenCode | First-class адаптер: model discovery, run-log streaming, skill injection | v0.3.0 |
| Pi | Локальный RPC-режим с трекингом расходов | v0.3.0 |
| Gemini CLI | Полный локальный адаптер: API-key detection, sandbox/approval mode, skill injection в ~/.gemini/ | v0.3.1 |
| Hermes | Локальный адаптер hermes_local для Hermes CLI | v2026.318.0 |
| Bash-скрипты | Прямой запуск | v0.3.0 |
| HTTP-вебхуки | Любой внешний сервис через HTTP | v0.3.0 |
Все адаптеры появляются в онбординг-визарде. Claude Code и Codex отображаются как рекомендуемые.
Установка
Быстрый старт (одна команда)
npx paperclipai onboard --yesИнтерактивный мастер проведёт через настройку базы данных, авторизации и создание первой компании.
Ручная установка
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm devПолезные команды
pnpm dev # Полный dev (API + UI)
pnpm dev:server # Только сервер
pnpm build # Сборка
pnpm typecheck # Проверка типов
pnpm test:run # Тесты
pnpm db:generate # Генерация миграции БД
pnpm db:migrate # Применение миграций
pnpm db:backup # Бэкап базы данныхDocker
# Docker Compose с аутентификацией по умолчанию
# Поддержка PAPERCLIP_PUBLIC_URL и PAPERCLIP_ALLOWED_HOSTNAMES
docker compose upЧем Paperclip НЕ является
Важно понимать границы:
- Не чат-бот — у агентов есть работа, а не окно чата
- Не фреймворк для агентов — не учит создавать агентов, а учит управлять компанией из них
- Не визуальный конструктор workflow — никаких drag-and-drop. Моделирует компании с оргструктурами и бюджетами
- Не менеджер промптов — агенты приносят свои промпты, модели и рантаймы. Paperclip управляет организацией
- Не инструмент для одного агента — это для команд. Один агент — Paperclip не нужен. Двадцать — точно нужен
- Не инструмент код-ревью — Paperclip оркестрирует работу, а не pull-реквесты
История релизов (март 2026)
v0.3.0 — 9 марта
Первый публичный релиз. Адаптеры Cursor, OpenCode, Pi. OpenClaw gateway. PWA. Inbox с per-user read state. Agent creation wizard. Docker-хардинг. Playwright e2e-тесты. Mermaid-диаграммы в Markdown.
v0.3.1 — 12 марта
Адаптер Gemini CLI. Улучшенный онбординг (Claude Code и Codex как рекомендуемые). Run transcript рендерит Markdown, скрывает пути и идентичности. Настройки heartbeat в сайдбаре. Max turns по умолчанию поднят до 300. Worktree workflow для разработчиков.
v2026.318.0 — 18 марта (latest)
Плагинная система с SDK — runtime lifecycle, CLI, UI-слоты, event bridge, document CRUD, testing harness. Адаптер Hermes. Execution workspaces (экспериментально). Улучшенные расходы и бюджеты. Issue documents с вложениями. Heartbeat token optimization.
Roadmap
- ⚪ ClipMart — маркетплейс готовых «компаний из агентов». Скачал шаблон (контент-агентство, трейдинг-деск, dev-студия) → запустил в один клик
- ⚪ Упрощение онбординга OpenClaw
- ⚪ Улучшение документации
- ⚪ Улучшенная поддержка harness engineering
- ✅
Поддержка облачных агентов (Cursor, e2b)— Cursor добавлен в v0.3.0 - ✅
Плагинная система— отгружена в v2026.318.0
Ограничения
- Активное развитие — 3 релиза за 10 дней, API и функциональность меняются быстро
- Документация — улучшается с каждым релизом, но покрытие пока неполное
- Только self-hosted — нет облачной версии. Нужно самостоятельно разворачивать
- Безопасность агентов — ваша ответственность — Paperclip управляет governance на уровне организации, но песочница для самих агентов — на вас
- Execution workspaces — пока экспериментальная фича
Ссылки
По теме
- Статья: 9 принципов настройки ИИ-агента, который не раздражает
- Блог: Люди + агенты в одном чате: как мы собрали рабочий контур в Telegram
- База знаний: Action-Based Workflow Engine: архитектурный паттерн
Если вы управляете несколькими ИИ-агентами и чувствуете, что это превращается в хаос — разберём, как выстроить оркестрацию.