Paperclip
Оркестратор AI-агентов на своем сервере: общая очередь задач, ответственные, результаты, права доступа и расходы на модели. Развернули v2026.1023.0 на Fatmetal Cloud Server, замерили ресурсы и получили ответ модели в реальной задаче.
Вердикт
- Руководителю нескольких AI-исполнителей: выдавать задания из общей очереди, видеть ответственного и сохраненный результат.
- Инженеру, который подключает модели через общую учетную запись и хочет видеть расходы каждого агента.
- Для одного личного помощника в мессенджере: организация, роли и очередь задач добавят лишнюю работу.
- Для задач без проверки результата: в тесте модель неверно посчитала приоритеты у 100 заявок, хотя запуск завершился успешно.
Paperclip сохраняет ответ и показывает ход работы, а правильность результата проверяет человек.
Как собрать работу агентов в одном месте
Пока агентов двое, задания можно раздавать в отдельных окнах. Когда исполнители передают работу друг другу, приходится искать последний ответ, восстанавливать контекст и выяснять, кто потратил деньги.
Paperclip связывает задачу с исполнителем, обсуждением и журналом запусков. Подключение хранит учетные данные модели, а разрешения определяют, какие люди и агенты могут ими пользоваться.
Практический цикл выглядит так: создать задачу, назначить агента, дождаться ответа, проверить содержание и изменить статус. В Costs можно открыть расходы исполнителя, а из его Runs перейти к конкретному запуску.
Что изменилось с прошлого разбора
Прежняя опубликованная статья описывала 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 / Enterprise | Free: 50 запусков workflow в месяц, 2 автоматизации; Enterprise по запросу | Ресурсы и возможности выбранного плана |
Условия проверены 28 октября: Relevance AI, CrewAI. Для короткого пилота бесплатный CrewAI может оказаться удобнее собственного сервера. Числовой экономии относительно Enterprise эти прайсы не доказывают.
Российский VPS оплачивается в рублях. Прием российской карты этими SaaS не подтвержден; их условия не дают основания объявлять полный запрет для всех клиентов из России.
Что остается на вашем сервере
Веб-приложение на Node.js обслуживает интерфейс React и запускает исполнителей. PostgreSQL хранит задачи и учет работы. Caddy принимает HTTPS и передает запросы приложению; база наружу не опубликована.
Отдельный том /paperclip содержит файлы, рабочие каталоги, журналы и ключ шифрования сохраненных доступов. Поэтому копии одной базы недостаточно: нужен также этот том и файл .env.
Текст задания и нужный контекст уходят выбранному провайдеру модели. Собственный сервер сохраняет контроль над базой и файлами, но не делает внешнюю обработку локальной.
Какой сервер выбрать
Проверенный стенд - CPU4-RAM8-DISK100: четыре vCPU, 8 ГБ памяти и 100 ГБ диска, Ubuntu 24.04. Аренда такого тарифа в проверенном каталоге стоит 1100 руб. в месяц.
Во время работы одного агента короткий пик достиг 3,33 vCPU. Поэтому рекомендация оставляет четыре ядра; восемь гигабайт памяти входят в готовый тариф, а не следуют из потребления приложения.
Бюджет проекта складывается из аренды, запросов модели и сопровождения. Ограничения стоимости задавайте также у провайдера: учет 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. Для первого скачивания большого образа оставьте время: на стенде оно заняло около десяти минут.
Подготовьте 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Создайте секреты и задайте адрес
Вместо ваш-домен укажите имя, направленное на сервер. Случайные секреты сохраняются в закрытом файле .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Запишите состав стека
Это схема официального 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Откройте 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Получите приглашение владельца
Команда печатает одноразовую ссылку. Откройте ее и создайте учетную запись. Если появится кнопка 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Создайте организацию без привязки к первому провайдеру
Мастер предлагает только 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 выберите людей и агентов, которым разрешено его использовать; общий доступ всей компании включайте осознанно.
Создайте агента с адаптером OpenCode, выберите сохраненное подключение и модель OpenAI: GPT-4o-mini. В Harness / Runtime нажмите Run test, сохраните настройки и назначьте задачу кнопкой Assign Task.
Например, попросите составить план обновления с условиями отката. Ответ появится в обсуждении задачи. Проверьте его, прежде чем выставлять Done: на стенде агент написал о завершении, но статус изменил проверяющий.
Прокси к внешним API api-proxy.fatmetal.net:8080 входит в VPS. В Compose выше заданы его переменные, включая NODE_USE_ENV_PROXY для Node; провайдера и ключ выбираете вы.
Сколько потребляет стек и что показала задача
На панели были два тестовых агента и 103 задачи. Из них 100 задач созданы синтетически для замера.
| Три сервиса в простое | 1083 МиБ: приложение 976, БД 92, Caddy 15 |
| Пик при одном агенте | 1538 МиБ, 3,33 vCPU |
| Распакованный образ Paperclip | 8,77 ГиБ; три образа вместе 9,12 ГиБ |
| Перезапуск до публичного HTTPS | 29 секунд с уже загруженными образами |
| Отклик страницы через HTTPS | Медиана 20 мс |
| Рост БД: 100 задач и один ответ | 0,84 МиБ |
Обычный OpenCode получил ответ через OpenRouter за 15 секунд. Для проверки ему дали свести 100 синтетических заявок: вызов завершился, но модель ошиблась в распределении приоритетов - 25/35/40 вместо 20/40/40.
Задача осталась In Review: неверный ответ не был принят.
Costs записал пять тестовых API-запусков на сумму $0.04. Еще у одного запуска стоимость отсутствует; интерфейс показывает этот пробел отдельно. Эти суммы относятся к запросам модели.
Проверено на версии v2026.1023.0, 28 октября 2026. На новых версиях результаты могут отличаться.
Где может сломаться
Причина. В Docker нет конфигурации локальной установки, которую ищет CLI.
Решение. Создайте bootstrap.json с правами 644 и передайте --config /tmp/bootstrap.json, как в последнем шаге установки. Не публикуйте напечатанное приглашение.
Причина. Файл под подключением с хоста был заменен новым, а контейнер сохранил прежнее подключение.
Решение. После изменения Caddyfile пересоздайте контейнер.
docker compose up -d --no-deps --force-recreate caddyОстальные сервисы останутся запущенными.
Причина. Для переиспользованного 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-vhq3 | critical | <2026.416.0 / 2026.416.0 | Команда при архивировании |
| GHSA-47wq-cj9q-wpmp | critical | <= 2026.411.0-canary.8 / 2026.416.0 | Ключ чужой компании |
| GHSA-3xx2-mqjm-hg9x | critical | <= 2026.410.0-canary.1 / 2026.416.0 | Доступ к чужим ключам |
| GHSA-68qg-g8mg-6pr7 / CVE-2026-41679 | critical | < 2026.416.0 / 2026.416.0 | Импорт приводит к выполнению команд |
| GHSA-x8hx-rhr2-9rf7 | critical | <0.3.1 / не указано | DNS rebinding, local_trusted |
| GHSA-gqqj-85qm-8qhf | high | 2026.403.0 / не указано | Наследование внешних коннекторов |
| GHSA-xfqj-r5qw-8g4j | high | <0.3.1 / 2026.416.0 | API без проверки пользователя |
| GHSA-w8hx-hqjv-vjcq | high | <2026.416.0 / 2026.416.0 | Команда через вредоносный skill |
| GHSA-265w-rf2w-cjh4 / CVE-2026-41208 | high | <= v0.3.1 / 2026.416.0 | Команда через workspaceStrategy |
| GHSA-p7mm-r948-4q3q | medium | <= 2026.410.0-canary.1 / 2026.416.0 | Подмена автора согласования |
| GHSA-fpw4-p57j-hqmq | medium | <= 2026.410.0-canary.1 / 2026.416.0 | XSS через Markdown |
| GHSA-3pw3-v88x-xj24 | medium | <= v0.3.1 / 2026.416.0 | Чтение произвольного файла |
Узкие опубликованные диапазоны не включают августовскую и октябрьскую версии, но сами по себе не доказывают устранения двух неполных бюллетеней. Не включайте local_trusted для публичной установки.
С августа вендор отдельно исправлял изоляцию компаний, обработку неверного bearer, раскрытие переменных и проверку разрешений инструментов. Для этих изменений не опубликованы CVE/GHSA и степень серьезности; это не новые названия апрельских уязвимостей.
Когда это НЕ ваш выбор
Нужна работа нового Runner без отладки
Проверка подключения прошла, но реальная задача закончилась run.prepare timed out. Рабочий путь в разборе использует обычный OpenCode. Причина таймаута глубже подготовки протокола не установлена.
Нужен полностью русский интерфейс
Рабочие экраны остались английскими при локали браузера ru-RU. В Profile нет переключателя; три русские строки начального экрана не означают перевода приложения.
Остановка должна подтверждаться однозначно
У обычного OpenCode статус API стал paused и активных запусков не осталось, но фаза Pausing agent сохранилась. Завершение остановки ресурсов по одному статусу paused считать подтвержденным нельзя.
Нужна изоляция враждебных исполнителей
Общий контейнер с локальными агентами не является отдельной защищенной машиной для каждого. Не выдавайте непроверенным заданиям доступ к рабочим секретам и чужим каталогам.
С чем использовать Paperclip
- OpenClaw - когда нужен личный помощник и вход из мессенджера.
- LobeHub - когда важнее общий чат с моделями, чем распределение задач между исполнителями.
Paperclip выбирают, когда отдельные ответы уже складываются в процесс с очередью и приемкой. Сначала подключите одного исполнителя и завершите одну задачу, затем добавляйте роли и общие учетные записи.
Частые вопросы
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 ₽/мес.
Этот стек у нас запущен на тарифе CPU4-RAM8-DISK100. Нашли баг в гайде - напишите, поправим в течение дня.