Paperclip: Cara Menjalankan Perusahaan Satu Orang dengan Framework Open Source Ini

Paperclip adalah kerangka kerja perusahaan satu orang sumber terbuka yang mengorkestrasi agen AI seperti karyawan: struktur organisasi, anggaran, penjadwalan detak jantung, persetujuan tata kelola, dan log audit lengkap. Satu perintah dapat menjalankannya secara lokal. Agen Anda melakukan pekerjaan; Anda memimpin rapat dewan direksi.

Menjalankan perusahaan satu orang di tahun 2026 tidak lagi berarti melakukan semuanya sendiri — itu berarti mengarahkan tim agen AI yang melakukan pekerjaan sementara Anda tetap fokus pada strategi. Paperclip adalah kerangka kerja perusahaan satu orang sumber terbuka yang dibangun untuk mewujudkan hal tersebut. Ini memberikan pendiri tunggal struktur organisasi, sistem anggaran, lapisan tata kelola, dan pelacak tugas untuk agen AI mereka, semuanya dalam satu dasbor yang di-host sendiri. Jika Anda juga menggunakan Apidog untuk merancang, membuat tiruan (mock), dan menguji API yang berinteraksi dengan agen Anda, Paperclip melengkapi tumpukan: Apidog mengelola kontrak API, Paperclip mengelola agen yang memanggilnya. Panduan ini menjelaskan dengan tepat bagaimana Paperclip bekerja dan bagaimana cara mengintegrasikannya ke dalam operasi perusahaan satu orang mulai hari ini.

💡

Dapatkan Apidog (gratis) sebelum detak jantung Paperclip pertama Anda. Sematkan URL tiruan (mock URL) dalam deskripsi tugas agar agen membangun berdasarkan kontrak yang sempurna – tanpa biaya, tanpa kejutan. Beralih ke API langsung nanti dengan pengujian Apidog yang menangkap penyimpangan apa pun sebelum anggaran terbakar.

tombol

Apa Itu Paperclip dan Mengapa Kerangka Kerja Perusahaan Satu Orang Penting bagi Pengguna Apidog?

Slogan Paperclip mengatakannya secara langsung: "Jika OpenClaw adalah seorang karyawan, Paperclip adalah perusahaan."

Paperclip adalah server Node.js dan UI React yang mengubah kumpulan agen AI Anda menjadi organisasi terstruktur dengan jabatan, jalur pelaporan, anggaran bulanan, dan tujuan strategis. Ini bukan chatbot, manajer prompt, atau pembangun alur kerja seret dan lepas. Ini adalah panel kontrol untuk perusahaan otonom.

Inilah mengapa kerangka kerja perusahaan satu orang ini penting saat ini.

Sebagian besar pendiri tunggal yang menggunakan agen AI pada tahun 2026 mengelola kekacauan. Dua puluh tab Kode Claude terbuka. Tidak ada catatan agen mana yang menyentuh file mana. Tidak ada batasan pengeluaran token. Tidak ada cara untuk mengetahui apakah agen menyelesaikan tugas atau berhalusinasi. Paperclip memperbaiki semua ini dengan memperlakukan agen sama seperti perusahaan nyata memperlakukan karyawan:

Struktur organisasi — agen memiliki peran, jabatan, dan manajer
Masalah / tugas — setiap pekerjaan dilacak dengan status, prioritas, dan penerima tugas
Tujuan — setiap tugas melacak kembali ke misi perusahaan sehingga agen selalu tahu mengapa
Detak jantung — agen bangun sesuai jadwal, memeriksa kotak masuk tugas mereka, melakukan pekerjaan, melaporkan kembali
Anggaran — batas pengeluaran token bulanan per agen; ketika mencapai batas, mereka berhenti
Tata Kelola — Anda menyetujui perekrutan agen dan keputusan strategi besar sebelum mereka dieksekusi

Untuk tim yang menggunakan Apidog untuk mendefinisikan dan menirukan (mock) API yang dipanggil oleh agen mereka, Paperclip menambahkan lapisan orkestrasi yang hilang. Apidog memberi tahu agen apa kontrak API itu. Paperclip memberi tahu agen pekerjaan apa yang harus dilakukan, kapan harus melakukannya, dan berapa banyak yang boleh dihabiskan.

Mengapa Pendiri Tunggal Memilih Kerangka Kerja Perusahaan Satu Orang Ini daripada Pendekatan Apidog Saja

Apidog luar biasa dalam desain dan pengujian API secara terpisah. Tetapi desain API hanyalah satu lapisan dalam menjalankan produk. Paperclip menangani proses di sekitarnya: dekomposisi tujuan, penetapan tugas, pelacakan kemajuan, visibilitas biaya, dan pencatatan audit. Bersama-sama, Apidog + Paperclip memberikan pendiri tunggal sistem operasi lengkap untuk perusahaan perangkat lunak di mana manusia menetapkan arah dan agen AI mengeksekusi.

Fitur Inti Kerangka Kerja Perusahaan Satu Orang Paperclip dan Posisi Apidog

Detak Jantung: Lingkaran Aktivasi Agen yang Kompatibel dengan Apidog

Detak jantung adalah primitif eksekusi inti Paperclip. Pada setiap detak jantung, agen:

Memanggil GET /api/agents/me untuk mengonfirmasi identitasnya
Memanggil GET /api/companies/:id/issues?status=todo,in_progress untuk membaca kotak masuk tugasnya
Memanggil GET /api/issues/:id untuk mendapatkan konteks lengkap termasuk silsilah tujuan induk
Melakukan pekerjaan (menulis kode, memanggil API, menghasilkan konten)
Memanggil PATCH /api/issues/:id dengan pembaruan status dan komentar yang menjelaskan apa yang dilakukannya

Di sinilah integrasi Apidog bersinar. Jika tugas melibatkan pemanggilan API eksternal — katakanlah, menarik data pelanggan untuk menghasilkan laporan mingguan — agen memanggil server tiruan Apidog selama pengembangan, kemudian beralih ke titik akhir langsung dalam produksi tanpa mengubah satu baris kode pun. Validasi permintaan Apidog menangkap setiap penyimpangan dalam kontrak API sebelum secara diam-diam merusak pekerjaan agen.

Struktur Organisasi dan Hierarki Tujuan Apidog sebagai Lapisan API

Hierarki tujuan Paperclip mengalir dari perusahaan → tim → agen → tugas. Agen yang ditugaskan selalu menerima rantai leluhurnya sehingga agen junior tahu bahwa ia sedang menulis postingan blog sebagai bagian dari "meningkatkan lalu lintas SEO" sebagai bagian dari "mencapai $1 juta MRR". Konteks ini mencegah agen mengoptimalkan secara lokal dengan mengorbankan tujuan yang lebih luas.

Dalam hierarki ini, Apidog berfungsi sebagai lapisan spesifikasi API. Anda mendefinisikan layanan internal Anda di Apidog, mempublikasikan server tiruan untuk masing-masing, dan agen mereferensikan titik akhir Apidog tersebut dalam deskripsi tugas mereka. Ketika API berubah, Anda memperbarui spesifikasi Apidog, membuat ulang tiruan, dan setiap agen hilir mendapatkan kontrak baru secara otomatis.

Penegakan Anggaran Menghentikan Pengeluaran yang Tidak Terkendali dalam Alur Kerja Apidog Anda

Setiap agen di Paperclip memiliki bidang budgetMonthlyCents. Ketika spentMonthlyCents agen mencapai batas itu, ia berhenti menerima tugas. Tidak ada penimpaan, tidak ada pengecualian. Untuk perusahaan satu orang yang beroperasi dengan efisien, ini adalah fitur yang memungkinkan sisanya – Anda dapat memberikan anggaran $20/bulan kepada agen dan tahu dengan pasti bahwa itu tidak akan pernah terlampaui.

Ketika Anda menggabungkan ini dengan server tiruan Apidog, Anda dapat menjalankan seluruh sprint pekerjaan agen terhadap tiruan (biaya token nol) sebelum beralih ke penyedia AI langsung. Prototyping gratis; produksi dianggarkan.

Menyiapkan Paperclip sebagai Kerangka Kerja Perusahaan Satu Orang Anda dengan Apidog {#setup}

Memulai Lokal Tanpa Konfigurasi Apidog Terhubung Segera

Menjalankan Paperclip hanya membutuhkan satu perintah:

npx paperclipai onboard --yes

Ini menginisialisasi basis data PostgreSQL yang tertanam, menghasilkan kunci enkripsi utama, menerapkan semua migrasi basis data, dan memulai server di http://localhost:3100. Tidak diperlukan Docker, tidak diperlukan layanan eksternal.

Setelah berjalan, buka UI, buat perusahaan, dan definisikan tujuan pertama Anda:

"Bangun alat pemantauan API bertenaga AI #1 untuk mencapai $1 Juta MRR."

Kemudian buat agen pertama Anda — misalnya, agen "Backend Engineer" yang menggunakan adapter claude_local:

{
  "adapterType": "claude_local",
  "adapterConfig": {
    "model": "claude-opus-4-6",
    "maxTokens": 4096
  },
  "budgetMonthlyCents": 2000
}

Arahkan tugas agen ke server tiruan Apidog Anda. Dalam deskripsi tugas, referensikan URL koleksi Apidog sehingga agen memiliki kontrak API lengkap yang tersedia sebagai konteks.

Menghubungkan Mock Apidog ke Tugas Agen

Di Paperclip, deskripsi tugas adalah markdown kaya dengan konteks leluhur penuh. Anda dapat menyematkan URL dasar mock Apidog Anda secara langsung:

## Tugas: Tambahkan paginasi ke titik akhir /users

**Basis Mock Apidog:** http://localhost:4523/m1/123456/users
**Kriteria penerimaan:**
- Titik akhir menerima parameter kueri `page` dan `limit`
- Mengembalikan ` { data: [], total: 0, page: 1 } ` dalam struktur amplop
- Cakupan pengujian unit untuk kasus ekstrem (page=0, limit>100)

Agen membaca ini, memanggil mock Apidog untuk memverifikasi bentuk respons saat ini, menulis implementasi, dan melaporkan kembali dengan komentar.

Menjalankan Agen, Tugas, dan Detak Jantung dalam Kerangka Kerja Perusahaan Satu Orang Paperclip dengan Apidog

Mengelola Isu Melalui Pipeline Paperclip Apidog

CLI Paperclip memberi Anda kontrol penuh atas siklus hidup tugas tanpa membuka UI:

# Buat tugas untuk agen untuk mengimplementasikan titik akhir baru yang ditentukan Apidog
pnpm paperclipai issue create \
  --company-id <id> \
  --title "Implementasikan titik akhir POST /webhooks sesuai spesifikasi Apidog" \
  --description "Lihat koleksi Apidog: http://localhost:4523/..."

# Periksa status tugas
pnpm paperclipai issue list --company-id <id> --status in_progress

# Lepaskan tugas jika agen macet
pnpm paperclipai issue release <issue-id>

Setiap perubahan status dicatat dalam log aktivitas yang tidak dapat diubah sehingga Anda selalu tahu persis agen mana yang menyentuh tugas dan apa yang dikatakannya.

Tata Kelola dan Persetujuan dalam Kerangka Kerja Perusahaan Satu Orang yang Terintegrasi dengan Apidog

Model tata kelola Paperclip menempatkan Anda dalam peran dewan. Sebelum agen direkrut atau strategi besar disetujui, Paperclip dapat meminta persetujuan eksplisit Anda:

# Tinjau persetujuan yang tertunda
pnpm paperclipai approval list --company-id <id>

# Setujui perekrutan agen baru
pnpm paperclipai approval approve <approval-id> \
  --decision-note "Disetujui. Gunakan mock Apidog untuk sprint pertama."

Ini mencegah kerangka kerja perusahaan satu orang menjadi bencana otonomi. Agen mengusulkan; Anda memutuskan.

Pengujian, Tata Kelola, dan Kontrol Biaya dalam Tumpukan Kerangka Kerja Perusahaan Satu Orang Paperclip + Apidog Anda

Menjalankan Suite Pengujian Unit Paperclip Apidog

Paperclip dilengkapi dengan suite pengujian unit lengkap yang didukung oleh Vitest dan pengujian end-to-end yang didukung oleh Playwright. Menjalankannya mudah:

# Jalankan semua pengujian unit
pnpm test:run

# Jalankan pengujian end-to-end
pnpm test:e2e

# Pemeriksaan kesehatan — verifikasi server dan mock Apidog dapat dijangkau
curl http://localhost:3100/api/health

Suite pengujian unit mencakup logika bisnis inti: transisi status isu, penegakan anggaran, siklus hidup berjalan detak jantung, dan autentikasi agen. Saat Anda menambahkan adapter khusus untuk menghubungkan penyedia AI baru, menjalankan suite pengujian unit mengonfirmasi bahwa perilaku orkestrasi yang ada tidak berubah.

Dalam kerangka kerja perusahaan satu orang, ini lebih penting daripada dalam tim tradisional. Anda tidak memiliki peninjau kode. Suite pengujian unit dan pengujian kontrak Apidog Anda adalah jaring pengaman Anda.

Tumpukan Kualitas Tiga Lapisan: Paperclip + Apidog + Pengujian Unit

Pola kualitas praktis untuk pendiri tunggal:

Apidog mendefinisikan kontrak API dan menjalankan pengujian kontrak otomatis pada setiap push
Masalah Paperclip berisi kriteria penerimaan yang merujuk pada spesifikasi Apidog
Pengujian unit (Vitest) memvalidasi bahwa implementasi cocok dengan keduanya

Pendekatan tiga lapisan ini berarti seorang pendiri tunggal mendapatkan jaminan kualitas yang sama dengan yang akan dimiliki oleh tim beranggotakan lima orang dari tinjauan sejawat tanpa rapat.

Kesimpulan

Paperclip adalah kerangka kerja perusahaan satu orang sumber terbuka yang mengubah pendiri tunggal menjadi sebuah perusahaan. Ini menghadirkan struktur organisasi, kontrol anggaran, tata kelola, penyelarasan tujuan, penjadwalan detak jantung, dan jejak audit lengkap untuk manajemen agen AI — semuanya di-host sendiri, semuanya sumber terbuka, semuanya milik Anda.

Untuk pengembang yang sudah menggunakan Apidog untuk mendesain dan menguji API, menambahkan Paperclip melengkapi tumpukan. Apidog menangani apa yang dilakukan API. Paperclip menangani siapa yang memanggilnya, kapan, mengapa, dan berapa biayanya. Bersama-sama mereka membentuk kerangka kerja perusahaan satu orang yang siap produksi sejak hari pertama: server tiruan Apidog Anda mendukung pengembangan agen, pengujian kontrak Apidog Anda memvalidasi keluaran agen, dan lapisan tata kelola Paperclip memastikan tidak ada agen yang mengambil tindakan yang belum Anda setujui.

Mulai:

Inisialisasi secara lokal: npx paperclipai onboard --yes
Buka UI di http://localhost:3100, buat perusahaan, dan definisikan tujuan pertama Anda
Tambahkan agen dengan anggaran $20/bulan dan arahkan ke server tiruan Apidog Anda
Jalankan pnpm test:run untuk memverifikasi suite pengujian unit lulus sebelum detak jantung produksi pertama Anda
Setujui tugas pertama, saksikan agen bekerja, tinjau log audit

Perusahaan satu orang bukan lagi metafora. Dengan Paperclip dan Apidog, itu adalah arsitektur.

tombol

FAQ

Apa itu Paperclip? Paperclip adalah kerangka kerja perusahaan satu orang sumber terbuka — server Node.js dan UI React yang mengorkestrasi agen AI dengan struktur organisasi, anggaran, penjadwalan detak jantung, dan tata kelola. Ini adalah panel kontrol untuk menjalankan perusahaan perangkat lunak dengan agen AI alih-alih karyawan manusia.

Bagaimana Paperclip terintegrasi dengan Apidog? Apidog mendefinisikan kontrak API yang digunakan agen Anda. Anda menyematkan URL tiruan Apidog dalam deskripsi tugas Paperclip, agen memanggil tiruan tersebut selama pengembangan, dan pengujian kontrak Apidog memvalidasi implementasi akhir. Paperclip menangani orkestrasi; Apidog menangani spesifikasi API.

Apakah Paperclip cocok untuk perusahaan satu orang sejati? Ya. Penyiapan lokal tanpa konfigurasi (npx paperclipai onboard --yes) tidak memerlukan infrastruktur. Batasan anggaran mencegah biaya yang tidak terkendali. Sistem detak jantung menangani pekerjaan berulang secara otomatis. Integrasi Tailscale memungkinkan Anda mengelola agen dari ponsel Anda. Ini skalabel dari lokal ke cloud dengan konfigurasi yang sama.

Bagaimana cara menjalankan pengujian unit? Jalankan pnpm test:run untuk suite pengujian unit Vitest, atau pnpm test:e2e untuk pengujian end-to-end Playwright. Pemeriksaan kesehatan terhadap http://localhost:3100/api/health mengonfirmasi bahwa server berjalan dengan benar sebelum pengujian.

Agen AI apa saja yang didukung Paperclip? Paperclip mendukung Claude (lokal dan melalui OpenClaw), Codex, Cursor, Gemini, OpenCode, dan agen apa pun yang berbicara HTTP atau berjalan sebagai proses lokal. Sistem adapter terbuka — jika agen Anda dapat menerima detak jantung, itu dapat dipekerjakan.

Apakah Paperclip sumber terbuka? Ya. Paperclip berlisensi MIT dan dikelola secara aktif di github.com/paperclipai/paperclip. SDK plugin, paket adapter, dan definisi keahlian semuanya dipublikasikan sebagai paket NPM terlingkup di bawah @paperclipai/*.