Paperclip完全ガイド：インストールから無人AIカンパニー構築まで

AIエージェントを一つ上手く使う時代を超え、複数のエージェントを一つのチームのようにオーケストレーションする時代が到来しています。Paperclipは、OpenClaw、Claude Code、Codex、Cursorなど様々なAIエージェントを採用し、目標を付与し、予算を管理し、タスクをモニタリングするオープンソースAIエージェントオーケストレーションプラットフォームです。スローガンがこれをよく要約しています: "OpenClawが社員なら、Paperclipは会社だ。"

GitHubで41,000以上のスターを獲得したこのプロジェクトの紹介から、Windows、Ubuntu、macOS別のインストール方法までまとめます。

Paperclipとは？

Paperclipは、Node.jsサーバーとReact UIで構成されたAIエージェントオーケストレーションプラットフォームです。単一エージェントツールではなく、複数のエージェントをチームとしてまとめてビジネス目標を達成させる管理レイヤー（Control Plane）です。

Paperclipができること・できないこと

主要機能

• 目標アラインメント（Goal Alignment）: すべてのタスクが会社ミッションに紐づけて追跡されます。エージェントは"何を（what）"だけでなく"なぜ（why）"も理解します
• スケジュール実行: ハートビートベースのアクティベーションにより、エージェントが自律的にスケジュールに従って動作します
• コスト管理: エージェント別の月間予算を設定し、トークンコストの暴走を防止します
• マルチカンパニー: 単一デプロイで無制限に分離された会社を運用できます
• 監査証跡: すべてのツール呼び出し、判断、レスポンスがイミュータブルログとして記録されます
• ガバナンス: 人間が採用承認、戦略オーバーライド、エージェント終了を制御します
• ランタイムスキルインジェクション: 再学習なしにエージェントがワークフローとプロジェクトコンテキストをランタイムで学習します

前提条件

すべてのOS共通:

• Node.js 20+
• pnpm 9.15+（手動インストールの場合）
• PostgreSQLは内蔵されているため、別途インストール不要

Windowsインストール

方法1: npxワンコマンドインストール（推奨）

Node.js 20+がインストールされていれば、1行で完了します:

npx paperclipai onboard --yes

対話型セットアップウィザードが起動し、内蔵PostgreSQLが自動的に構成されます。

方法2: グローバルCLIインストール

npm install -g paperclipai
paperclipai onboard

方法3: ソースからビルド

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

Ubuntu（Linux）インストール

方法1: npx（推奨）

# Node.js 20+ インストール（未インストールの場合）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Paperclip インストールおよびオンボーディング
npx paperclipai onboard --yes

方法2: ソースからビルド

# pnpm インストール
npm install -g pnpm

# ソースクローンおよび実行
git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

サーバーがhttp://localhost:3100で起動します。

方法3: グローバルCLI

npm install -g paperclipai
paperclipai onboard

macOSインストール

方法1: npx（推奨）

# Node.js 20+ インストール（未インストールの場合）
brew install node@20

# Paperclip インストールおよびオンボーディング
npx paperclipai onboard --yes

方法2: ソースからビルド

brew install pnpm

git clone https://github.com/paperclipai/paperclip.git
cd paperclip
pnpm install
pnpm dev

方法3: グローバルCLI

npm install -g paperclipai
paperclipai onboard

CLI主要コマンド

設定ファイル構成

Paperclipはインスタンスごとに設定が分離されます:

~/.paperclip/instances/<instance-id>/
  config.json      # メイン設定
  .env.local       # JWTシークレット
  master.key       # 暗号化キー
  context.json     # CLIコンテキストプロファイル

主要環境変数

トラブルシューティング

まとめ

• Paperclipは複数のAIエージェントを一つのチームとしてオーケストレーションするオープンソースプラットフォーム
• OpenClaw、Claude Code、Codex、Cursorなどすべてのエージェントを統合管理
• 目標アラインメント、予算管理、監査証跡、ガバナンスを一つのダッシュボードで制御
• すべてのOSで1行でインストール: npx paperclipai onboard --yes
• 内蔵PostgreSQLにより別途DBインストール不要
• MITライセンス、GitHub 41K+スター、セルフホスティング専用

参照リンク

• paperclipai/paperclip - GitHub公式リポジトリ（README、ソースコード、イシュートラッカー）
• Paperclip CLI公式ドキュメントCLIコマンド、設定ファイル、環境変数リファレンス
• Paperclip公式サイトプロジェクト紹介、機能概要
• paperclipai - npmnpmパッケージページ、最新バージョン情報