База знаний

Paperclip — оркестрация команд AI-агентов как автономной компании

Open-source платформа для управления командами AI-агентов через оргструктуры, бюджеты, тикеты и governance. 32 000+ звёзд на GitHub, плагинная система, 10+ совместимых агентов. Не фреймворк для агентов, а система управления организацией из агентов.

Опубликовано Обновлено

Когда у вас один ИИ-агент — это ассистент. Когда их двадцать — это уже компания. И ей нужно управление: кто за что отвечает, сколько тратит, кому отчитывается. Paperclip — open-source платформа, которая решает именно эту задачу.

Это не очередной фреймворк для создания агентов. Это система управления организацией, состоящей из агентов.

📌
Масштаб проекта (март 2026): 32 000+ звёзд на GitHub, 4 500+ форков, 24+ контрибьюторов, 3 релиза за март. Один из самых быстрорастущих open-source проектов в категории AI-оркестрации.

Что это такое

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. Определите цель — например, «Построить #1 AI-приложение для заметок с MRR $1M»
  2. Наймите команду — CEO, CTO, инженеры, дизайнеры, маркетологи. Любой бот, любой провайдер
  3. Утвердите и запустите — рассмотрите стратегию 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-сигнал.

Агент / РантаймТип интеграцииС версии
OpenClawGateway-адаптер (SSE-стриминг, device-key pairing, invite-онбординг)v0.3.0
Claude CodeРекомендуемый адаптер, сессии и heartbeatsv0.3.0
OpenAI CodexРекомендуемый адаптерv0.3.0
CursorFirst-class адаптер: model discovery, run-log streaming, skill injectionv0.3.0
OpenCodeFirst-class адаптер: model discovery, run-log streaming, skill injectionv0.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 CLIv2026.318.0
Bash-скриптыПрямой запускv0.3.0
HTTP-вебхукиЛюбой внешний сервис через HTTPv0.3.0

Все адаптеры появляются в онбординг-визарде. Claude Code и Codex отображаются как рекомендуемые.


Установка

💡
Требования: Node.js 20+, pnpm 9.15+. Встроенная PostgreSQL создаётся автоматически — отдельная настройка БД не нужна. Docker-образ использует Node 24.

Быстрый старт (одна команда)

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 — пока экспериментальная фича

Ссылки


По теме

Если вы управляете несколькими ИИ-агентами и чувствуете, что это превращается в хаос — разберём, как выстроить оркестрацию.