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

Paperclip — open-source платформа, которая превращает разрозненных ИИ-агентов в управляемую организацию: с оргструктурой, ролями, бюджетами, тикетами и обязательными согласованиями. Руководство описывает версию v2026.722.0 от 22 июля 2026 года.

Что это такое

Paperclip — сервер на Node.js с интерфейсом на React, который координирует команду ИИ-агентов, работающих над целями компании. Вы подключаете своих агентов (Claude Code, Codex, Cursor, OpenClaw и другие), задаёте оргструктуру, цели и бюджеты, а платформа берёт на себя постановку задач, расписание запусков, учёт расходов, согласования и аудит.

Формулировка авторов проекта: если OpenClaw — сотрудник, то Paperclip — компания.

Базовые характеристики на 28 июля 2026:

Четыре опоры платформы

Авторы описывают продукт через четыре слоя. Это удобная карта, чтобы понять, что вы получаете из коробки.

Как устроен рабочий цикл

1. Вы формулируете цель компании и создаёте проекты.
2. Нанимаете агентов: у каждого есть роль, руководитель, права, модель, бюджет и рабочее пространство.
3. Задачи ставятся тикетами. Тикет несёт всю цепочку целей, поэтому агент видит не только формулировку, но и её смысл.
4. Агент просыпается по heartbeat (расписанию) либо по событию: назначение задачи или упоминание через @.
5. При запуске платформа проверяет бюджет, подбирает рабочее пространство, подставляет секреты, загружает скиллы и вызывает адаптер.
6. Прогон оставляет структурированные логи, события расходов, состояние сессии и запись в журнале аудита.

Важные механики, которые редко реализуют самостоятельно:

• Атомарный захват задачи. Проверка бюджета и checkout тикета выполняются атомарно, поэтому нет двойной работы и неконтролируемых трат.
• Устойчивые прогоны. Восстановление после сбоя маршрутизируется по причине падения, учитывает сброс квоты провайдера и подавляет повторяющиеся перезапуски.
• Дедупликация пробуждений. Повторные wake-события подавляются, а контракт исполнения подставляется один раз за heartbeat — это заметно экономит токены.
• Портируемость компаний. Оргструктуру, агентов, скиллы, рутины и задачи можно выгрузить и импортировать с вычисткой секретов.

Что входит в control plane

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

Paperclip не привязан к конкретному агенту: подойдёт любой рантайм, который принимает heartbeat.

Два изменения, которые стоит учитывать при обновлении:

• С v2026.720.0 локальные кодинг-адаптеры по умолчанию работают через движок ACP, а сами процессы дополнительно изолируются.
• С v2026.722.0 локальные агенты запускаются нативно в Windows: команды больше не оборачиваются в сгенерированный bash-скрипт, а npm- и pnpm-шимы .cmd выбираются автоматически.

Установка и первый запуск

Быстрый старт

npx paperclipai onboard --yes

Интерактивный мастер настроит базу, авторизацию и первую компанию. По умолчанию используется доверенный локальный режим на loopback-интерфейсе — так первый запуск проходит быстрее всего.

Если инстанс должен быть доступен в локальной сети или через Tailscale, выберите режим привязки явно:

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

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

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

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

API-сервер поднимается на http://localhost:3100. Встроенная PostgreSQL создаётся автоматически, отдельная настройка базы не нужна. Для продакшена подключите собственный PostgreSQL.

Проверка результата

Минимальный сценарий, который показывает, что система действительно работает:

1. Откройте http://localhost:3100 — должен открыться интерфейс с созданной компанией.
2. Создайте агента через визард и нажмите проверку конфигурации. Проверка выполняется на дешёвой модели, поэтому не тратит премиальные токены.
3. Поставьте агенту тестовую задачу и дождитесь прогона. Признак успеха: в треде тикета появляется live-вывод агента, а в разделе расходов — событие стоимости с указанием модели и провайдера.
4. Откройте журнал активности: там должна быть запись о прогоне с атрибуцией ответственного пользователя.

Команды разработки

pnpm dev              # сервер и UI в режиме отслеживания изменений
pnpm dev:once         # то же без watch-режима
pnpm dev:server       # только сервер
pnpm build            # сборка
pnpm typecheck        # проверка типов
pnpm test             # быстрые тесты Vitest
pnpm test:e2e         # браузерные тесты Playwright
pnpm db:generate      # генерация миграции
pnpm db:migrate       # применение миграций

Браузерные тесты вынесены отдельно и не запускаются командой pnpm test.

Практические сценарии

Ниже — шесть ситуаций, в которых платформа даёт результат сразу, а не после месяца настройки. Каждый сценарий описан так, чтобы вы могли повторить его за один вечер.

Сценарий 1. Собрать разбежавшиеся терминалы в один борд

Проблема. У вас открыто полтора десятка вкладок с кодинг-агентами, вы не помните, кто чем занят, а после перезагрузки контекст теряется.

Что сделать:

1. Заведите компанию и по проекту на каждый репозиторий.
2. Наймите двух-трёх агентов на адаптере Claude Code или Codex и укажите каждому свой проект.
3. Переносите задачи из головы в тикеты: заголовок, цель, критерий приёмки.
4. Поставьте heartbeat раз в 15–30 минут вместо ручного запуска.

Признак успеха: сессии переживают перезагрузку, а в треде каждого тикета видно, что агент делал и сколько это стоило.

Сценарий 2. Ночная смена и утренняя приёмка

Проблема. Работа стоит, когда вы спите, а бесконтрольные прогоны страшно оставлять без присмотра.

Что сделать:

1. Наберите в бэклог задачи, которые не требуют вашего решения по ходу дела.
2. Включите политику исполнения со стадией ревью, чтобы результат не уезжал дальше без вашей подписи.
3. Ограничьте потолок трат на одно пробуждение.
4. Утром открывайте очередь внимания и раздел решений.

Признак успеха: за ночь закрыто несколько тикетов, а утром вы разбираете короткий список решений, а не сотню логов.

Сценарий 3. Регулярная работа без напоминаний

Проблема. Отчёты, дайджесты, ответы в поддержке и посты в соцсети приходится каждый раз запускать руками.

Что сделать:

1. Создайте рутину с cron-расписанием и назначьте ответственного агента.
2. Для событийной работы используйте вебхук или вызов API вместо расписания.
3. Включите зависимость от внешней активности, чтобы прогон не запускался вхолостую.
4. Задайте политику параллельности, чтобы медленный прогон не наложился на следующий.

Признак успеха: каждая рутина оставляет тикет с результатом, и вы видите историю запусков, а не только последний.

Сценарий 4. Поставить расходы под контроль

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

Что сделать:

1. Задайте месячный бюджет на каждого агента, начните с намеренно маленькой суммы.
2. Добавьте предварительный лимит на одно пробуждение.
3. Через неделю откройте разбивку расходов по проектам, моделям и провайдерам.
4. Переведите рутинные задачи на дешёвую модель, оставив премиальную только на сложных.

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

Сценарий 5. Один стандарт работы для всей команды агентов

Проблема. Каждый агент работает по-своему, инструкции разъезжаются по папкам с конфигами.

Что сделать:

1. Опишите повторяющуюся процедуру как навык в Skill Studio и прогоните её в изолированном тестовом запуске.
2. Разложите навыки по вложенным папкам: общие для компании и личные.
3. Часть навыков поставьте из каталога, не изобретая заново.
4. Право на создание и правку навыков оставьте узкому кругу, просмотр откройте всем.

Признак успеха: новый агент начинает работать по вашим правилам сразу после найма, без переписывания промптов.

Сценарий 6. Дать агенту прод-доступы и не потерять сон

Проблема. Ключи от боевых сервисов не хочется класть в конфиг агента.

Что сделать:

1. Заведите секреты на уровне компании, а личные ключи оператора — на уровне пользователя.
2. Выдайте каждому агенту только те секреты, которые нужны его роли.
3. Для чувствительных ключей используйте выдачу по запросу в момент прогона вместо постоянной подстановки в окружение.
4. Отправляйте рискованные задачи в песочницу, а не на свою машину.

Признак успеха: в журнале безопасности видно каждое чтение секрета с привязкой к конкретному прогону и ответственному человеку.

Контроль расходов

Бюджеты — главная причина, по которой платформу ставят вместо самописной оркестрации.

• Бюджетные политики задаются с областью действия и порогами: при достижении порога предупреждения приходит уведомление, при исчерпании лимита агент ставится на паузу, а очередь его задач отменяется.
• Действуют предварительные лимиты на один heartbeat: у отдельного пробуждения есть жёсткий потолок трат.
• Расходы разбираются по компании, агенту, проекту, цели, задаче, провайдеру и модели.
• Использование через ACP-канал и неоценённые CLI-прогоны тоже попадают в телеметрию расходов.
• Как владелец инстанса вы можете снять ограничение вручную и вернуть агента в работу.

Навыки: Store и Studio

Навык (skill) — переиспользуемая инструкция, которую агент подгружает в рантайме без переобучения.

• Skills Store (с v2026.618.0) — установка навыков из каталога с учётом счётчика установок и каталогом на уровне компании.
• Skill Studio (с v2026.720.0) — трёхпанельный редактор с изолированными тестовыми прогонами, вложенными папками и отдельным разделом «My Skills».
• Навыки можно импортировать прямо из проекта, форки внутри компании проходят предварительные проверки.
• Создание и правка навыков закрыты отдельным правом skills:create, поэтому просмотр можно открыть шире, чем редактирование.

Рутины и расписания

Рутина — повторяющаяся работа, которая запускается без вашего участия.

• Триггеры: cron, вебхук, вызов API.
• Политики параллельности и догоняющих запусков защищают от наложения прогонов.
• Поддерживаются переменные даты, поэтому не нужно править промпт под каждый запуск.
• Рутину можно поставить в зависимость от внешней активности: запуск произойдёт только если реальная работа появилась.
• Каждый запуск создаёт отслеживаемый тикет и будит назначенного агента.

Governance: согласования и контроль качества

• Политики исполнения — многоступенчатые стадии ревью и одобрения с фиксацией решений.
• Очередь внимания и раздел «Decisions» (с v2026.720.0) собирают всё, что ждёт вашего ответа, в одном месте.
• Watchdogs (с v2026.626.0) — автоматические проверки, привязанные к задаче; их состояние и результат видны прямо в треде.
• Режим планирования с версионированием планов и отдельным одобрением плана.
• Evals агентов и обратная связь для оценки качества работы.
• Ask work mode — режим для вопросов, когда нужен ответ, а не полноценный рабочий цикл.
• Конфигурации версионируются, неудачные изменения откатываются.

Секреты и доступы

• Секреты хранятся на уровне инстанса, компании и отдельного пользователя-оператора. Пользовательские секреты появились в v2026.707.0 вместе с атрибуцией ответственного человека за прогон.
• Доступ выдаётся адресно: конкретный агент получает конкретные секреты через поисковый выбор агентов в редакторе доступа.
• В v2026.722.0 добавлен run-bound API: агент запрашивает выданное ему значение по требованию через GET /api/agents/me/secrets и POST /api/agents/me/secrets/:key/value, а каждое чтение попадает в журнал безопасности и активности.
• Пароли, токены и cookie-заголовки вычищаются из логов сервера.
• Телеметрия анонимизирована и отключается переменными DO_NOT_TRACK=1 или PAPERCLIP_TELEMETRY_DISABLED=1.

Песочницы и облачное исполнение

Агент может работать не только на вашей машине:

• Поддерживаются провайдеры песочниц Daytona, e2b, Cloudflare, Modal, Novita и самостоятельно развёрнутый Kubernetes.
• Собственные образы песочниц собираются из браузера: встроенный SSH-терминал позволяет доустановить пакеты прямо в форме настройки окружения (v2026.707.0).
• Статус эфемерного рантайма виден в треде задачи, аренды песочниц Daytona переиспользуются между прогонами.
• Потолок времени одного прогона в песочнице поднят до четырёх часов.
• Многоарендная изоляция: у каждой компании свои ключи подписи JWT, данные плагинов тоже разделены по компаниям.

Плагины и расширения

Плагинная система работает на уровне инстанса: внешние процессы-воркеры, доступ к сервисам хоста по capability, планировщик задач, публикация инструментов и вклад в интерфейс. CLI показывает целевой хост установки и поддерживает команду plugin target. Каталог сообщества собран в репозитории awesome-paperclip.

Экспериментальные функции

Включаются отдельно в настройках, поведение может измениться. Управляемый доступ агентов к MCP-инструментам в дорожной карте уже отмечен как готовый, но раздел Apps и связанные с ним подключения по-прежнему нужно включать вручную.

• Apps — каталог подключений и настройка доступа агентов к внешним инструментам.
• Connections v3 — фундамент для интеграций в один клик: стабильные идентификаторы подключений, гранты для субъектов, мультиключевые учётные данные.
• Встроенный суммаризатор и слоты кратких сводок в интерфейсе.
• Decision Training — библиотека снимков решений и инспектор для разбора того, как агенты принимают решения.
• Cases — структурированный объект для расследований и разборов.

Что изменилось с весны 2026

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

• Это не чат-бот: у агентов есть задачи и рабочие статусы, а не окно диалога.
• Это не фреймворк для создания агентов: платформа управляет организацией из уже существующих.
• Это не визуальный конструктор процессов: моделируются компания, цели и бюджеты, а не drag-and-drop-пайплайны.
• Это не менеджер промптов: промпты, модели и рантаймы приносит сам агент.
• Это не инструмент для одного агента: смысл появляется на команде.
• Это не система код-ревью: платформа оркеструет работу, а pull-реквесты остаются в вашем процессе.

Ограничения и когда не подходит

• Быстрый темп релизов. Проект перешёл на датированные версии и выпускает релизы каждые одну-две недели. API и интерфейсы меняются, перед обновлением читайте раздел upgrade guide в релизных заметках.
• Разворачивать придётся самостоятельно. Публичного SaaS от вендора нет. В дорожной карте облачные развёртывания помечены как частично готовые: многоарендная изоляция и синхронизация «локально → облако» уже выпущены, но обслуживание инстанса остаётся на вас.
• Безопасность самих агентов на вашей стороне. Платформа даёт governance на уровне организации и песочницы, но что именно агент делает внутри своей среды, ограничиваете вы.
• Порог входа. Нужны Node.js, pnpm, понимание git-веток и рабочих пространств. Для одного агента накладные расходы не окупаются.
• Незакрытые направления. В дорожной карте пока не отмечены память и база знаний, рабочие очереди, самоорганизация агентов, десктопное приложение, подключение внешних трекеров (Asana, Linear, Jira) и интеграции в один клик.

Ссылки

• GitHub-репозиторий
• Документация
• Changelog и релизные заметки
• Список релизов на GitHub
• Discord-сообщество
• Каталог плагинов awesome-paperclip

По теме

• Статья: Хватит считать агента помощником — оформляйте его на работу
• Блог: Топ-агенты вместо топ-менеджеров
• База знаний: GitHub Projects — управление задачами AI-агентов

Если у вас уже несколько агентов и вы решаете, ставить ли отдельный слой оркестрации или обойтись трекером задач, такой разбор экономит недели экспериментов.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov