Paperclip orchestration agents IA : le dépôt paperclipai/paperclip propose un serveur Node.js et une interface React pour piloter une équipe d’agents IA comme on pilote un gestionnaire de tâches, avec organigramme, budgets et validations. Il affichait environ 103 000 étoiles à la mi-octobre 2026. Le projet se résume lui-même ainsi : « Si OpenClaw est un employé, Paperclip est l’entreprise ».
Pour une équipe d’exploitation, l’intérêt est ailleurs que dans la métaphore : dès qu’une dizaine d’agents tournent en parallèle, on ne sait plus qui a fait quoi, combien cela a coûté, ni quel agent a le droit de toucher à quoi. Paperclip prétend répondre à ces trois questions (activité, coûts, permissions). Cet article présente ce que dit le dépôt, comment l’installer d’après le README, et comment superviser une telle flotte d’agents.
Les informations viennent du README et de la documentation du projet. span.observer n’a pas installé Paperclip : l’image et le schéma ci-dessous viennent du dépôt.
Paperclip orchestration agents IA : ce que dit le dépôt
- Licence : MIT. Le fichier LICENSE indique « Copyright (c) 2025 Paperclip AI », alors que le pied de page GitHub mentionne « Paperclip Labs, Inc. » ; le nom de l’entité varie selon la page.
- Technologie : serveur Node.js (24.11 ou plus récent) et interface React, base PostgreSQL embarquée en local.
- Dernière version : v2026.1012.0, publiée le 12 octobre 2026, après v2026.1005.0 et v2026.1001.0 : des versions toutes les une à deux semaines.
- Positionnement : « pas un framework d’agents » (le README) : vos agents (Claude Code, Codex, Cursor, Gemini CLI, OpenClaw, processus ou webhooks personnalisés) restent ce qu’ils sont, Paperclip les organise en entreprise avec objectifs, rôles et budgets.
- Offre commerciale : le README renvoie aussi vers une liste d’attente pour « Paperclip Cloud » ; le logiciel auto-hébergé n’exige pas de compte.

Le schéma du dépôt range les fonctions en quatre piliers : tâches et validations, organigramme et permissions, formation et évaluation des agents, infrastructure (exécution multi-fournisseurs, sandbox, SSO, contrôles de coûts, historique des exécutions et traçage « opt-in »).
Installer Paperclip d’après le README
Étape 1 — Lancer l’intégration
npx paperclipai@latest onboard --yes
Le README précise que la commande s’exécute depuis le cache npm et que la configuration et les données restent en local. Par défaut, le démarrage rapide utilise le mode « local de confiance » en boucle locale. Pour démarrer en mode authentifié, choisissez un préréglage de liaison :
npx paperclipai@latest onboard --yes --bind lan
# ou
npx paperclipai@latest onboard --yes --bind tailnet
Si Paperclip est déjà configuré, relancer onboard conserve la configuration ; npx paperclipai configure permet de la modifier.
Étape 2 — Essayer sans rien engager
Le README décrit test-drive : une instance de test isolée, déjà initialisée avec un agent « CEO », qui reste au premier plan et ne crée ni service ni première tâche.
ANTHROPIC_API_KEY=... npx paperclipai test-drive
Étape 3 — Ou depuis les sources
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev
L’interface et l’API démarrent sur http://localhost:3100, avec une base PostgreSQL embarquée. Prérequis : Node.js 24.11 et pnpm 9.15 ou plus récents. Pour un usage durable, le README conseille de pointer vers votre propre PostgreSQL et décrit un déploiement Docker.
Sous le capot
Le README publie un schéma d’architecture : un serveur unique regroupe l’identité et les accès, les tâches, l’exécution par « heartbeat », la gouvernance, l’organigramme, les espaces de travail, les plugins, le budget, les routines, les secrets, l’activité et les événements.

Deux mécanismes comptent pour la fiabilité : le « checkout » atomique des tâches (un seul agent par tâche, avec des verrous d’exécution) et les arrêts de budget (« hard stops »).
Superviser une équipe d’agents Paperclip
Un orchestrateur concentre les risques : il décide qui travaille, avec quels secrets et à quel prix. Les mesures de coût d’un agent IA et de garde-fous s’appliquent donc deux fois : au niveau de chaque agent et au niveau de l’orchestrateur.
Le menu Audit : activité, exécutions, coûts, budgets
La documentation décrit une page Audit à cinq onglets : Activity, Runs, Costs, Budgets et Timeline.
- Activity : chaque modification (statut d’une tâche, commentaire, embauche, pause d’un agent, approbation, dépense) est enregistrée avec l’acteur, l’action, l’entité, les détails et l’horodatage. Un interrupteur permet de ne garder que les actions d’agents.
- Costs : pour chaque appel, Paperclip enregistre l’agent, le modèle, le nombre de tokens et le coût en dollars, agrégés par agent et par mois calendaire UTC. La documentation précise que le montant retenu est celui facturé après remise de cache, et que les tokens en cache sont comptés à part.
- Budgets : des seuils par entreprise, agent ou projet. D’après la documentation, un avertissement est enregistré à 80 % et l’agent est mis en pause automatiquement à 100 %.
Le README nuance l’arrêt : il s’appuie sur la dépense enregistrée, et le retard de déclaration d’usage ou le travail en cours peuvent le retarder. Un plafond de budget est un garde-fou, pas une garantie au centime.
Et OpenTelemetry ?
Dans le README et les pages de documentation consultées, je n’ai pas trouvé d’export OpenTelemetry documenté. Le projet mentionne un système de plugins (« suivi personnalisé » en exemple) et un historique d’exécutions avec traçage « opt-in ». Si vous avez besoin de traces dans votre backend, vérifiez la documentation des plugins et de l’API (coûts, activité) avant de promettre un tableau de bord : sinon, interrogez l’API des coûts et de l’activité, et instrumentez les agents eux-mêmes comme dans l’observation des agents MCP.
Comment vérifier que ça fonctionne
- Un agent de test reçoit une tâche : l’onglet Activity montre le changement de statut, l’onglet Runs l’exécution, l’onglet Costs une ligne de coût pour le modèle utilisé.
- Un budget volontairement bas déclenche l’alerte à 80 % puis la pause à 100 % : vérifiez que l’incident apparaît dans Budgets.
- Le total mensuel de Paperclip est cohérent avec la console du fournisseur de modèles, à la remise de cache près.
Limites et points ouverts
- Croissance et jeunesse. Plus de 100 000 étoiles et des versions hebdomadaires : l’attention est massive, la stabilité des interfaces reste à démontrer. Plusieurs fonctions du README sont marquées « expérimentales » (Agent Chat, connecteurs de messagerie).
- Revendications du README. Le texte vante l’orchestration de « businesses autonomes » ; aucun résultat chiffré n’est vérifiable depuis le dépôt. Le projet répond lui-même à la question « est-il maintenu ? » en citant plus de 2 700 demandes de fusion acceptées : c’est une déclaration du projet.
- Droits des agents. Le mode par défaut est « local de confiance » ; les agents invoqués (Claude Code, Codex, shell) gardent leurs propres droits sur la machine. L’orchestration n’est pas de l’isolation : combinez-la avec un runtime isolé comme NVIDIA OpenShell.
- Dépenses réelles. La documentation avertit que les agents font de vrais appels facturés ; fixez un budget avant d’automatiser.
Bonnes pratiques
- Commencez par
test-driveet un budget bas ; élargissez ensuite. - Gardez le mode local de confiance pour un poste personnel ; sinon utilisez le mode authentifié et un réseau privé.
- Donnez à chaque agent un budget et des secrets distincts, et revoyez l’onglet Activity chaque semaine.
- Exportez régulièrement coûts et activité vers votre outil de supervision, et alertez sur l’écart entre dépense Paperclip et facture fournisseur.
- Traitez un agent en boucle comme un incident de fiabilité, sans chercher de coupable.
Questions fréquentes
Paperclip remplace-t-il OpenClaw ou Claude Code ?
Non. Selon le README, Paperclip utilise ces agents et les organise en équipe. Voir notre article sur OpenClaw.
Paperclip est-il gratuit ?
Le code est sous licence MIT et l’auto-hébergement ne demande pas de compte. Les appels aux modèles sont facturés par votre fournisseur ; une offre cloud est annoncée par liste d’attente.
Où sont stockées les données ?
En local, un processus Node.js gère une base PostgreSQL embarquée et un stockage de fichiers local ; en production, le README propose votre propre PostgreSQL.
Conclusion
Paperclip répond à un vrai besoin : rendre une flotte d’agents lisible, avec une activité auditable et des budgets. Il reste un projet à très forte croissance, dont les fonctions évoluent vite et dont les affirmations doivent être relues sur le dépôt. Traitez-le comme un service privilégié : budgets bas, isolation des agents et revue régulière de l’onglet Audit.
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC ni aux projets cités. Les marques citées appartiennent à leurs propriétaires. Les outils évoluent vite : vérifiez les commandes et options dans leur documentation officielle (docs.paperclip.ing).