Paperclip

複数Agentを単なる並列実行ではなく、役割・上司・目標を持つ組織として管理する

公式READMEはPaperclipを、AIエージェントのチームを運営するためのNode.js serverとReact UIとして説明しています。Agentごとに役割・役職・報告ライン・権限・予算を持たせ、組織のmissionやgoalからtaskへ文脈をつなげられます。OpenClaw、Claude Code、Codex、Cursor、Bash、HTTP/Webhook Botなど、heartbeatを受け取れる異なる実行系を同じ組織図へ参加させられるのが特徴です。

出典：[1]

タスク、承認ゲート、監査、予算上限を同じcontrol planeで扱う

Paperclipのtask systemはissue、依存関係、comment、document、attachment、work productを管理し、実行時にはatomic checkoutやexecution lockで二重作業を避ける設計です。さらにapproval workflow、agentのpause/resume/terminate、変更履歴、token・cost tracking、warning thresholdとhard stopを備え、Agentの自律実行に人間の統制を差し込めます。

出典：[1]

Heartbeat・cron・webhook・API triggerで、Agentの継続運用を仕組みにする

Agentはheartbeatで定期的に起動して担当作業を確認でき、routineにはcron、webhook、API triggerを設定できます。実行ごとにtracked issueを作り、workspace解決、secret注入、skill読み込み、adapter呼び出し、structured log、cost event、session state、audit trailまで記録する構成がREADMEで説明されています。

出典：[1]

Docker QuickstartならNode.jsやpnpmをホストへ入れずに試せる

公式Dockerドキュメントでは、docker compose -f docker/docker-compose.quickstart.yml up --buildが推奨Quickstartです。UIはhttp://localhost:3100で開き、embedded PostgreSQL、uploaded assets、local secrets key、Agent workspace dataは./data/docker-paperclip配下へ永続化されます。DockerイメージにはClaude Code、Codex、OpenCode、Gemini CLIも同梱されています。

出典：[2]

複数のコーディングAgentや業務Agentを24時間動かしつつ、誰が何をしているか統制したい場合に

Claude CodeやCodexなどを複数並行で動かし、個別ターミナルや設定ファイルだけでは担当・進捗・コスト・承認の追跡が難しくなっているチームに向きます。単発のAgent実行基盤より、事業目標からAgentの役割、日々のタスク、予算、レビューまでを一続きで管理したい場合に比較価値があります。

Agentの自律性が上がるほど、APIキー・workspace権限・予算・永続データの運用設計が重要になる

Docker QuickstartはAPIキーなしでもアプリ自体を起動できますが、Claude Code、Codex、Geminiなどのlocal adapterを実際に動かすには各Providerの認証情報が必要です。Agentへ渡すsecretや作業ディレクトリの権限は、Paperclipのapproval・budget・audit機能とは別に、利用するProviderと実行環境の権限モデルとして設計してください。

./data/docker-paperclipにはembedded PostgreSQL、uploaded assets、local secrets key、Agent workspace dataが保存されます。検証環境でもこのディレクトリを単なるキャッシュとして扱わず、バックアップ・アクセス制御・破棄方針を決める必要があります。ソースコードはMIT Licenseです。Dockerを使わず開発環境を構築する場合、package.jsonはNode.js 24.11以上とpnpm 9.15.4を要求しています。

出典：[2][3][4]