Paperclip
ゼロヒューマン企業のためのオープンソースオーケストレーション（paperclipai/paperclip）。AI エージェントのチームを編成し、ゴールを割り当て、ダッシュボードで作業とコストを追跡する。
位置づけ
Paperclip は、Node.js サーバーと React UI で、AI エージェントのチームをオーケストレーションして「会社」を運営するオープンソースプロジェクト。OpenClaw が「従業員」なら、Paperclip は「会社」に相当する。自前のエージェントを持ち込み、ゴールを設定し、エージェントの作業とコストを一つのダッシュボードで管理する。
外見はタスクマネージャーのようだが、内部には組織図・予算・ガバナンス・ゴール整合・エージェント間調整がある。プルリクではなくビジネスゴールを管理する。
ロードマップ: Clipmart（プリビルト会社テンプレの公開・ワンクリック投入）は README で COMING SOON として案内されている。
Nodeサーバー
ReactUI
BYOAエージェント
MITライセンス
OpenClaw / Claude Code / Codex / Cursor / Bash / HTTP など、ハートビートを受け取れるエージェントなら「雇用」できる。
流れ
- 01 ゴールを定義する（例: 「AI ノートアプリで $1M MRR を目指す」）
- 02 チームを雇う（CEO、CTO、エンジニア、デザイナー、マーケター — 任意のボット・プロバイダー）
- 03 承認して実行 — 戦略をレビューし、予算を設定し、開始。ダッシュボードで監視する
主な機能
| 機能 | 説明 |
|---|---|
| Bring Your Own Agent | 任意のエージェント・ランタイムを一つの組織図に。ハートビートを受け取れれば雇用可能。 |
| Goal Alignment | すべてのタスクが会社のミッションに紐づく。エージェントは何を・なぜやるかを把握できる。 |
| Heartbeats | スケジュールで起動し、作業を確認して実行。委譲は組織図の上下に流れる。 |
| Cost Control | エージェントごとの月次予算。上限に達したら停止。暴走コストを防ぐ。 |
| Multi-Company | 1 デプロイで複数会社。完全なデータ分離。ポートフォリオを一つのコントロールプレーンで。 |
| Ticket System | 会話はすべてトレース、決定は説明付き。ツール呼び出しの完全トレースと不変監査ログ。 |
| Governance | ボードとして承認・戦略の上書き・エージェントの一時停止・終了が可能。実行ポリシーと監査ログとセット。 |
| Org Chart | 階層・役割・報告ライン。エージェントに上司・肩書き・職務記述がある。 |
| Mobile Ready | どこからでも自律ビジネスを監視・管理できる。 |
Without / With Paperclip
| Paperclip なし | Paperclip あり |
|---|---|
| Claude Code のタブが 20 個開いて追えない。再起動で全部消える。 | タスクはチケットベース、会話はスレッド、セッションは再起動後も永続。 |
| 複数ソースから手動でコンテキストを集めてボットに渡している。 | コンテキストはタスクからプロジェクト・会社ゴールへ流れ、エージェントは常に「何を・なぜ」を把握。 |
| エージェント設定がフォルダに散らばり、タスク管理・連携を毎回自作している。 | 組織図・チケット・委譲・ガバナンスが標準装備。スクリプトの山ではなく会社として運営できる。 |
| 暴走ループでトークンが数百ドル消え、気づいたときにはクォータ超過。 | コスト追跡で予算を可視化し、超過時はエージェントをスロットル。予算で優先度を管理。 |
| 定期ジョブ（サポート・SNS・レポート）を手動で起動している。 | Heartbeats でスケジュール実行。管理職が監督。 |
| アイデアのたびにリポジトリを探し Claude Code を開き、タブを守り続ける。 | Paperclip にタスクを追加し、コーディングエージェントが完了まで実行。管理側が成果をレビュー。 |
Paperclip が向いている人
- 自律 AI 会社を立ち上げたい
- 複数エージェント（OpenClaw, Codex, Claude, Cursor）を共通ゴールに向けて連携させたい
- Claude Code を 20 タブ開いていて誰が何をしているか分からなくなる
- 24/7 自律運用しつつ、監査や必要時の介入を残したい
- コストを監視し、予算を強制したい
- タスクマネージャーのような感覚でエージェントを管理したい
- スマホから自律ビジネスを管理したい
オーケストレーションの要点
| ポイント | 説明 |
|---|---|
| Atomic execution | タスクチェックアウトと予算強制がアトミック。二重作業と暴走コストを防ぐ。 |
| Persistent agent state | エージェントはハートビートをまたいで同じタスクコンテキストを再開。ゼロからやり直さない。 |
| Runtime skill injection | エージェントは実行時に Paperclip のワークフローやプロジェクトコンテキストを学習可能。再学習不要。 |
| Governance with rollback | 承認ゲートが強制され、設定はリビジョン管理。悪い変更は安全にロールバック可能。 |
| Goal-aware execution | タスクはゴールの親子関係を持ち、エージェントは「なぜ」を一貫して把握できる。 |
| Portable company templates | 組織・エージェント・スキル等をエクスポート／インポート。シークレットのスクラブと衝突解消付き。 |
| True multi-company isolation | すべてのエンティティは会社スコープ。1 デプロイで複数会社を完全に分離したデータ・監査で運用可能。 |
README の境界定義（要約）
| 種別 | 内容 |
|---|---|
| チャットボットではない | エージェントは「仕事」を持つ。雑談 UI ではなくチケットと Heartbeat 中心。 |
| エージェントフレームワークではない | エージェントの作り方は規定しない。複数エージェントの会社運営にフォーカス。 |
| ワークフロー Builder ではない | ドラッグ&ドロップのパイプラインではなく、組織図・ゴール・予算・ガバナンスで会社をモデル化。 |
| プロンプトマネージャーではない | プロンプト・モデル・ランタイムはエージェント側。Paperclip は組織と作業の座組を管理。 |
| 単一エージェント向けではない | チーム前提。1 体だけなら過剰になりやすい。 |
| コードレビュー専用ツールではない | PR の代替ではなく作業オーケストレーション。レビュープロセスは別途持ち込む。 |
コントロールプレーン（README 要約）
ラッパーではなくフル制御面。主要サブシステムの一例:
| 領域 | 役割 |
|---|---|
| Identity & Access | デプロイモード（trusted local / authenticated）、ボードユーザー、エージェント API キー、会社メンバーシップ等。 |
| Org Chart & Agents | 役割・予算・報告ライン・権限。Claude / Codex / CLI / HTTP アダプタなど。 |
| Work & Tasks | Issue の会社／プロジェクト／ゴールリンク、原子的チェックアウト、ブロッカー、コメント、添付、ワークプロダクト。 |
| Heartbeat Execution | DB ベースのウェイクアップ、予算チェック、ワークスペース解決、シークレット注入、アダプタ実行、リカバリ。 |
| Workspaces & Runtime | プロジェクトワークスペース、git worktree 等の実行環境、プレビュー URL・開発サーバー連携。 |
| Governance & Approvals | ボード承認、実行ポリシー、監査ログ、エージェント停止／再開。 |
| Budget & Costs | 会社・エージェント・プロジェクト・Issue 単位のコスト追跡とハードストップ。 |
| Routines & Schedules | cron / webhook / API トリガの定期実行と Issue 生成。 |
| Plugins | プロセス外ワーカー、ホストサービス、ジョブ、ツール／UI 拡張。 |
| Secrets & Storage | インスタンス／会社シークレット、暗号化ローカルストレージ、オブジェクトストレージ、添付。 |
| Company Portability | 組織一式のエクスポート／インポート（シークレット除去・衝突処理）。 |
セルフホスト・オープンソース
Paperclip アカウントは不要。既定は trusted local（ループバック）で最短初回起動:
npx paperclipai onboard --yes認証付き／LAN・Tailnet 公開で初めたい場合はバインドプリセットを明示:
npx paperclipai onboard --yes --bind lan
# または
npx paperclipai onboard --yes --bind tailnet既に設定がある状態で onboard を再実行すると既存設定は維持。変更は paperclipai configure。
手動クローン:
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm devAPI は http://localhost:3100。開発時は UI も API サーバのミドルウェア経由で同一オリジン。組み込み PostgreSQL が自動作成され、追加 DB セットアップは不要。
要件: Node.js 20+、pnpm 9.15+（リポジトリの
package.json の engines / packageManager に準拠）
よく使うスクリプト
clone 後のエントリ（README / package.json に整合）:
pnpm dev # API + UI、ウォッチ
pnpm dev:once # ウォッチなしで 1 回起動（既定でローカルマイグレーション適用など）
pnpm dev:server # サーバーのみ
pnpm dev:list # 管理済み dev ランナーの確認
pnpm dev:stop # dev ランナー停止
pnpm storybook # UI Storybook（ポート 6006）
pnpm build # 全体ビルド
pnpm typecheck # 型チェック
pnpm test # 既定は Vitest のみ（README の cheap default）
pnpm test:watch # Vitest ウォッチ
pnpm test:e2e # Playwright（ブラウザ。通常フローとは別）
pnpm db:generate # DB マイグレーション生成
pnpm db:migrate # マイグレーション適用pnpm test は Playwright を含まない。ブラウザ系は pnpm test:e2e 等で個別実行。
詳細は上游リポジトリの doc/DEVELOPING.md を参照。
既定 ON と無効化
匿名の利用状況テレメトリが既定で有効。個人情報・Issue 本文・プロンプト・ファイルパス・シークレットは収集対象外。プライベート repo 参照はインストール単位の salt でハッシュ化される、と README に記載されている。
| 方法 | 設定 |
|---|---|
| 環境変数 | PAPERCLIP_TELEMETRY_DISABLED=1 |
| 標準の追跡拒否 | DO_NOT_TRACK=1 |
| CI | CI=true のとき自動無効 |
| 設定ファイル | telemetry.enabled: false |