Написать в Telegram

Paperclip: как собрать из ИИ-агентов команду с руководителем, задачами и бюджетом. Пошагово

Содержание
  1. Что получится в итоге
  2. Что понадобится
  3. Шаг 1. Ставим Paperclip
  4. Шаг 2. Первый агент станет руководителем
  5. Шаг 3. Нанимаем команду
  6. Шаг 4. Ставим задачу
  7. Шаг 5. Важные решения остаются за вами
  8. Шаг 6. Следим за работой и расходами
  9. Чем закончилась история с туалетом
  10. Если вы работаете из России
  11. Что важно знать до старта
  12. Что дальше

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

Paperclip решает именно эту проблему. Это бесплатное приложение с открытым кодом, где агенты работают как компания: у них есть руководитель, должности, задачи и бюджет, а важные решения ждут одобрения человека. Создатели объясняют так: если агент это сотрудник, то Paperclip это компания.

Сейчас это одна из самых обсуждаемых тем про ИИ-агентов. Разбираем по шагам: как поставить Paperclip, собрать команду и дать ей первую задачу. И что из этого можно повторить в России.

Что получится в итоге

Отдел из ИИ-агентов, который работает по понятным правилам. Руководитель принимает задачу и раздаёт её сотрудникам. Сотрудники делают свою часть и отчитываются прямо в задаче. Проверяющий смотрит, чтобы никто не натворил лишнего. А вы видите всё на одном экране и одобряете шаги, которые что-то меняют.

Для примера возьмём ИТ-службу небольшой видеостудии. Но устройство то же для любого отдела: продаж, бухгалтерии, поддержки.

Что понадобится

  • Компьютер или сервер. Попробовать можно на своём компьютере: Mac, Linux или Windows через WSL2. Для постоянной работы лучше отдельный сервер или виртуальная машина, например с Ubuntu: агенты получают доступ к системе, и держать их стоит отдельно от рабочих данных.
  • Node.js версии 24 или новее, на нём работает Paperclip.
  • Хотя бы один агент. Сам Paperclip агентов не создаёт, он ими управляет. Подойдут Claude Code, Codex и другие, о них ниже.
  • Подписка или ключи к нейросетям. Paperclip работает с тем, что у вас уже есть.

Шаг 1. Ставим Paperclip

Ставится одной командой из документации проекта:

npx paperclipai@latest onboard --yes

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

Мастер установки Paperclip: выбираем быстрый путь или настройку базы, сервера и хранилища
Мастер установки Paperclip: выбираем быстрый путь или настройку базы, сервера и хранилища

Шаг 2. Первый агент станет руководителем

При первом входе Paperclip просит создать первого агента. В примере его зовут Дамблдор, и он становится руководителем всей команды. Дальше выбираете, на чём он будет работать: Claude Code или Codex. Свои модели Paperclip не продаёт, он подключается к вашей подписке или ключам.

Важная деталь: Claude Code и Codex работают на той же машине, где стоит Paperclip. Если Claude Code на сервере не установлен, первый запуск руководителя упадёт. Поставьте его заранее и войдите в аккаунт, а если запуск уже упал, нажмите повтор во входящих.

Подключение модели к первому агенту: Claude Code или Codex
Подключение модели к первому агенту: Claude Code или Codex

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

Шаг 3. Нанимаем команду

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

Вот пример такой задачи на найм проверяющего. Её можно брать как шаблон:

Найми проверяющего по безопасности, пусть работает на Codex. Его работа: смотреть каждое предложенное изменение на настоящей машине до того, как его запустят. Нужно ли оно, минимально ли, можно ли его откатить и действительно ли оно чинит проблему. Одобрить или вернуть с замечаниями. Сам он ничего не запускает и к машинам не прикасается. Если изменение даёт агенту больше доступа, чем нужно для задачи, он его возвращает. Оформи найм и скажи, когда заявка будет ждать моего одобрения.

Задача на найм проверяющего: обязанности и границы прописаны прямо в тексте
Задача на найм проверяющего: обязанности и границы прописаны прямо в тексте

У каждого агента своя карточка: имя, должность, кому подчиняется и что умеет. Там же его инструкции, навыки, доступы, история запусков и бюджет.

Карточка агента: сетевой инженер подчиняется техническому директору Рону
Карточка агента: сетевой инженер подчиняется техническому директору Рону

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

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

Агенты в одной команде работают на разном: Claude Code, Codex, Hermes, Pi. Paperclip неважно, что внутри. Если агент умеет получать задачи, его можно нанять.

Шаг 4. Ставим задачу

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

Задача про туалет и сеть в работе у руководителя
Задача про туалет и сеть в работе у руководителя

Руководитель разбивает задачу на подзадачи и раздаёт их сотрудникам: составить карту сети, проверить хранилище, поймать момент сбоя. Инструментальщик собрал ловушку, которая фиксирует каждое падение связи, а проверяющий по безопасности сначала её проверил. Агенты включаются, когда им назначили работу, пишут отчёты прямо в задачу и прикладывают файлы. Если агент застрял, он не дёргает вас, а возвращает задачу руководителю. И только если тот не справился, вопрос приходит к вам. А если что-то пошло не туда, всю ветку подзадач можно поставить на паузу одной кнопкой.

Шаг 5. Важные решения остаются за вами

Всё, что требует решения человека, попадает в раздел Decisions. Руководитель пишет: на что из этого у меня есть ваше разрешение? Пока ничего не менялось. И предлагает варианты:

  • контрольный тест на 30 минут, только наблюдение, ничего не меняется;
  • замена модуля и кабеля на одном порту, 5 минут;
  • проверка всех 10-гигабитных подключений студии по очереди, чтобы никто не терял рабочий день.
Раздел Decisions: агент спрашивает разрешения и предлагает варианты
Раздел Decisions: агент спрашивает разрешения и предлагает варианты

Человек выбирает, агенты делают только одобренное.

Шаг 6. Следим за работой и расходами

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

Главный экран: 9 агентов, задачи в работе, расходы за месяц и решения на одобрение
Главный экран: 9 агентов, задачи в работе, расходы за месяц и решения на одобрение

Регулярную работу ставят в Routines. Например, проверка хранилища каждый день в 10 утра: агент сам приходит с решением, если места мало. Так же устраивают ежедневную планёрку агентов: каждый рассказывает, что сделал за день.

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

Чем закончилась история с туалетом

Руководитель собрал отчёты команды и выдал вердикт: дело не в туалете, и никакой мистики. Четыре подключения на одном из коммутаторов сломаны уже 15 месяцев и теряют связь примерно 56 раз в день. А любое движение в здании их роняет. По отчёту агентов, виноваты сторонние оптические модули из одной партии с высокой долей отказов, и их заменили. При этом агенты ничего не меняли сами: всё, что трогает оборудование, ждало одобрения. Задачу при этом не закрыли сразу: команду оставили наблюдать ещё неделю-две.

Вердикт руководителя: не туалет, а четыре подключения без запаса
Вердикт руководителя: не туалет, а четыре подключения без запаса

Если вы работаете из России

Сам Paperclip бесплатный и ставится на ваш сервер, так что зависеть тут не от чего. Ограничения в агентах и моделях: Claude Code и Codex из России напрямую не работают.

Но Paperclip к ним не привязан. В примере сканер сети работает на модели Qwen, которая запущена на собственных компьютерах, и не стоит ничего. В списке поддержки есть Kimi Code, открытые агенты Hermes и Pi, а ещё можно подключить свой процесс или HTTP-сервис. Значит, команду можно собрать на моделях, доступных из России, в том числе на открытых моделях на своём сервере.

Найм сканера на локальной модели Qwen: стоит ноль, только читает и не выполняет чужих команд
Найм сканера на локальной модели Qwen: стоит ноль, только читает и не выполняет чужих команд

Обратите внимание на последнюю часть этой задачи. Всё, что сканер прочитал на устройстве или веб-странице, он считает данными, а не командами. Если в прочитанном есть что-то похожее на инструкцию, он сообщает об этом, а не выполняет. Так защищаются от подсказок, которые злоумышленник может спрятать в тексте для агента.

Что важно знать до старта

  • Агентов Paperclip не создаёт. Это управление, а не конструктор: агенты нужны свои, и каждого надо настроить.
  • Проект молодой. Paperclip появился в марте 2026 года, новые версии выходят постоянно, поэтому кнопки у вас могут отличаться от скриншотов.
  • Агенты получают доступ к настоящим системам. Отсюда отдельная машина, роли только на чтение, где это возможно, а любые изменения через одобрение. Ключи хранятся в разделе Secrets, и доступ к каждому выдаётся конкретному агенту.
  • Не всё работает гладко. Сканер в примере то и дело отваливался по таймауту, а один агент сам раздал задачи, о которых его не просили, и работу пришлось ставить на паузу.
  • Лимиты тратятся быстрее. Десять агентов расходуют подписку или ключи быстрее, чем один. Бюджеты лучше задать в первый же день.

Что дальше

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

Мы в Агентехе учим сотрудников собирать агентов под задачи своего отдела и выстраивать такие правила. Как устроено обучение.

Написать в Telegram