Саммари:

• 🎯 О чём этот конспект: Пошаговое руководство по развёртыванию и настройке Paperclip — мета-каркаса (meta-harness) для объединения разрозненных AI-агентов (Claude Code, Hermes, Codex, Pi) в единую структурированную компанию. Рассматривается построение иерархии (Org Chart), координация задач между агентами без пустой болтовни, сбор артефактов, запуск расписаний (Routines) и расследование реальных инфраструктурных сбоев.

• 👤 Кому будет полезно: Вайбкодерам, AI-инженерам, DevOps-специалистам и основателям стартапов, которые хотят объединить разные языковые модели и агентские фреймворки в управляемый рабочий процесс с human-in-the-loop контролем.

• ✨ Что получите: Готовую архитектуру для запуска self-hosted агентной организации, инструкции по найму агентов, настройке автономных ежедневных стендапов, безопасной передаче API-ключей и автоматическому решению задач с генерацией отчётов.

1. Концепция Meta-Harness: превращение разрозненных агентов в управляемую компанию

Контекст: Большинство разработчиков запускают несколько независимых AI-агентов: Claude Code для терминала, Hermes для системного администрирования, OpenAI Codex для скриптов или локальные модели через Pi. Главная проблема — отсутствие централизованного управления: агенты не знают о существовании друг друга, не могут системно обмениваться контекстом, а концепция «агентских комнат для чата» (Agent Town / Conference Room) порождает неконтролируемый флуд без реального результата. Paperclip решает эту проблему, выступая в роли Meta-Harness. Он стандартизирует интерфейс взаимодействия: пользователи выступают в роли Совета директоров (Board of Directors), агенты становятся сотрудниками с чёткими ролями и менеджерами, а всё общение происходит строго внутри целевых задач и тикетов.

Тайминг: ▶ 00:18, ▶ 00:34, ▶ 01:31, ▶ 01:89

Выгода: Устранение контекстного хаоса, возможность объединять любые LLM и агентские движки (Claude Code, Hermes, Codex, локальные LLM) в единый пайплайн с контролируемым бюджетом и человеческим контролем решений.

Как применить:

• Шаг 1: Определение организационной структуры (Org Chart) — Спроектируйте дерево подчинения перед запуском. Например: Вы (Совет директоров) → CEO (агент на Claude Code) → CTO (агент на Hermes) → Линейные инженеры (сеть, хранилище, безопасность на локальных моделях или Codex).
• Шаг 2: Выбор среды размещения — Определите, где будет работать Paperclip Meta-Harness. Для тестов подойдёт локальный Mac, Linux или WSL2 на Windows; для постоянной автономной работы рекомендуется выделенная виртуальная машина (Proxmox Ubuntu VM или Cloud VPS).

Результат: Чёткая архитектура мультиагентной системы, готовая к объединению различных CLI-агентов и API в единую организационную модель.

2. Развёртывание Paperclip и инициализация AI CEO

Контекст: Paperclip устанавливается на собственный сервер или рабочую станцию и поднимает веб-интерфейс на порту 3100. Так как Paperclip — это мета-каркас, он выполняет команды через установленные на той же машине агентские CLI-утилиты (например, Claude Code CLI). При первом запуске создаётся организация и назначается первый агент (CEO), который берёт на себя функцию первичного онбординга компании.

Тайминг: ▶ 03:68, ▶ 04:02, ▶ 04:43, ▶ 04:54

Выгода: Полный контроль над данными и инфраструктурой (Self-hosted), запуск компании за 5 минут без привязки к проприетарным облачным платформам.

Как применить:

• Шаг 1: Установка Paperclip на сервер — Выполните команды загрузки и запуска скрипта установки в терминале Ubuntu/Debian, macOS или WSL2:

# Скачивание скрипта установки
curl -fsSL https://raw.githubusercontent.com/paperclip-ai/paperclip/main/install.sh -o install.sh
 
# Запуск инсталлятора
bash install.sh

• Шаг 2: Настройка сетевого доступа — При установке выберите Advanced Setup (если ставите на удалённую VM/Proxmox), чтобы указать локальный IP/доменное имя, либо Quick Start для локальной машины.
• Шаг 3: Установка и авторизация агентского движка для CEO — На том же сервере установите Claude Code CLI и выполните вход в аккаунт Anthropic:

# Установка Claude Code CLI глобально
npm install -g @anthropic-ai/claude-code
 
# Авторизация
claude login

• Шаг 4: Первичный онбординг через Web UI — Откройте в браузере http://<IP-вашего-сервера>:3100 (или http://localhost:3100). Задайте имя компании, создайте аккаунт и инициализируйте CEO (например, Dumbledore), выбрав в качестве движка Claude Code.

Имя организации: My AI Studio
Роль: CEO
Движок агента: Claude Code
Имя агента: Dumbledore

Результат: Работающий инстанс Paperclip с активным AI CEO, готовым к найму команды и распределению задач.

3. Найм и структурирование мультиагентной команды (Org Chart)

Контекст: В Paperclip агенты могут работать на абсолютно разных движках и хостах. Например, CEO может работать на Claude Code локально, технический директор (CTO) — на удалённом Hermes-агенте в отдельной VM, инженер безопасности — на OpenAI Codex, а служба поддержки — на локальной LLM через фреймворк Pi. Процесс найма формализован: агент подаёт заявку, а Совет директоров (пользователь) подтверждает оффер.

Тайминг: ▶ 05:12, ▶ 05:35, ▶ 06:05, ▶ 06:27

Выгода: Специализация агентов под конкретные задачи с оптимизацией затрат (дорогие модели вроде Claude 3.5 Sonnet / Opus ставятся на менеджмент, легковесные или локальные модели — на рутинный мониторинг и сканирование).

Как применить:

• Шаг 1: Найм удалённого Hermes-агента (CTO) — Скопируйте сгенерированный в Paperclip промпт найма и отправьте его вашему внешнему Hermes-агенту. Агент отправит запрос на авторизацию в Paperclip.
• Шаг 2: Одобрение найма Советом директоров — Перейдите во вкладку Inbox в Paperclip и нажмите кнопку Approve на запросе от агента (например, Ron — CTO).
• Шаг 3: Делегирование найма остальных сотрудников CEO — Поручите AI CEO нанять оставшуюся команду инженеров через задачи.

Task for Dumbledore (CEO):
"Hire the following team members for our IT department:
1. Fred - Network Engineer (Hermes harness)
2. George - Storage Engineer (Hermes harness)
3. Arthur Weasley - Systems Automation (Codex harness)
4. Mad-Eye Moody - Security Reviewer (Codex harness)
5. Scanner - Local Network Scanner (Pi harness / local model)"

• Шаг 4: Проверка организационной схемы — Перейдите в раздел Org Chart и убедитесь, что дерево подчинения сформировано корректно: все инженеры подчиняются CTO (Ron), а CTO подчиняется CEO (Dumbledore).

[ Board of Directors (You) ]
             |
      [ CEO: Dumbledore (Claude Code) ]
             |
      [ CTO: Ron (Hermes) ]
     /       |          \
[ Fred ]  [ George ]  [ Mad-Eye ]  [ Scanner ]
(Network) (Storage)   (Security)   (Local Pi)

Результат: Полностью укомплектованный штат разнородных AI-агентов с настроенной иерархией подчинения.

4. Постановка задач, механизм Cases и иерархия декомпозиции

Контекст: Главное отличие Paperclip от хаотичных чат-систем — строго направленная коммуникация через задачи (Tasks). Когда пользователю нужно решить проблему, он создаёт корневую задачу или проект. Агент верхнего уровня (CEO) использует механизм Cases (кейсы расследований), декомпозирует проблему на подзадачи, назначает блокирующие задачи (blocking tasks), рецензентов (reviewers) и наблюдателей (watchdogs). Если у исполнителя возникает сбой или нехватка данных, он не спамит пользователя, а эскалирует проблему своему непосредственному руководителю.

Тайминг: ▶ 05:54, ▶ 07:11, ▶ 07:40, ▶ 07:56

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

Как применить:

• Шаг 1: Создание проекта и корневой задачи — Перейдите в Projects → Create Project, затем создайте задачу с описанием проблемы.

Project: Infrastructure Reliability
Task: Investigate NAS Disconnection Root Cause
Assignee: Dumbledore (CEO)
 
Description:
Every time an event occurs in the studio (e.g., physical movement / bathroom door/flush), client workstations lose connection to the NAS over 10G SFP+.
Investigate:
1. Network switches (MikroTik / Flue Powder switch) log errors and link flapping.
2. Storage server (Ceph/NAS) health and dropouts.
3. Physical vs configuration issues (Spanning Tree, MAC table flushes).

• Шаг 2: Управление поддеревом задач (Subtree Management) — В интерфейсе задачи используйте панель управления:
  • Pause subtree — временная приостановка выполнения всей ветки подзадач.
  • Properties — просмотр зависимостей, блокирующих тасок и назначенных наблюдателей.
• Шаг 3: Мониторинг выполнения — Наблюдайте, как CEO создаёт подзадачи для сетевого инженера (Fred), инженера хранилища (George) и запускает сканер сети.

Результат: Автономное параллельное выполнение комплексной диагностики всей командой агентов с древовидной структурой отчётности.

5. Сбор Артефактов (Artifacts) и механизм принятия решений (Decisions)

Контекст: В процессе работы агенты генерируют результаты — файлы конфигураций, карты сети, дампы логов и аналитические отчёты в формате Markdown. В Paperclip эти файлы сохраняются как Artifacts. Когда агентам для продолжения работы требуются действия в физическом мире (замена оборудования) или стратегический выбор, система генерирует интерактивный запрос в разделе Decisions, где человек выбирает вариант ответа.

Тайминг: ▶ 07:91, ▶ 08:11, ▶ 08:49, ▶ 09:20, ▶ 12:10

Выгода: Прозрачность работы (любой шаг подтверждён сгенерированным артефактом) и безопасный Human-in-the-Loop контроль критических операций.

Как применить:

• Шаг 1: Просмотр сгенерированных артефактов — Перейдите в меню Work → Artifacts. Откройте файл, созданный агентом (например, studio_network_map.md или switch_flapping_report.md).
• Шаг 2: Обработка решений (Decisions) — Перейдите в раздел Decisions на панели управления, когда агент запрашивает ввод данных от Совета директоров.

Decision Request from CEO (Dumbledore):
Issue: SFP+ Transceiver link drop signature detected on MikroTik Switch 'Flue Powder'.
Ports 3, 5, 13, 19 logged 20,000+ link down events.
 
Questions:
1. When NAS drops, do all clients lose connection simultaneously? [Yes / No] -> Answer: Yes (Same instant)
2. Suspected cause: Third-party generic SFP modules batch failure vs physical vibration.
Action: Approve replacement with official MikroTik SFP+ modules? [Approve / Defer] -> Answer: Approve

• Шаг 3: Анализ временной шкалы (Timeline) — Перейдите во вкладку Timeline для визуализации всех событий, завершённых задач и сгенерированных артефактов в хронологическом порядке.

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

6. Автоматизация расписаний (Routines) и автономные Stand-up митинги

Контекст: Для регулярных операций (проверка свободного места на SSD, аудит бэкапов, ежедневные синхронизации) в Paperclip встроен инструмент Routines — аналог продвинутого Cron с поддержкой триггеров и агентского контекста. Routines позволяют настроить ежедневные стендапы, в рамках которых каждый агент отчитывается о проделанной работе за день и задаёт вопросы коллегам в автоматическом режиме.

Тайминг: ▶ 09:80, ▶ 10:14, ▶ 10:41, ▶ 15:58, ▶ 15:91

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

Как применить:

• Шаг 1: Создание автоматической рутины мониторинга — Перейдите в Routines → Create Routine.

Name: Daily Ceph & Storage Health Check
Responsible Agent: Fred (or George)
Schedule Trigger: Every day at 10:00 AM (Cron: 0 10 * * *)

Prompt:
"Every day, check the storage capacity on the Ceph cluster and evaluate SSD tier health. 
Report remaining storage. If available capacity is below 20%, automatically generate a Decision item for the Board of Directors."

• Шаг 2: Настройка ежедневного командного Stand-up — Создайте отдельную рутину для вечерней синхронизации всей организации.

Name: Daily Agent Stand-up Sync
Schedule Trigger: Every day at 5:00 PM (Cron: 0 17 * * *)
Mode: Organization-wide Broadcast

Prompt:
"Each agent reports:
1. Key tasks completed today.
2. Blockers or pending dependencies.
3. Cross-agent Q&A: If an agent's work affects another team member (e.g., video backup expiration affecting editing storage), initiate a direct query."

• Шаг 3: Ручной запуск для проверки — Нажмите кнопку Run Now в карточке рутины, чтобы протестировать выполнение без ожидания триггера времени.

Результат: Агенты ежедневно в 17:00 самостоятельно проводят стендап, задают друг другу уточняющие вопросы и формируют единую сводку для владельца.

7. Управление секретами (Secrets) и интеграция внешних API (Threat Intelligence)

Контекст: Для взаимодействия с внешними SaaS-сервисами, системами безопасности или облачными провайдерами агентам требуются API-ключи. В Paperclip реализовано безопасное хранилище Secrets с разграничением прав доступа: секреты назначаются конкретным агентам, предотвращая утечку ключей между задачами. В видео демонстрируется подключение платформы киберразведки Flare (мониторинг даркнета, Telegram-утечек и сессионных cookie) к агенту безопасности.

Тайминг: ▶ 14:19, ▶ 14:43, ▶ 14:83, ▶ 15:16

Выгода: Безопасная работа с приватными API и автоматическое реагирование на инциденты безопасности без хардкода токенов в промптах.

Как применить:

• Шаг 1: Добавление API-ключей в хранилище — Откройте Settings → Secrets → Create Secret.

Secret Name: FLARE_API_KEY
Secret Value: <your_api_key_here>
Allowed Agents: Filch (Security Agent)

Secret Name: FLARE_TENANT_ID
Secret Value: <your_tenant_id_here>
Allowed Agents: Filch (Security Agent)

• Шаг 2: Назначение навыка (Skill) и запуск задачи — Привяжите к агенту кастомный скрипт/скилл взаимодействия с API сервиса и поставьте задачу на проведение аудита утечек.
• Шаг 3: Экстренная остановка при аномалиях — Если агент начинает выполнять действия вне рамок полномочий (например, принудительный сброс паролей без подтверждения), перейдите в задачу и нажмите Pause Work.

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

8. Экспорт и миграция всей структуры компании (Org Portability)

Контекст: Вся созданная компания в Paperclip — включая агентов, иерархию (Org Chart), настроенные рутины, историю задач, шаблоны решений и артефакты — не привязана намертво к одному серверу. Её можно экспортировать в виде единого конфигурационного пакета и развернуть на другой инфраструктуре.

Тайминг: ▶ 15:25, ▶ 15:46

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

Как применить:

• Шаг 1: Экспорт конфигурации — Перейдите в раздел Org, нажмите кнопку Export Organization в правом верхнем углу интерфейса. Скачайте архив со структурой.
• Шаг 2: Импорт на новом сервере — На свежем инстансе Paperclip перейдите в Org → Import Organization и загрузите сохранённый файл конфигурации.

Результат: Полностью переносимая, версионируемая виртуальная IT-компания.

FAQ

В: Чем Paperclip отличается от AutoGen, CrewAI или LangGraph? О: Paperclip — это Meta-Harness, а не просто библиотека для оркестрации. Он не заставляет вас писать код на Python для каждого агента, а объединяет уже существующие CLI-инструменты и движки (Claude Code, Hermes, OpenAI Codex, Pi) в визуальную организационную структуру с тикетами, ролями, решениями (Human-in-the-Loop) и расписаниями.

В: Нужно ли платить за Paperclip или это Open Source? О: Paperclip — это открытый проект (Open Source репозиторий на GitHub), который можно развернуть бесплатно на собственном оборудовании или VPS. Вы оплачиваете только API тех моделей, которые используют ваши агенты (Anthropic, OpenAI или бесплатные локальные модели через Ollama/Pi).

В: Как агенты общаются между собой, если нет общего чата? О: Агенты взаимодействуют исключительно через задачи и подзадачи (Task-driven communication). Агент-менеджер создаёт дочернюю задачу исполнителю, прикладывает контекст и артефакты. Исполнитель выполняет работу, прикрепляет результат и возвращает статус. Это исключает бесконечные галлюцинации и пустой флуд.

В: Можно ли использовать локальные модели без отправки данных в облако? О: Да. Paperclip поддерживает интеграцию с локальными движками (например, через harness Pi или локальные CLI-агенты). Вы можете назначить локальную модель на задачи сканирования сети, системного администрирования или анализа приватных логов.

В: Что делать, если агент зациклился или делает лишние действия? О: В интерфейсе каждой задачи есть элементы управления: кнопка Pause Subtree (ставит на паузу всю ветку подзадач), Cancel (отменяет задачу) и возможность ручного редактирования свойств задачи Советом директоров.

В: Где хранятся сгенерированные файлы и отчеты? О: Все сгенерированные файлы автоматически попадают в раздел Artifacts внутри Paperclip. Они сохраняются в файловой системе сервера и доступны для скачивания или использования другими агентами в качестве входных данных для последующих задач.

В: Что такое механизм Decisions? О: Это интерфейс эскалации вопросов к человеку (Human-in-the-Loop). Когда агенту не хватает прав, возникает развилка в стратегии или требуется физическое действие (например, замена сетевого модуля), агент создаёт тикет в Decisions с вариантами выбора для пользователя.

В: Как работают ежедневные Stand-up в Paperclip? О: Стендап настраивается через раздел Routines с триггером по расписанию (например, каждый день в 17:00). Каждый агент сканирует свои закрытые таски за день, формирует краткий отчёт и может автоматически задать вопрос другому агенту, если их задачи пересекаются.

Ресурсы и ссылки

• Paperclip — Мета-каркас (Meta-Harness) для управления мультиагентными AI-организациями — GitHub Репозиторий (упомянут в видео)
• Claude Code CLI — Терминальный агентский инструмент от Anthropic для кодинга и системных задач — Anthropic Claude Code (упомянут в видео)
• Hermes Agent — Автономный агентный фреймворк для системного администрирования и выполнения скриптов — упомянут в видео
• Pi Harness — Легковесный каркас для запуска локальных AI-агентов — упомянут в видео
• Flare — Платформа Threat Intelligence для мониторинга утечек данных, сессионных cookie и даркнета — упомянут в видео

Конспект создан на основе видео «I hired AI agents to fix my studio network (Paperclip)» канала NetworkChuck. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=7RVf25Rg0Mc