Paperclip

Beta: Paperclip masih dalam tahap pengembangan awal. Template ini dan perangkat lunaknya mungkin mengalami masalah yang tidak terduga.

Paperclip adalah platform orkestrasi untuk mengoordinasikan beberapa agen AI (Claude, Codex, Cursor, OpenClaw, dll.) untuk menjalankan bisnis otonom. Menyediakan server Node.js dengan UI React untuk mengelola tim agen, menetapkan tujuan, melacak pekerjaan, dan memantau biaya.

Memulai

1. Deploy template dan tunggu layanan dimulai.
2. Buka Terminal Zeabur untuk layanan Paperclip.
3. Buat akun admin pertama:

   pnpm paperclipai auth bootstrap-ceo
   

4. Salin URL undangan dari output dan buka di browser untuk mendaftar.
5. Login ke alat AI pilihan Anda — Codex atau Claude Code (lihat Autentikasi Agen AI di bawah).
6. Saat membuat agen, atur Working directory ke path di bawah /home/node/ (contoh: /home/node/workspaces/my-project).
7. Klik Test now untuk menjalankan pemeriksaan adapter. Hasil sukses menampilkan hello probe succeeded.
8. Setelah selesai, atur PAPERCLIP_AUTH_DISABLE_SIGN_UP menjadi true di variabel lingkungan Zeabur untuk mencegah pendaftaran tidak sah.

Autentikasi Agen AI

Saat ini hanya login Terminal yang didukung. Autentikasi variabel lingkungan (OPENAI_API_KEY / ANTHROPIC_API_KEY) belum berfungsi.

Alat	Login Terminal
Codex	runuser -u node -- codex login --device-auth
Claude Code	runuser -u node -- claude login

Catatan

• Selalu gunakan prefiks runuser -u node -- saat menjalankan alat CLI di Terminal. Menjalankan sebagai root akan menyebabkan masalah izin.
• Autentikasi perangkat Codex: Aktifkan "Enable device code authorization for Codex" di ChatGPT Security Settings sebelum menjalankan perintah login.
• Peringatan OPENAI_API_KEY is not set: Peringatan ini dapat diabaikan dengan aman jika Anda telah melakukan autentikasi melalui codex login.

Catatan Penting

• Penyimpanan persisten: Hanya data di bawah /home/node/ yang bertahan setelah restart. Semua path lainnya bersifat sementara.
• Direktori kerja: Jangan gunakan /app — berisi kode sumber Paperclip dan akan ditimpa saat pembaruan. Selalu gunakan path di bawah /home/node/ (persisten).
• Kontrol pendaftaran: Atur PAPERCLIP_AUTH_DISABLE_SIGN_UP menjadi true setelah membuat akun admin Anda. Ubah sementara ke false saat perlu mengundang pengguna baru, lalu kembalikan ke true.

Catatan Perubahan

2026-03-16 — Rilis Pertama

• Template Zeabur untuk platform orkestrasi agen AI Paperclip
• Layanan: PostgreSQL 17 + Paperclip (image siap pakai zeabur/paperclip, amd64 + arm64)
• Skrip startup otomatis menghasilkan config.json pada boot pertama
• Server berjalan sebagai pengguna node melalui runuser (diperlukan untuk Claude Code CLI)
• Volume persisten tunggal di /home/node/
• Alat CLI terinstal: claude-code, codex, opencode-ai

Tautan

• Dokumentasi
• GitHub