Paperclip

ベータ版： Paperclip は初期開発段階です。このテンプレートとソフトウェアには予期しない問題が発生する可能性があります。

Paperclip は、複数のAIエージェント（Claude、Codex、Cursor、OpenClawなど）を協調して自律的なビジネスを運営するためのオーケストレーションプラットフォームです。Node.jsサーバーとReact UIを提供し、エージェントチームの管理、目標の割り当て、作業の追跡、コストの監視を行います。

はじめに

1. テンプレートをデプロイし、サービスの起動を待ちます。
2. Zeabur ターミナル（Paperclipサービス）を開きます。
3. 最初の管理者アカウントを作成します：

   pnpm paperclipai auth bootstrap-ceo
   

4. 出力された招待URLをコピーし、ブラウザで開いて登録します。
5. お好みのAIツール（Codex または Claude Code）にログインします（下記の AIエージェント認証 を参照）。
6. エージェント作成時、Working directory を /home/node/ 配下のパスに設定します（例：/home/node/workspaces/my-project）。
7. Test now をクリックしてアダプター環境チェックを実行します。成功すると hello probe succeeded と表示されます。
8. セットアップ完了後、Zeabur環境変数の PAPERCLIP_AUTH_DISABLE_SIGN_UP を true に設定し、不正な登録を防止します。

AIエージェント認証

現在ターミナルログインのみサポートされています。環境変数認証（OPENAI_API_KEY / ANTHROPIC_API_KEY）はまだ動作しません。

ツール	ターミナルログイン
Codex	runuser -u node -- codex login --device-auth
Claude Code	runuser -u node -- claude login

注意事項

• ターミナルで CLIツールを実行する際は必ず runuser -u node -- プレフィックスを使用してください。 rootで実行すると権限の問題が発生します。
• Codexデバイス認証： ログインコマンドを実行する前に、ChatGPT Security Settings で「Enable device code authorization for Codex」を有効にしてください。
• OPENAI_API_KEY is not set 警告： codex login で認証済みの場合、この警告は無視して問題ありません。

重要事項

• 永続ストレージ： /home/node/ 配下のデータのみ再起動後も保持されます。その他のパスは一時的です。
• 作業ディレクトリ： /app は使用しないでください。Paperclipのソースコードが含まれており、更新時に上書きされます。必ず /home/node/ 配下のパス（永続化）を使用してください。
• 登録制御： 管理者アカウント作成後、PAPERCLIP_AUTH_DISABLE_SIGN_UP を true に設定してください。新しいユーザーを招待する際は一時的に false に変更し、完了後 true に戻してください。

変更履歴

2026-03-16 — 初回リリース

• Paperclip AIエージェントオーケストレーションプラットフォームのZeaburテンプレート
• サービス：PostgreSQL 17 + Paperclip（ビルド済みイメージ zeabur/paperclip、amd64 + arm64）
• 起動スクリプトが初回起動時に config.json を自動生成
• サーバーは runuser を使用して node ユーザーとして実行（Claude Code CLIに必要）
• /home/node/ に単一の永続ボリューム
• プリインストール済みCLIツール：claude-code、codex、opencode-ai

リンク

• 公式ドキュメント
• GitHub