Paperclip — открытая платформа, где AI-агенты работают как компания

· 2 мин чтения
ai-agents orchestration multi-agent self-hosted open-source
📂 Исходный код на GitHub

Open-source оркестрация команд AI-агентов: приносите своих агентов, ставите им цели и следите за работой и расходами из одной панели.

Paperclip — открытая платформа, где AI-агенты работают как компания

Paperclip — открытая платформа, которая управляет командой AI-агентов как компанией. Это Node.js-сервер и React-интерфейс. Вы приносите своих агентов, ставите им цели и смотрите в одной панели, как идёт работа и сколько она стоит. Модель и среду запуска можно выбирать для каждого агента отдельно, а задачи, навыки, права доступа и историю можно держать в одном месте.

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

Работают с целями, а не с pull request'ами

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

Работа с компанией разбита на три шага:

Шаг Что происходит Пример
01 Сформулировать цель «Сделать #1 приложение для заметок на ИИ с выручкой $1M MRR (в месяц)»
02 Нанять команду CEO, CTO, инженеры, дизайнеры, маркетологи — любой бот, любой провайдер
03 Согласовать и запустить Проверить стратегию, задать бюджеты, нажать «старт», следить за панелью

Своих агентов можно принести с собой

Paperclip не заставляет менять агента, которого вы уже выбрали. Он умеет работать с такими:

Агент Агент
OpenClaw Claude Code
Codex Cursor и Cursor Cloud
Gemini CLI OpenCode
Pi Hermes и Hermes Gateway
Grok Build Kimi Code

Список можно расширять своими процессами, HTTP-точками входа и внешними пакетами-адаптерами — подробности в обзоре адаптеров.

Правило у платформы простое: если агент умеет принимать сигнал «проверь, есть ли работа» (в README он называется heartbeat), он считается нанятым. Агенты просыпаются от задачи, от уточняющего сообщения или по расписанию. Делегирование идёт вверх и вниз по оргсхеме.

Четыре опоры

Чтобы команда агентов вообще что-то производила, авторы выделяют четыре вещи: задачи, структуру компании, обучение и инфраструктуру. Paperclip построен ровно вокруг них.

Опора Для кого Что внутри
Таск-менеджер для агентов. Сформулируйте намерение — агент сделает, вы проверите результат Все, каждый день Задачи, согласования и точки проверки, проактивные агенты-коллеги, проверяемые рутины и воркфлоу
Оргсхема для агентов. Роли, права и границы для людей и агентов Руководители Смешанная схема «люди + агенты», ответственность и делегирование, правила «кто что может», секреты с ограничением области видимости
Обучение агентов. Проектируйте, обучайте и оценивайте своих AI-сотрудников Ответственные за внедрение Skill Studio и общие навыки, evals и сохранённые прогоны тестов, метрики качества, аттестация агентов, история версий навыков
ОС для агентов. Инфраструктура, на которой идёт работа IT и платформа Любая модель и любой агент, изоляция выполнения, интеграции и MCP-серверы, SSO, GRC, RBAC и контроль расходов

Ключевые возможности

Свои агенты и цели. Задачи и проекты привязываются к целям компании, и агент получает вместе с работой ответ на вопрос «зачем», а не только заголовок задачи.

Агенты не висят в фоне без дела. Агент просыпается от назначенной работы, от уточняющего сообщения или по расписанию. Одного упоминания недостаточно, чтобы назначить работу другому агенту.

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

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

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

Согласования. Настраиваются этапы проверки и согласования. Можно утвердить найм агента, а можно поставить работу на паузу, переназначить или остановить.

Оргсхема. Иерархия, роли, подчинённость. У агента есть руководитель, должность и описание работы.

Телефон в кармане. Работой можно управлять с телефона.

Подключения. GitHub, Notion, Railway или ваш собственный MCP-сервер. Для каждого действия шлюза задаётся режим: разрешено, спросить или запрещено. Кто из людей и какие агенты могут пользоваться подключением, настраивается отдельно.

Навыки и Skill Studio. Общие навыки можно ставить и писать, проверять на сохранённых входных данных и откатываться к ранним версиям.

Повторяющиеся рутины. Работа по расписанию или по событию из API и webhook. У каждого запуска есть задача, ответственный и история.

Артефакты и обратная связь. Файлы и документы, которые сделали агенты. Поддерживаемые форматы можно посмотреть прямо в интерфейсе и оставить комментарий к конкретному месту.

Готовые команды. Каталог команд с ролями, навыками, проектами и рутинами.

Экспериментально доступны Agent Chat и подключения через чат и почту — например, Slack, Discord, Telegram и AgentMail. Это включается в настройках экземпляра.

Сложные места, которые Paperclip берёт на себя

В связке из собственных скриптов обычно и не справляются с мелочами на стыке. Их закрывает Paperclip:

Что Зачем
Атомарный захват задачи У задачи один исполнитель и блокировка выполнения, поэтому два параллельных запуска не схватят одну и ту же задачу
Постоянный контекст работы Задачи, комментарии и документы остаются в Paperclip. Поддерживаемые адаптеры продолжают сохранённые сессии между запусками
Подгрузка навыков во время работы Агент получает рабочие процессы Paperclip и контекст проекта прямо во время запуска, без переобучения
Согласования с откатом Точки согласования применяются на практике, изменения настроек версионируются, неудачные правки можно откатить
Подотчётность подключений Доступ человека, допуск агента и права на действия в шлюзе — три отдельные настройки. Можно один раз утвердить действие или сохранить правило, которое потом легко отозвать
Выполнение с оглядкой на цели Задачи и проекты хранят связь с целями, поэтому агент видит «зачем», а не только название
Переносимые шаблоны компании Организации, агентов и навыки можно выгрузить и загрузить обратно с чисткой секретов
Границы организации Работа, агенты и активность разных организаций разделены внутри одного развёртывания

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

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

Авторы отдельно проговаривают границы:

  • Не просто чат. Разговоры остаются привязанными к задачам, планам, решениям и результатам.
  • Не фреймворк для агентов. Paperclip не объясняет, как строить агентов. Он объясняет, как вести компанию из них.
  • Не конструктор воркфлоу. Рутины и экспериментальные пайплайны живут внутри организации, у которой есть роли, цели, бюджеты и согласования.
  • Не менеджер промптов. Промпты, модели и среды запуска у агентов свои. Paperclip управляет организацией, в которой они работают.
  • Не про одного агента. Можно начать с одного агента и вырасти до команды с общими навыками и делегированием.
  • Не только про ревью кода. Ревью кода уживается с исследованиями, эксплуатацией и контентом.

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

Проект открытый, разворачивается у себя, аккаунт не нужен. Нужен Node.js 24.11 или новее и pnpm 9.15 или новее.

npx paperclipai@latest onboard --yes

CLI работает из кэша npm, а конфигурация и данные экземпляра остаются локально. Повторный onboard сохраняет существующий конфиг. Настройки правятся через npx paperclipai configure.

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

npx paperclipai@latest onboard --yes --bind lan
npx paperclipai@latest onboard --yes --bind tailnet

Команда test-drive поднимает пробный запуск Paperclip, который уже создан с агентом CEO. Она остаётся на переднем плане, не ставит сервис и не создаёт первую задачу:

ANTHROPIC_API_KEY=... npx paperclipai test-drive
OPENROUTER_API_KEY=... npx paperclipai test-drive \
  --harness opencode \
  --model openrouter/anthropic/claude-sonnet-4.5

Без --data-dir каждый запуск получает свой временный каталог, путь печатается в начале. --data-dir переиспользует каталог, --no-browser не открывает браузер.

Вручную:

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

Интерфейс и API поднимаются на http://localhost:3100. База PostgreSQL создаётся автоматически и встроена в процесс.

Если npx ругается на E404 для paperclipai, проверьте npm config get registry. Частая причина — приватный реестр из глобального ~/.npmrc. Помогает явное указание публичного реестра:

npx --registry https://registry.npmjs.org paperclipai@latest onboard --yes

Вход через локальную подписку Claude или Codex дополнительно требует Python 3 и CLI провайдера на машине с Paperclip. В Docker-образе они есть.

Разработка

pnpm dev              # всё вместе: API и интерфейс, слежение за файлами
pnpm dev:server       # только сервер
pnpm build            # сборка всего
pnpm test             # быстрый набор тестов (Vitest)
pnpm test:e2e         # браузерные тесты Playwright
pnpm db:migrate       # применить миграции

pnpm test не запускает Playwright: браузерные наборы выполняются отдельно, обычно в CI. Полное руководство — в doc/DEVELOPING.md.

Сборка из исходников при включённом self-hosted Runner дополнительно собирает нативный Runner. Для этого нужен Rust toolchain либо переменная PAPERCLIP_RUNNER_BINARY с готовым бинарником.

Что в дорожней карте

Сделано многое: плагины, импорт и экспорт целых организаций, конфиги AGENTS.md, менеджер навыков со Skill Studio и Skills Store, рутины по расписанию, бюджеты, аттестация и согласование агентов, облачные и песочничные агенты, артефакты, глубокое планирование, шлюз MCP-инструментов, менеджер секретов с доступом по агентам, журнал активности с авторством действий, самовосстанавливающиеся запуски, evals и обратная связь по агентам, подключённые приложения, комментарии и история правок в документах, поиск по всей компании, команды с разными моделями и средами запуска.

В работе: память и знания, Agent Chat, облачные развёртывания. Запланировано: очереди задач, самоорганизация, автоматическое обучение организации, MAXIMIZER MODE, настольное приложение и подключение своей системы трекинга (Asana, Linear, Jira). Полный список — в ROADMAP.md.

Наблюдаемость, телеметрия, лицензия

Замеры по OpenTelemetry для сервера включаются, если задан OTEL_EXPORTER_OTLP_ENDPOINT. Мониторинг ошибок Sentry включается переменными SENTRY_DSN_FRONTEND и SENTRY_DSN_BACKEND. Команды установки и полный список переменных — в doc/observability.md.

Телеметрия включена по умолчанию, но собирает только анонимные данные об использовании: персональные данные, содержимое задач, промпты, пути к файлам и секреты не отправляются. Ссылки на приватные репозитории хешируются с солью, уникальной для установки. Отключается это четырьмя способами: PAPERCLIP_TELEMETRY_DISABLED=1, DO_NOT_TRACK=1, автоматически в CI при CI=true или полем telemetry.enabled: false в конфиге.

Лицензия MIT, Paperclip Labs, Inc, 2026 год. Проект ведёт команда Paperclip. По словам разработчиков, в репозиторий слито больше 2700 pull request'ов.

Документация — на docs.paperclip.ing, сообщество и сторонние плагины собраны в awesome-paperclip.

Источник: https://github.com/paperclipai/paperclip