Обновлено 28 октября 2026 г.
AI-агенты и AgentOps

Paperclip

Оркестратор AI-агентов на своем сервере: общая очередь задач, ответственные, результаты, права доступа и расходы на модели. Развернули v2026.1023.0 на Fatmetal Cloud Server, замерили ресурсы и получили ответ модели в реальной задаче.

Проверено на версии v2026.1023.0, 28 октября 2026~12 минут чтенияFatmetal Team
AI-агентыЛицензия: MITПроверен OpenCode

Вердикт

Подходит
  • Руководителю нескольких AI-исполнителей: выдавать задания из общей очереди, видеть ответственного и сохраненный результат.
  • Инженеру, который подключает модели через общую учетную запись и хочет видеть расходы каждого агента.
Не подходит
  • Для одного личного помощника в мессенджере: организация, роли и очередь задач добавят лишнюю работу.
  • Для задач без проверки результата: в тесте модель неверно посчитала приоритеты у 100 заявок, хотя запуск завершился успешно.

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

Проверенный тариф: CPU4-RAM8-DISK100Сложность: средняяОбычный перезапуск: 29 сГлавный риск: качество результата и полномочия агентаПрименение: контролируемый пилот с человеком на приемке
Сценарий

Как собрать работу агентов в одном месте

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

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

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

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

Что изменилось с прошлого разбора

Прежняя опубликованная статья описывала v2026.817.0. В v2026.1023.0 поменялись установка, начало работы и контроль доступа; простая замена номера оставила бы другую инструкцию.

  • Задача по умолчанию открывается как разговор. Онбординг начинается с создания агента; появились Agent Chat, Connections и приватные задачи и проекты.
  • Сборке нужен Node.js от 24.11.0. Dockerfile включает Rust Runner, cargo-chef и tini. Ни Rust, ни Node отдельно на сервер ставить не требуется, если использовать готовый образ.
  • Operator получил 14 разрешений вместо одного, включая настройку агентов и подключений. Проверьте роли существующих участников после обновления.
  • Для бюджета неопределенная стоимость теперь по умолчанию означает блокировку: unpriced usage = block. Разрешение allow выбирают явно, принимая риск продолжения расходов.
  • Новые настройки исполнения используют full auto: ограничения и подтверждения задавайте явно. Старые явно заданные режимы сохраняются. У OpenCode проверьте переключатель Skip permissions в Harness / Runtime.
  • Legacy Composio удален без автоматического переноса. Включите enableMcpAggregators, создайте Composio Connect, заново авторизуйте его и назначьте права, затем удалите старые записи.

Перед переходом через v2026.1012.0 остановите все старые процессы, пишущие в каталог экземпляра: протокол блокировок сменился. Новые файлы .lock.sqlite удалять нельзя.

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

Альтернативы

Чем отличается от платных платформ

Paperclip дает общую панель для уже выбранных исполнителей. Relevance AI и коммерческая платформа CrewAI предлагают собственную организацию агентной работы; сравнивать только цену лицензии было бы недостаточно.

ВариантЦена входаЗа что еще платите
Paperclip на своем сервереMIT-лицензия: 0 руб.Сервер, модель, резервные копии и сопровождение
Relevance AI EnterpriseИндивидуальное предложениеActions, Vendor Credits и услуги по договору
CrewAI Basic / EnterpriseFree: 50 запусков workflow в месяц, 2 автоматизации; Enterprise по запросуРесурсы и возможности выбранного плана

Условия проверены 28 октября: Relevance AI, CrewAI. Для короткого пилота бесплатный CrewAI может оказаться удобнее собственного сервера. Числовой экономии относительно Enterprise эти прайсы не доказывают.

Российский VPS оплачивается в рублях. Прием российской карты этими SaaS не подтвержден; их условия не дают основания объявлять полный запрет для всех клиентов из России.

Устройство

Что остается на вашем сервере

Веб-приложение на Node.js обслуживает интерфейс React и запускает исполнителей. PostgreSQL хранит задачи и учет работы. Caddy принимает HTTPS и передает запросы приложению; база наружу не опубликована.

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

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

Node.js 24TypeScriptReactPostgreSQL 17Docker ComposeMIT
Ресурсы

Какой сервер выбрать

Проверенный стенд - CPU4-RAM8-DISK100: четыре vCPU, 8 ГБ памяти и 100 ГБ диска, Ubuntu 24.04. Аренда такого тарифа в проверенном каталоге стоит 1100 руб. в месяц.

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

i

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

В маркетплейсе Fatmetal

Не хотите ставить руками?

Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, после установки получаете рабочий домен, валидный TLS и файл с доступами.

Рекомендуемая конфигурация:
4 vCPU · 8 ГБ RAM · 100 ГБ NVMe от 990 ₽/мес

В маркетплейс →
Установка

Развертывание на Fatmetal Cloud Server

Подготовьте чистую Ubuntu 24.04, доступ root через sudo -i и доменное имя с A-записью на сервер. На Fatmetal можно использовать автоматически доступное имя IP-адреса с дефисами в зоне fatmetal.net.

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

  1. Подготовьте Docker

    Выполняйте команды от root на чистой Ubuntu 24.04. Docker установится с модулем Compose.

    apt-get update && apt-get install -y ca-certificates curl openssl
    curl -fsSL https://get.docker.com -o /tmp/get-docker.sh
    env -u VERSION sh /tmp/get-docker.sh
    install -d -m 700 /opt/paperclip && cd /opt/paperclip
  2. Создайте секреты и задайте адрес

    Вместо ваш-домен укажите имя, направленное на сервер. Случайные секреты сохраняются в закрытом файле .env.

    umask 077
    for key in POSTGRES_PASSWORD BETTER_AUTH_SECRET PAPERCLIP_TOOL_ACTION_SIGNING_SECRET; do printf '%s=%s\n' "$key" "$(openssl rand -hex 32)"; done > .env
    printf 'DOMAIN=ваш-домен\n' >> .env
  3. Запишите состав стека

    Это схема официального Compose с готовым образом вместо сборки, закрытой БД и внешним Caddy. Тег закрепляет проверенную версию.

    cat > compose.yml <<'YAML'
    name: paperclip
    services:
      db:
        image: postgres:17-alpine
        restart: unless-stopped
        environment: {POSTGRES_USER: paperclip, POSTGRES_DB: paperclip, POSTGRES_PASSWORD: '${POSTGRES_PASSWORD}'}
        volumes: [pgdata:/var/lib/postgresql/data]
        healthcheck:
          test: [CMD-SHELL, pg_isready -U paperclip -d paperclip]
          interval: 2s
          retries: 30
      server:
        image: ghcr.io/paperclipai/paperclip:2026.1023.0
        restart: unless-stopped
        pids_limit: 2048
        stop_grace_period: 90s
        ports: ['127.0.0.1:3100:3100']
        environment:
          DATABASE_URL: postgres://paperclip:${POSTGRES_PASSWORD}@db:5432/paperclip
          PORT: '3100'
          SERVE_UI: 'true'
          PAPERCLIP_DEPLOYMENT_MODE: authenticated
          PAPERCLIP_DEPLOYMENT_EXPOSURE: public
          PAPERCLIP_PUBLIC_URL: https://${DOMAIN}
          BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET}
          PAPERCLIP_TOOL_ACTION_SIGNING_SECRET: ${PAPERCLIP_TOOL_ACTION_SIGNING_SECRET}
          HTTP_PROXY: http://api-proxy.fatmetal.net:8080
          HTTPS_PROXY: http://api-proxy.fatmetal.net:8080
          NODE_USE_ENV_PROXY: '1'
          NO_PROXY: localhost,127.0.0.1,db,server,10.0.0.0/8,172.16.0.0/12,${DOMAIN}
        volumes: [paperclip-data:/paperclip]
        depends_on: {db: {condition: service_healthy}}
      caddy:
        image: caddy:2-alpine
        restart: unless-stopped
        network_mode: host
        volumes: ['./Caddyfile:/etc/caddy/Caddyfile:ro', caddy-data:/data, caddy-config:/config]
    volumes: {pgdata: {}, paperclip-data: {}, caddy-data: {}, caddy-config: {}}
    YAML
  4. Откройте HTTPS и запустите сервис

    Откройте входящие TCP 80 и 443. Caddy сам получает публичный сертификат; порт 3100 доступен только серверу. Дождитесь ответа health.

    printf 'ваш-домен {\n  reverse_proxy 127.0.0.1:3100\n}\n' > Caddyfile
    docker compose pull
    docker compose up -d
    until curl -fsS http://127.0.0.1:3100/api/health; do sleep 2; done
  5. Получите приглашение владельца

    Команда печатает одноразовую ссылку. Откройте ее и создайте учетную запись. Если появится кнопка Accept invite, нажмите ее; форма также может сразу перейти к созданию организации. Сохраните ссылку до завершения входа, затем удалите ее из истории терминала.

    cat > bootstrap.json <<'JSON'
    {"$meta":{"version":1,"updatedAt":"2026-10-28T00:00:00Z","source":"configure"},"database":{"mode":"postgres"},"logging":{"mode":"file"},"server":{"deploymentMode":"authenticated","exposure":"public","host":"0.0.0.0"},"auth":{"baseUrlMode":"explicit","publicBaseUrl":"https://ваш-домен"},"telemetry":{"enabled":false}}
    JSON
    chmod 644 bootstrap.json
    docker compose cp bootstrap.json server:/tmp/bootstrap.json
    docker compose exec -T --user node server pnpm paperclipai auth bootstrap-ceo --config /tmp/bootstrap.json
  6. Создайте организацию без привязки к первому провайдеру

    Мастер предлагает только Claude или OpenAI. Для OpenRouter создайте организацию штатным CLI: первая команда напечатает ссылку, откройте ее под владельцем и нажмите Approve CLI access. Дождитесь возврата в терминал, затем выполните вторую команду.

    docker compose exec -T --user node server pnpm paperclipai auth login --no-browser --instance-admin --config /tmp/bootstrap.json --api-base https://ваш-домен
    docker compose exec -T --user node server pnpm paperclipai company create --config /tmp/bootstrap.json --api-base https://ваш-домен --payload-json '{"name":"Article Check"}'

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

Первая задача

Как подключить модель и получить результат

Откройте Connectors, добавьте подключение OpenRouter и введите свой ключ. На странице Permissions выберите людей и агентов, которым разрешено его использовать; общий доступ всей компании включайте осознанно.

Paperclip
Connections: доступ людей и агентов к общей учетной записи OpenRouter
Connections разделяет доступ людей к учетной записи и доступ агентов к соединению. На стенде выбран общий доступ внутри тестовой организации. Секрет API на экране не показан.

Создайте агента с адаптером OpenCode, выберите сохраненное подключение и модель OpenAI: GPT-4o-mini. В Harness / Runtime нажмите Run test, сохраните настройки и назначьте задачу кнопкой Assign Task.

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

i

Прокси к внешним API api-proxy.fatmetal.net:8080 входит в VPS. В Compose выше заданы его переменные, включая NODE_USE_ENV_PROXY для Node; провайдера и ключ выбираете вы.

Paperclip
Задача REL-2 с русским ответом модели и статусом Done
Ответ OpenRouter/GPT-4o-mini сохранен в задаче. Статус Done выставлен проверяющим вручную. Текст модели является тестовым результатом, а не проверенной инструкцией обновления.
Замеры

Сколько потребляет стек и что показала задача

На панели были два тестовых агента и 103 задачи. Из них 100 задач созданы синтетически для замера.

Три сервиса в простое1083 МиБ: приложение 976, БД 92, Caddy 15
Пик при одном агенте1538 МиБ, 3,33 vCPU
Распакованный образ Paperclip8,77 ГиБ; три образа вместе 9,12 ГиБ
Перезапуск до публичного HTTPS29 секунд с уже загруженными образами
Отклик страницы через HTTPSМедиана 20 мс
Рост БД: 100 задач и один ответ0,84 МиБ

Обычный OpenCode получил ответ через OpenRouter за 15 секунд. Для проверки ему дали свести 100 синтетических заявок: вызов завершился, но модель ошиблась в распределении приоритетов - 25/35/40 вместо 20/40/40.

Задача осталась In Review: неверный ответ не был принят.

Costs записал пять тестовых API-запусков на сумму $0.04. Еще у одного запуска стоимость отсутствует; интерфейс показывает этот пробел отдельно. Эти суммы относятся к запросам модели.

Paperclip
Costs: расходы на API по агенту и пользователю, бюджет и финансовые события
Расходы пяти завершенных тестовых вызовов показаны в долларах и не являются ценой VPS. Один запуск отмечен как cost unavailable; отсутствие стоимости не заменено нулем.

Проверено на версии v2026.1023.0, 28 октября 2026. На новых версиях результаты могут отличаться.

Диагностика

Где может сломаться

CLI требует config при создании приглашения

Причина. В Docker нет конфигурации локальной установки, которую ищет CLI.

Решение. Создайте bootstrap.json с правами 644 и передайте --config /tmp/bootstrap.json, как в последнем шаге установки. Не публикуйте напечатанное приглашение.

Caddy продолжает использовать старый файл

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

Решение. После изменения Caddyfile пересоздайте контейнер.

docker compose up -d --no-deps --force-recreate caddy

Остальные сервисы останутся запущенными.

429: too many certificates already issued

Причина. Для переиспользованного IP и имени исчерпан лимит Let's Encrypt.

Решение. Прочитайте срок retry-after в журнале и дождитесь его либо используйте собственное доменное имя с A-записью на этот сервер.

docker compose logs --tail=100 caddy

Имя в .env, Caddyfile и настройке публичного адреса должно совпадать.

Для проверки состояния приложения используйте docker compose ps и docker compose logs --tail=100 server. Ответ health означает готовность API; проверку модели завершает ответ в задаче.

Эксплуатация

Как сохранить данные и обновить версию

Выполняйте команды из /opt/paperclip. Сначала поставьте агентов на Pause и дождитесь завершения запусков, затем остановите приложение. Копия содержит ключи доступа: храните ее закрытой и выносите с сервера.

mkdir -p backup && chmod 700 backup
docker compose stop server
docker compose exec -T db pg_dump -U paperclip -d paperclip -Fc > backup/db.dump
docker compose run --rm --no-deps --entrypoint tar server -C /paperclip -czf - . > backup/files.tgz
cp .env compose.yml Caddyfile backup/
docker compose up -d server

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

docker compose stop server
docker compose exec -T db dropdb -U paperclip paperclip
docker compose exec -T db createdb -U paperclip paperclip
docker compose exec -T db pg_restore -U paperclip -d paperclip --exit-on-error < backup/db.dump
docker compose run --rm --no-deps --entrypoint sh server -c 'find /paperclip -mindepth 1 -delete; tar -xzf - -C /paperclip' < backup/files.tgz
cp backup/.env backup/compose.yml backup/Caddyfile .
docker compose up -d --force-recreate

Для обновления сохраните копию, остановите все старые экземпляры приложения и локальные исполнители с доступом к тому же каталогу. Затем смените тег и запустите стек; база проходит миграции автоматически.

docker compose down
sed -i 's|image: ghcr.io/paperclipai/paperclip:.*|image: ghcr.io/paperclipai/paperclip:2026.1023.0|' compose.yml
docker compose pull && docker compose up -d
docker compose logs --tail=100 server

Не используйте down -v: он удалит тома. После обновления проверьте вход, старую задачу, подключение модели и один новый ответ. Откат делайте восстановлением копии вместе с прежней версией приложения.

Безопасность

Уязвимости прошлых версий

Десять бюллетеней указывают исправление в v2026.416.0, раньше августовской статьи. У двух исправленная версия не названа: считать их закрытыми в октябре нельзя. Для старых установок используйте порядок копирования и обновления выше.

БюллетеньУровеньЗатронуты / исправленоРиск
GHSA-vr7g-88fq-vhq3critical<2026.416.0 / 2026.416.0Команда при архивировании
GHSA-47wq-cj9q-wpmpcritical<= 2026.411.0-canary.8 / 2026.416.0Ключ чужой компании
GHSA-3xx2-mqjm-hg9xcritical<= 2026.410.0-canary.1 / 2026.416.0Доступ к чужим ключам
GHSA-68qg-g8mg-6pr7 / CVE-2026-41679critical< 2026.416.0 / 2026.416.0Импорт приводит к выполнению команд
GHSA-x8hx-rhr2-9rf7critical<0.3.1 / не указаноDNS rebinding, local_trusted
GHSA-gqqj-85qm-8qhfhigh2026.403.0 / не указаноНаследование внешних коннекторов
GHSA-xfqj-r5qw-8g4jhigh<0.3.1 / 2026.416.0API без проверки пользователя
GHSA-w8hx-hqjv-vjcqhigh<2026.416.0 / 2026.416.0Команда через вредоносный skill
GHSA-265w-rf2w-cjh4 / CVE-2026-41208high<= v0.3.1 / 2026.416.0Команда через workspaceStrategy
GHSA-p7mm-r948-4q3qmedium<= 2026.410.0-canary.1 / 2026.416.0Подмена автора согласования
GHSA-fpw4-p57j-hqmqmedium<= 2026.410.0-canary.1 / 2026.416.0XSS через Markdown
GHSA-3pw3-v88x-xj24medium<= v0.3.1 / 2026.416.0Чтение произвольного файла

Узкие опубликованные диапазоны не включают августовскую и октябрьскую версии, но сами по себе не доказывают устранения двух неполных бюллетеней. Не включайте local_trusted для публичной установки.

С августа вендор отдельно исправлял изоляцию компаний, обработку неверного bearer, раскрытие переменных и проверку разрешений инструментов. Для этих изменений не опубликованы CVE/GHSA и степень серьезности; это не новые названия апрельских уязвимостей.

Ограничения

Когда это НЕ ваш выбор

Нужна работа нового Runner без отладки

Проверка подключения прошла, но реальная задача закончилась run.prepare timed out. Рабочий путь в разборе использует обычный OpenCode. Причина таймаута глубже подготовки протокола не установлена.

Paperclip
Неудачный запуск Paperclip Runner с ошибкой run.prepare timed out и задачей Blocked
Новый Paperclip Runner прошел проверку подключения, но реальная задача завершилась таймаутом подготовки. Кадр показывает сохраненную ошибку; причина глубже протокольной подготовки не установлена.

Нужен полностью русский интерфейс

Рабочие экраны остались английскими при локали браузера ru-RU. В Profile нет переключателя; три русские строки начального экрана не означают перевода приложения.

Остановка должна подтверждаться однозначно

У обычного OpenCode статус API стал paused и активных запусков не осталось, но фаза Pausing agent сохранилась. Завершение остановки ресурсов по одному статусу paused считать подтвержденным нельзя.

Нужна изоляция враждебных исполнителей

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

Рядом

С чем использовать Paperclip

  • OpenClaw - когда нужен личный помощник и вход из мессенджера.
  • LobeHub - когда важнее общий чат с моделями, чем распределение задач между исполнителями.

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

FAQ

Частые вопросы

Paperclip бесплатный?

Код под MIT. Сервер, модель и сопровождение оплачиваются отдельно; лицензия не включает бесплатные запросы к модели.

Нужно устанавливать Rust и Node на сервер?

Для готового Docker-образа нет: зависимости уже внутри. В инструкции используется тег 2026.1023.0.

Как закрыть доступ к ключу модели?

Connectors → нужное подключение → Permissions. Выберите конкретных людей и агентов вместо общего доступа компании.

Почему бюджет остановил работу без известной суммы?

В новой версии unpriced usage по умолчанию блокирует работу по бюджетной политике. Разрешение allow задается явно; сначала разберите пропущенную стоимость.

Что делать после ответа агента?

Проверить содержание и перевести задачу в Done либо оставить In Review. Статус succeeded у запуска означает завершение вызова.

Итог

Paperclip собирает задания, ответы, доступ к моделям и учет расходов в одном рабочем пространстве. Начинайте с обычного OpenCode, одной понятной задачи и человека, который примет результат; затем расширяйте общую очередь.

Рекомендуемая конфигурация для установки:
4 vCPU · 8 ГБ RAM · 100 ГБ NVMe

Не хотите устанавливать вручную?

Запустите Paperclip на этой конфигурации автоматически - от 990 ₽/мес.

Запустить Paperclip →
Анонсы новых разборов в Telegram-канале Новые гайды и карточки в маркетплейсе первыми @fatmetal_channel →

Этот стек у нас запущен на тарифе CPU4-RAM8-DISK100. Нашли баг в гайде - напишите, поправим в течение дня.