インストール
https://github.com/paperclipai/paperclip#quickstart対象ユーザー
Paperclip はオープンソースの AI エージェントオーケストレーション・ツールで、その比喩は明快です。エージェントは雇用した社員であり、Paperclip はその会社そのもの。Node.js サービスと React の UI から成り、エージェントは自分で導入します。したがって、すでにコーディングエージェントを使っていて、そのエージェントのタスク・権限・履歴を一か所にまとめたい技術リーダーや小さなチームに向いています。
典型的な利用者は3パターンです。20個前後の Claude Code ターミナルを同時に開いていて、誰が何をしているか掌握できない。エージェントに 7×24 で自律的に動かしつつ、いつでも進捗を確認して必要なときに割り込みたい。各エージェントに上限予算を設定してコストを抑えたいリーダー。
もう一つ硬い前提があります。エージェントは自分で用意します。リポジトリのトップページには「bring your own agents」と明記されており、モデルと実行フレームワークも個別に選びます。プラットフォームが担当するのはスケジュール管理、経費の記録、そして予算の強制です。
「一度のタスクを単一のエージェントに終わらせて終わり」には向きません。「目標の設定 → チームの雇用 → 承認して実行」という流れが逆に重荷になります。使えるエージェントのアカウントやモデルの利用枠が手元にない場合にも着手しない方がよい。エージェントもモデルも自分で用意するからです。
3分で最初の試行を終える
公式の経路はひとつだけ、GitHub リポジトリのトップページにある Quickstart セクションです。
- https://github.com/paperclipai/paperclip
- https://docs.paperclip.ing/
検証できたのは「公式の入口はリポジトリ内の Quickstart セクションである」という範囲までです。具体的なコマンドは Quickstart とドキュメントサイトを正としてください。ここでは未検証のコマンドを再現しません。
- 前提を準備する: Node.js の実行環境と、自分自身のエージェントを少なくとも1つ（Codex または Claude）。
- インストール場所: Quickstart に従って、ローカルでサービスと UI を起動します。証拠にはグローバルなインストール先もパッケージ名も示されていないため、他所のインストール手順をそのまま流用しないでください。
- リスクの低いタスクを起動する: 読み取り専用の分析目標を作成します（例: 「あるリポジトリの構造を分析して改善点のリストを出す」）。まずはエージェントを1つだけ割り当て、提示された戦略を確かめ、上限予算を小さな数値にしてから実行を押します。この段階ではファイル書き込み、コマンド実行、外部呼び出しをさせません。
- 副作用の範囲を先に確かめる: エージェントは起動すると自律的に動き続け、実際の費用が発生します。上限予算と読み取り専用タスクがこのラウンドの唯一のガードレールです。まず予算を小さく設定してください。
- 成功のサインを見守る: ダッシュボードにその目標とタスクの項目が現れ、各エージェントの進捗と費用の実績が確認でき、累計費用が上限予算を超えていないこと。
最初のラウンドでやってはいけないこと: 十数個のエージェントを一気に割り当てないこと、まだ予算を設定していない状態で実行を押さないこと。
活用事例
事例1: 複数のエージェントが同じ目標を並行して進め、進捗が人間の記憶に依存しなくなります。リポジトリは「20個の Claude Code ターミナルを同時に開いていて、誰が何をしているかを見失う」ことを、そのまま適用シーンとして挙げています。進め方は OpenClaw、Codex、Claude、Cursor など異なるエージェントを同じ目標の下に統一して割り当て、それぞれにモデルと実行フレームワークを選ばせ、タスク・スキル・権限・履歴を同じ場所に残すことです。その後はダッシュボードから誰が何をして、どれだけコストがかかったかを見るだけで、ターミナルを一つずつ漁る必要はありません。誰が進んでいるか、どこまで進んだかは一つのパネルで把握できます。
事例2: 「目標を設定 → チームを雇用 → 承認して実行」を運営のループとして管理します。リポジトリが示す3ステップは、まず目標を定義する（例: AI ノートアプリを $1M MRR まで成長させる）、次に CEO、CTO、エンジニア、デザイナー、マーケティングなどの役割を持つエージェントのチームを組む（任意のボット、任意のベンダー）、最後に承認して実行する — 戦略を点検し、予算を設定し、スタートを押し、ダッシュボードから継続的に監視します。これは原文が示しているサンプルフローであり、推測した使い方ではありません。役割の割り当て方やエージェントの接続手順は、Quickstart とドキュメントサイトに従ってください。
使用の限界
- 検証できた範囲はリポジトリのトップページのみです。ポジショニング（AI エージェントを業務に投入するオープンソースのオーケストレーション）、技術的な形態、3ステップの中核フロー、そして「エージェントが 24/7 自律的に動き、人間が随時確認して割り込み、コストを監視して予算を強制する」という要件のまとまり。インストールコマンド、ディレクトリ構成、アカウントの紐付け方法は検証範囲外です。
- エージェントは自律的に動き続け実際の費用が発生するため、コスト監視と予算の強制はプラットフォームの機能であると同時に、実行の前提でもあります。
- エージェント、モデル、実行フレームワークはすべて自分で用意します。Paperclip がエージェントのアカウントを代わりに管理することはありません。
- 最初のラウンドは読み取り専用で、元に戻せる分析タスクを選んでください。ファイル書き込み、コマンド実行、外部呼び出しを伴う場合は、影響の範囲と予算を確認してから許可してください。
- タスクを1回だけ実行したい場合には、この流れは重すぎます。複数エージェント、長時間運用、予算制約のあるシーンで恩恵が享受できます。
- 各エージェントの対応深度、同時実行数、障害復旧の方法はリポジトリのトップページには書かれていません。公式ドキュメントサイトを正としてください。