Двадцать вкладок Claude Code. Пять терминалов с Codex. Три сессии Cursor, из которых две зависли, а третья уже непонятно что делает. Знакомая картина?

Один агент — это ассистент. Десять — уже отдел. Двадцать — организация. И любому коллективу нужны правила: кто за какую область отвечает, сколько тратит, перед кем отчитывается, что делает при ошибке.

Paperclip — open-source платформа, которая отвечает на эти вопросы. Не конструктор агентов, а система управления командой из них: бюджеты, роли, тикеты, сердцебиение, аудит. Запустили в марте 2026 года — за три недели набрали 32 000 звёзд на GitHub.

Это не обзор. Это маршрут: от задачи, которую вы хотите решить, до команды, которая её выполнит — без хаоса из двадцати вкладок.

Что это

Paperclip — open-source платформа под лицензией MIT, которая превращает разнородных AI-агентов в полноценную организацию. Вы задаёте бизнес-цель, выстраиваете иерархию из агентов (CEO, CTO, инженеры, маркетологи), устанавливаете бюджеты — и агенты действуют автономно, координируясь через внутреннюю тикет-систему.

Стек: серверная часть на Node.js, фронтенд на React, база данных PostgreSQL встроена в инстанс и создаётся при первом запуске. 97.5% кодовой базы — TypeScript. За первые три недели с момента публикации в марте 2026 проект собрал 32 000+ звёзд, 4 500+ форков и 24 контрибьютора, выпустил три релиза.

Heartbeat (сердцебиение) — сигнал, по которому агент просыпается, проверяет очередь задач и действует. Механика позаимствована у распределённых систем: вместо постоянного опроса (polling) агент получает расписание пробуждения. Если агент может принять heartbeat — он подходит для Paperclip, независимо от того, Claude это, Codex или bash-скрипт.

Важно: Paperclip не создаёт агентов и не учит их работать. Он управляет тем, что уже существует. Вы приносите своих агентов — Paperclip даёт им компанию, в которой они работают.

Зачем нужно

Представьте команду из пятнадцати агентов: пять пишут код, три тестируют, два ведут документацию, три отвечают на тикеты поддержки, два делают маркетинговый контент. Без оркестрации каждый живёт в своём терминале. Контекст не передаётся. Бюджеты не отслеживаются. Один агент может зациклиться и сжечь $200 токенов за час, и вы узнаете об этом, когда квота уже исчерпана.

Paperclip решает шесть конкретных проблем, которые возникают при масштабировании от одного агента к команде:

Без оркестрацииС Paperclip
20 вкладок с агентами, непонятно кто что делаетЗадачи в тикетах, сессии сохраняются между перезапусками
Контекст собирается вручную из разных местКонтекст автоматически течёт от задачи к целям компании
Бесконечные циклы сжигают сотни долларовБюджетные лимиты с автоматической паузой при превышении
Повторяющиеся задачи запускаются вручнуюHeartbeats по расписанию — агенты просыпаются сами
Каждая интеграция — отдельная разработкаPlugin SDK с lifecycle, UI-слотами и event bridge
Нет аудита — неизвестно, кто что решил и почемуКаждый разговор трассируется, каждое решение объясняется

Ключевая идея: Paperclip моделирует компанию, а не конвейер. Вы не строите pipeline из блоков — вы нанимаете сотрудников, определяете их роли и даёте им бюджет. Разница такая же, как между автоматизированной линией сборки и командой разработчиков. Линия собирает детали. Команда решает задачи.

Как устроено

Paperclip — это не обёртка над агентами, а полноценный контрольный слой (control plane). Внутри работают двенадцать подсистем, каждая из которых закрывает отдельный аспект управления организацией.

Три шага запуска

Сценарий выглядит так:

  • Определить цель — например, «Построить AI-приложение для заметок с доходом $1M MRR». Цель становится миссией компании, которую видит каждый агент.
  • Нанять команду — CEO, CTO, инженеры, дизайнеры, маркетологи. Подойдёт любой рантайм, любой провайдер. Если агент принимает heartbeat — он нанят.
  • Утвердить и запустить — рассмотреть стратегию CEO, установить бюджеты, нажать «Go». Дальше агенты работают сами, вы контролируете результаты.

Под капотом

Двенадцать подсистем Paperclip:

  • Identity & Access — два режима развёртывания (доверенный локальный или с аутентификацией), пользователи-советники, API-ключи агентов, короткоживущие JWT для запусков, членства в компаниях. Каждый запрос на изменение трассируется до инициатора.
  • Org Chart & Agents — у агентов есть роли, должности, линии подчинения, разрешения и бюджеты. Адаптеры: Claude Code, Codex, Cursor/Gemini/bash, HTTP-боты вроде OpenClaw.
  • Work & Task System — тикеты несут связи с компанией, проектом, целью и родительской задачей. Атомарный checkout с блокировкой исполнения — два агента не возьмут одну задачу одновременно. Зависимости, комментарии, вложения, work products.
  • Heartbeat Execution — очередь пробуждения на базе БД с коалесценцией (объединением дубликатов), проверкой бюджета, инъекцией секретов, загрузкой навыков и вызовом адаптера. Запуски создают структурированные логи, события стоимости, состояние сессии и аудит-трейлы. Восстановление обрабатывает потерянные запуски автоматически.
  • Workspaces & Runtime — проектные рабочие пространства, изолированные execution workspaces (git worktrees, операторские ветки), runtime-сервисы (dev-серверы, preview-URL). Агент работает в правильной директории с правильным контекстом.
  • Governance & Approvals — workflow одобрения советом директоров, политики исполнения с этапами ревью, трекинг решений, жёсткие остановки по бюджету, пауза/возобновление/увольнение агента. Ничто не уходит без вашего подтверждения.
  • Budget & Cost Control — трекинг токенов и расходов по компании, агенту, проекту, цели, тикету, провайдеру и модели. При 80% бюджета — предупреждение, при 100% — автоматическая пауза. Перерасход ставит агента на паузу и отменяет очередь.
  • Routines & Schedules — повторяющиеся задачи с триггерами по cron, webhook и API. Политики конкурентности и нагона. Каждый запуск рутины создаёт тикет и будит назначенного агента — ручной запуск не нужен.
  • Plugins — плагинная система с out-of-process воркерами, capability-gated хост-сервисами, планировкой задач, расширением инструментов и UI-вкладами. Расширяйте Paperclip без форка.
  • Secrets & Storage — секреты инстанса и компании, шифрованное локальное хранилище, объектное хранилище, вложения и work products. Чувствительные значения не попадают в промпты, если конкретный запуск явно их не требует.
  • Activity & Events — изменения, heartbeat-состояния, события стоимости, одобрения, комментарии и work products записываются как durable activity. Оператор всегда может провести аудит: что произошло и почему.
  • Company Portability — экспорт и импорт организаций целиком: агенты, навыки, проекты, рутины, тикеты — с очисткой секретов и обработкой коллизий. Одна установка, множество компаний, данные изолированы.

Инсайт: Session compaction учитывает контекстные лимиты каждого адаптера. Агент не начинает с нуля после каждого heartbeat — он возобновляет контекст, сжатый под его лимиты. Это как control version для памяти агента: вы накатываете только нужный слепок, а не весь репозиторий.

Runtime Skill Injection

Навыки загружаются в рантайме через SKILLS.md-файлы — описание навыка кладётся в рабочую директорию агента перед запуском. Модель не нужно переобучать, промпт не нужно менять. Если агенту нужна инструкция по конкретному API, вы кладёте SKILLS.md — и при следующем heartbeat он следует ей.

Live run output

Поток вывода агента идёт через WebSocket — оператор видит действия в реальном времени, а не после завершения. Транскрипт рендерит Markdown, подменяет пути файловой системы и идентичности на плейсхолдеры. Наблюдаемость без утечки чувствительных данных.

Когда использовать

Paperclip подходит, если:

  • Вы координируете множество разных агентов (OpenClaw, Codex, Claude, Cursor) к общей цели
  • У вас 20 одновременно открытых терминалов с агентами, и вы теряете нить
  • Вы хотите, чтобы агенты работали автономно 24/7, но с возможностью аудита и вмешательства
  • Вам нужно контролировать расходы и следить за бюджетами
  • Вы хотите управлять автономными процессами с телефона (PWA с service worker)
  • У вас есть повторяющиеся задачи (поддержка, отчёты, контент), которые нужно запускать по расписанию

Paperclip не нужен, если у вас один агент. Один агент — это ассистент, ему не нужна оргструктура. Двадцать — точно нужна. Граница проходит где-то между пятью и десятью: когда вы перестаёте помнить, кто что делает, пора заводить компанию.

Совместимые агенты

Адаптеры в Paperclip — модульная система: каждый рантайм подключается через отдельный адаптер, который переводит heartbeat-сигнал в формат конкретного агента. Визард онбординга показывает все доступные адаптеры; Claude Code и Codex выделены как рекомендованные для быстрого старта. Если ваш агент не в списке, но может принять HTTP-вызов — используйте вебхук-адаптер.

Агент / РантаймТип интеграцииС версии
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, skill injection в ~/.gemini/v0.3.1
HermesЛокальный адаптер hermes_local для Hermes CLIv2026.318.0
Bash-скриптыПрямой запускv0.3.0
HTTP-вебхукиЛюбой внешний сервис через HTTPv0.3.0

Совет: адаптер — это модуль, который переводит heartbeat-сигнал Paperclip в формат, понятный конкретному агенту. Для Claude Code это вызов CLI с параметрами сессии. Для HTTP-вебхука — POST-запрос на ваш эндпоинт. Для bash — прямой запуск скрипта. Если ваш агент не в списке, но может принять HTTP-вызов — используйте вебхук-адаптер.

Пример

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

Для запуска нужен Node.js 20+ и pnpm 9.15+. PostgreSQL встроена в инстанс и поднимается при первом старте — отдельно ставить базу не требуется. Docker-образ собран на Node 24.

Запускает интерактивный мастер: настройка базы данных, авторизация, создание первой компании — всё в одном потоке:

npx paperclipai onboard --yes

Внимание: если вы используете приватный npm-реестр (например, GitHub Packages) через глобальный ~/.npmrc, npx может пытаться найти paperclipai в нём вместо публичного реестра. Обход: npx --registry https://registry.npmjs.org paperclipai onboard --yes. Проверить текущий реестр: npm config get registry.

По умолчанию быстрый старт запускается в доверенном локальном режиме (trusted local loopback). Для запуска в режиме с аутентификацией укажите bind-preset:

npx paperclipai onboard --yes --bind lan
# или:
npx paperclipai onboard --yes --bind tailnet

Если Paperclip уже настроен, повторный запуск onboard сохранит существующую конфигурацию. Для изменения настроек используйте paperclipai configure.

Ручная установка

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

Запускает API-сервер на http://localhost:3100 с встроенной базой данных PostgreSQL, которая создаётся автоматически.

Полезные команды

pnpm dev          # Полный dev (API + UI, watch mode)
pnpm dev:server   # Только сервер
pnpm dev:once     # Полный dev, один прогон
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

История релизов (март 2026)

v0.3.0 — 9 марта

Дебютный релиз. Команда заложила фундамент: адаптеры для Cursor, OpenCode и Pi, gateway-интеграция с OpenClaw, PWA для управления с телефона, Inbox с индивидуальным read state, мастер создания агентов, Docker-харденинг, e2e-покрытие через Playwright и рендеринг Mermaid-диаграмм в Markdown.

v0.3.1 — 12 марта

Второй релиз добавил адаптер для Gemini CLI и переработал онбординг — Claude Code и Codex получили статус рекомендуемых. Транскрипты запусков научились рендерить Markdown и маскировать пути файловой системы вместе с идентичностями. Настройки heartbeat переехали в сайдбар. Лимит ходов по умолчанию подняли до 300. Появился worktree workflow для удобства разработчиков.

v2026.318.0 — 18 марта (latest)

Крупный релиз: полноценная плагинная система с SDK — жизненный цикл в рантайме, CLI-инструменты, UI-слоты, event bridge, CRUD для документов и testing harness. Добавлен адаптер Hermes. Execution workspaces перешли в экспериментальный статус. Переработан учёт расходов и бюджетов. Тикеты получили поддержку вложений. Оптимизация heartbeat: избыточные расходы токенов отбрасываются автоматически.

Roadmap

  • ClipMart — маркетплейс шаблонов организаций: готовые команды для типовых задач (контент-агентство, трейдинг-стол, dev-студия), развёртывание в один шаг
  • Упрощение онбординга OpenClaw — снижение порога входа для gateway-адаптера
  • Улучшение документации — расширение покрытия по API и подсистемам
  • Harness engineering — поддержка кастомных сред исполнения для агентов
  • Облачные агенты (Cursor, e2b) — отгружено в v0.3.0
  • Плагинная система — отгружена в v2026.318.0

Чем Paperclip не является

Границы инструмента важно понимать до того, как вы начнёте строить:

  • Не чат-бот — агент получает задачу, а не окно для переписки. Paperclip управляет работой, не диалогами
  • Не фреймворк для агентов — не обучает созданию ботов. Задача платформы — управление организацией из готовых агентов
  • Не визуальный конструктор workflow — без drag-and-drop интерфейса. Объект моделирования — компания с ролями и бюджетами, а не конвейер
  • Не менеджер промптов — модели, промпты и рантаймы остаются на стороне агента. Paperclip отвечает за организацию вокруг них
  • Не соло-инструмент — один агент не требует оркестрации. Команда из десяти и более — уже нуждается
  • Не система код-ревью — ревью-процесс остаётся за вами. Paperclip координирует работу, а не ревьюит PR

Ограничения

Ограничения

Проекту три недели. API и функциональность меняются быстро — то, что работает сегодня, может измениться в следующем релизе.

Активное развитие — три релиза за десять дней, интерфейс и API активно меняются.

Закладывайте время на адаптацию после обновления.

Документация — растёт от релиза к релизу, но пока покрывает не все подсистемы.

Часть деталей приходится искать в исходном коде и GitHub-обсуждениях.

Только self-hosted — Облачной версии нет.

Нужно самостоятельно разворачивать и поддерживать инстанс — Node.js + PostgreSQL.

Безопасность агентов — governance на уровне организации встроен в Paperclip, но изоляция исполняемого агентом кода — ваша задача.

Песочница для агентов настраивается отдельно.

Execution workspaces — Экспериментальная фича.

Git worktrees и операторские ветки работают, но могут измениться в следующих версиях.

Антипаттерны

Антипаттерны

Типичные ошибки при работе с Paperclip — из описанных в документации и обсуждениях сообщества:

Не использовать как чат — Paperclip — не мессенджер для агентов.

Если вам нужен диалог с одним ботом, используйте сам бот. Paperclip включается, когда агентов много и нужен контроль.

Не строить drag-and-drop pipeline — Если ваша задача — визуальный конвейер данных, вам нужен n8n или Airflow, не Paperclip.

Он моделирует компанию, а не workflow-схему.

Не подключать одного агента — Один агент в Paperclip — это как нанимать CEO без сотрудников.

Оркестрация не даст ценности, но добавит накладные расходы на heartbeat и тикеты.

Не игнорировать бюджеты — Cost Control существует не для галочки.

Без жёстких лимитов агент может зациклиться и сжечь сотни долларов за один запуск. Всегда устанавливайте месячный бюджет при найме.

Чеклист

Чеклист

Перед первым запуском Paperclip-компании:

Paperclip — это не «ещё один инструмент для ИИ». Это попытка ответить на вопрос: что происходит, когда агентов становится больше, чем вы можете отслеживать вручную? Ответ: вы строите компанию. С бюджетами, ролями, аудитом и контролем. А в диалоге можно двигаться. Если захотите обсудить — @vorobeoff

Node.js 20+ и pnpm 9.15+ — Проверить версии: node —version и pnpm —version.

Docker-образ использует Node 24.

Порт 3100 свободен — API-сервер запускается на localhost:3100.

Убедитесь, что порт не занят другим процессом.

Цель компании сформулирована — Одно предложение, измеримый результат — например «MRR $1M» или «5000 активных пользователей».

Без цели агенты не получат goal alignment.

Бюджеты назначены каждому агенту — Месячный лимит в долларах.

Без бюджета Cost Control не сработает — агент может сжечь всю квоту.

Адаптер агента настроен — Выбран в визарде, проверен heartbeat-запуск.

Для Claude Code и Codex — рекомендуемые адаптеры, для остальных — по документации.

Governance gates включены — Approval gates для найма и стратегических решений.

Без них агент может нанять другого агента или изменить конфигурацию без вашего ведома.

Режим развёртывания выбран — Trusted local (по умолчанию) для локальной разработки.

Authenticated — для production и доступа извне.

Ссылки

Ссылки

По теме

По теме