Cara menyiapkan Paperclip di VPS: panduan langkah demi langkah

Paperclip adalah platform orkestrasi open-source yang memungkinkan Anda membangun, mengelola, dan mengoordinasikan beberapa AI agent untuk mencapai tujuan bersama. Menyiapkannya di VPS memberi Anda environment yang persisten dan berjalan secara self-host untuk menjalankan sekumpulan agen otonom.

Menjalankan Paperclip di server Anda sendiri juga berarti Anda bisa mengelola sepenuhnya data, konfigurasi agen, dan biaya infrastruktur.

Untuk menyiapkan Paperclip di VPS, Anda perlu menyiapkan server dengan resource yang cukup agar agent tetap berjalan 24 jam nonstop, menjalankan deployment aplikasi menggunakan Docker, dan mengatur organisasi agent AI Anda melalui dashboard.

Berikut langkah demi langkah untuk menyiapkan Paperclip di VPS:

1. Pilih paket VPS. Pilih yang memiliki resource yang cukup agar agent Anda bisa terus berjalan secara berkelanjutan. Konfigurasi dengan 2 core vCPU, RAM 4 GB, dan penyimpanan SSD 50 GB sudah cukup untuk konfigurasi dasar.
2. Deploy Paperclip dengan Docker. Docker menggabungkan Paperclip beserta semua dependensinya ke dalam satu container, jadi Anda bisa melewati sebagian besar pekerjaan manual.
3. Masuk ke dashboard Paperclip. Akses environment Paperclip yang aktif melalui browser Anda, lalu masuk menggunakan kredensial yang Anda atur saat deployment.
4. Tetapkan tujuan dan tentukan workflow. Beri perusahaan AI Anda nama serta tujuan yang spesifik dan terukur. Ini adalah target yang menjadi acuan akhir dari pekerjaan setiap agen.
5. Tambahkan agen dengan peran yang sudah ditentukan. Bangun bagan organisasi Anda dengan menugaskan agen ke peran seperti CEO, CTO, atau Marketer, masing-masing dengan tanggung jawab dan konfigurasi adapter sendiri.
6. Tetapkan anggaran token LLM. Terapkan batas pengeluaran di tingkat agen atau project agar biaya API tetap mudah diprediksi saat agen mulai menjalankan tugas.
7. Pantau agen Anda. Lacak progres tugas, tinjau log heartbeat, dan identifikasi salah konfigurasi atau inefisiensi sejak awal sebelum masalahnya semakin besar.
8. Optimalkan dan tingkatkan skalanya. Perjelas definisi peran, sesuaikan jalur pelaporan, dan upgrade resource VPS Anda seiring berkembangnya organisasi agen Anda.

Kalau Anda lebih suka mengikuti panduan dalam bentuk demonstrasi audio-visual, tonton video tutorial ini untuk menyiapkan Paperclip di Hostinger VPS:

Subscribe For more educational videos! Hostinger Academy

Subscribe

1. Pilih VPS untuk menjalankan Paperclip

Virtual private server (VPS) adalah pilihan yang paling pas untuk Paperclip, karena server ini menjaga agen Anda tetap berjalan terus-menerus. Artinya, agent Anda bisa terus mengerjakan tugas, menjalankan siklus terjadwal, dan memperbarui log meskipun Anda sedang offline.

Environment VPS juga bermanfaat untuk workload AI, yang membutuhkan resource lebih besar dibandingkan web app biasa. Agent memproses respons large language model (LLM), menulis ke database, dan menjalankan background job secara bersamaan.

Meski begitu, kebutuhan tersebut masih cukup mudah dikelola untuk setup yang lebih kecil. Untuk konfigurasi dasar dengan tim agen berukuran kecil, menyiapkan VPS dengan 2 core vCPU, RAM 4 GB, dan penyimpanan SSD 50 GB sudah cukup untuk mulai digunakan, terutama kalau dijalankan di Ubuntu 22.04 atau Debian 12.

Selain spesifikasi dasar, sebaiknya prioritaskan kemudahan setup saat membandingkan penyedia hosting Paperclip terbaik. Cari platform yang menawarkan template aplikasi yang sudah dikonfigurasi sebelumnya dan akses root SSH penuh.

Fitur-fitur ini secara signifikan mengurangi waktu penyiapan, menyederhanakan pengelolaan yang berjalan terus-menerus, dan tetap memberi Anda fleksibilitas untuk menerapkan penyesuaian tingkat server yang lebih canggih saat diperlukan.

Sebagian besar paket VPS untuk menjalankan Paperclip berbiaya antara US$4 (sekitar Rp68.000) dan US$30 (sekitar Rp510.000) per bulan. Karena Paperclip bersifat open source, satu-satunya biaya berkelanjutan yang perlu Anda keluarkan hanyalah server dan token API dari agen AI yang Anda gunakan.

2. Deploy Paperclip menggunakan Docker

Docker adalah tool yang mengemas aplikasi beserta semua dependensinya ke dalam sekumpulan container, yaitu unit mandiri yang berjalan dengan cara yang sama di server mana pun.

Untuk Paperclip, artinya Anda tidak perlu melakukan penginstalan Node.js secara manual, mengonfigurasi database, atau mengatur environment variable satu per satu.

Ada tiga cara berbeda untuk men-deploy Paperclip dengan Docker, tergantung pada apakah Anda pernah menyiapkan VPS sebelumnya.

Kalau Anda sedang menyiapkan VPS baru, opsi tercepat adalah template Paperclip milik Hostinger yang sudah dikonfigurasi sebelumnya. Beli paket melalui halaman hosting Paperclip, ikuti langkah-langkah onboarding, lalu Anda akan langsung diarahkan ke layar konfigurasi Paperclip.

Isi nama admin, alamat email, dan kata sandi Anda, lalu tambahkan API key untuk penyedia model AI pilihan Anda apabila diperlukan.

Kalau Anda melewatkan penambahan API key, Paperclip tetap akan berhasil di-deploy, tapi agent Anda tidak akan bisa menjalankan task sampai Anda menambahkan key nanti melalui dashboard.

Setelah Anda mengklik Deploy, Paperclip akan aktif dan berjalan di server Anda dalam beberapa saat.

Kalau Anda sudah memiliki VPS Hostinger, masuk ke hPanel lalu buka VPS → OS & Panel → Operating System. Pastikan Docker sudah terinstal, lalu cari Paperclip di menu aplikasi Docker untuk menerapkannya.

Kalau Anda menggunakan penyedia VPS lain, Anda perlu menyiapkan instance Docker terlebih dahulu, lalu menginstal Paperclip dengan Docker Compose menggunakan perintah berikut:

docker compose -f docker-compose.quickstart.yml up --build

3. Masuk ke dashboard Paperclip

Kalau Anda menggunakan installer sekali klik dari Hostinger, Anda akan langsung diarahkan ke halaman Docker Manager di dashboard VPS. Cari proyek Anda, lalu klik Open untuk membuka dashboard Paperclip di browser Anda.

Sebagai alternatif, Anda bisa mengaksesnya dengan mengetik langsung alamat IP server ke browser lalu menambahkan port Paperclip:

http://203.0.113.1:3100

Ganti 203.0.113.1 dengan alamat IP server Anda yang sebenarnya, sedangkan port 3100 adalah default milik Paperclip.

Metode ini bisa berjalan selama port 3100 terbuka di server Anda dan Paperclip sudah dikonfigurasi untuk menerima koneksi eksternal, keduanya otomatis ditangani oleh installer sekali klik dari Hostinger.

Setelah itu, Anda akan diminta untuk login ke Paperclip. Kalau Anda menggunakan installer sekali klik Hostinger, masukkan alamat email dan kata sandi yang Anda atur saat langkah konfigurasi Paperclip.

Kalau Anda melakukan penginstalan di VPS yang berbeda, Anda mungkin perlu membuat akun admin terlebih dahulu sebelum bisa login.

4. Tetapkan tujuan dan tentukan workflow untuk perusahaan AI Anda

Segera setelah login ke Paperclip, Anda akan diminta menyiapkan perusahaan AI pertama Anda. Mulailah dengan memberi nama dan menetapkan tujuannya.

Kami merekomendasikan Anda menetapkan goal meskipun secara teknis bersifat opsional, karena semua pekerjaan setiap agent pada akhirnya mengacu ke sana.

Pastikan tujuannya spesifik agar hasil yang diberikan lebih bermanfaat. Alih-alih menulis “Buat aplikasi catatan,” lebih baik arahkan pada sesuatu seperti “Bangun aplikasi pencatat berbasis AI nomor 1 hingga mencapai MRR US$1 juta, sekitar Rp17 miliar, dalam tiga bulan.” Agen bekerja paling efektif saat memiliki target yang jelas.

Klik Next, lalu Anda akan diminta menyiapkan peran agent pertama Anda. Secara default, Paperclip menetapkan peran CEO, yaitu posisi paling atas dalam bagan organisasi Anda. Dari sana, pilih jenis adapter dan model AI yang ingin Anda gunakan untuk menjalankan tugas.

Klik Berikutnya untuk melanjutkan penugasan tugas untuk peran CEO. Anda akan menemukan kolom deskripsi tugas, tempat Anda bisa menulis system prompt yang menjelaskan apa yang harus dilakukan agen dan apa yang perlu diprioritaskan.

Paperclip menyusun agent menggunakan bagan organisasi, seperti perusahaan mengatur timnya. Setiap agent memiliki peran yang jelas, melapor kepada agent lain atau kepada Anda, dan menangani jenis pekerjaan tertentu.

CEO berperan sebagai koordinator tingkat tertinggi, menerima tujuan, memecahnya menjadi tugas-tugas tingkat tinggi, lalu mendelegasikan pekerjaan ke level-level di bawahnya dalam struktur organisasi.

Anda bisa meminta CEO untuk merekrut agen yang spesifik sesuai peran, seperti agen CTO untuk tugas teknis, agen Marketing untuk konten dan outreach, agen Research untuk mengumpulkan informasi, dan sebagainya. Tentukan kebutuhan ini dalam system prompt awal untuk agen CEO.

Setelah selesai, klik Next untuk meninjau ringkasan organisasi Anda. Kalau semuanya sudah terlihat benar, klik Create & Open Issue untuk menyelesaikan pengaturan.

Langkah ini akan membuat organisasi Anda dan membuka tugas pertama agen CEO, yang menjadi titik awal untuk seluruh pekerjaan berikutnya.

5. Tambahkan agent AI lain sesuai peran yang Anda butuhkan

Setelah edisi pertama diluncurkan, Anda akan diarahkan ke dashboard Paperclip, tempat Anda bisa melihat agen AI CEO menjalankan heartbeat pertamanya. Sistem tersebut akan bekerja sesuai tujuan perusahaan yang Anda tetapkan dan tugas yang Anda berikan sebelumnya.

Ada dua cara untuk menambahkan agen ke organisasi Anda. Kalau Anda menyertakan struktur organisasi di system prompt CEO, sistem akan otomatis membuat permintaan perekrutan, dan permintaan tersebut akan muncul di Inbox dashboard Paperclip Anda, tempat Anda bisa menyetujui permintaan yang sesuai dengan setup Anda.

Sebagai alternatif, Anda bisa menambahkan agent secara manual dengan mengklik tombol plus (+) di menu Agents, yang memungkinkan Anda mengatur setiap agent dari awal menggunakan parameter kustom seperti jenis adapter, template prompt, model, dan kapabilitas.

Metode manual sangat berguna, terutama kalau Anda ingin menjalankan peran yang berbeda pada adapter yang berbeda, misalnya Backend Engineer di Claude Code dan Frontend Engineer di Gemini CLI.

Mulailah dengan membuat maksimal tiga sampai lima agen, satu koordinator dan dua sampai empat spesialis, agar Anda bisa lebih mudah melakukan debugging dan membangun kepercayaan diri sebelum menambah kompleksitas.

6. Atur anggaran token LLM Anda

Setiap kali agen menjalankan tugas, agen menggunakan token, yaitu satuan untuk mengukur penggunaan API LLM. Token tersebut tidak gratis, jadi dalam setup multi-agent yang sibuk, biayanya bisa cepat membengkak, terutama kalau agen AI masuk ke loop atau mengulangi pekerjaan yang sebenarnya tidak perlu.

Paperclip mengatasi masalah ini dengan sistem anggaran bawaan yang memungkinkan Anda menetapkan batas pengeluaran LLM di tingkat agent atau project, di seluruh organisasi.

Untuk menetapkan batas penggunaan, buka agen atau project lalu buka tab Budget. Dari sana, masukkan nominal yang Anda inginkan ke kolom Budget (USD), lalu klik Update budget untuk menerapkannya.

Kami merekomendasikan untuk memulai dengan batas yang konservatif saat melakukan pengujian, lalu menyesuaikannya seiring Anda memahami berapa besar biaya untuk setiap jenis tugas.

Anda bisa melacaknya langsung dari dashboard Paperclip, yang menampilkan rincian penggunaan token per agent secara real-time. Tinjau secara rutin selama beberapa hari pertama untuk mengidentifikasi agen yang paling aktif, sekaligus melihat agen mana yang menggunakan token secara tidak efisien.

7. Pantau agen AI Anda

Setiap agent Paperclip berjalan dengan jadwal heartbeat: agent akan aktif pada interval yang sudah ditentukan, meninjau tugas yang sedang dikerjakan dan tujuan perusahaan saat ini, memutuskan langkah berikutnya, menjalankannya, mencatat hasilnya, lalu kembali idle sampai siklus berikutnya.

Interval bawaan untuk agen CEO adalah 30–60 menit. Anda juga bisa memicu heartbeat secara manual dari pengaturan agen kalau Anda ingin agen langsung bertindak tanpa menunggu siklus terjadwal berikutnya.

Tempat utama untuk memantau agent Anda adalah bagian Issues di dashboard, yang menampilkan setiap tugas di seluruh organisasi Anda, termasuk siapa yang bertanggung jawab, statusnya, dan bagaimana tugas tersebut terkait dengan tujuan perusahaan Anda.

Klik issue mana pun untuk membaca penalaran agen, pemanggilan tool, dan log lengkap tentang apa yang dilakukan agen selama heartbeat tersebut.

Sementara itu, dashboard utama Paperclip memberikan gambaran umum tentang organisasi Anda, mulai dari agen yang aktif, aktivitas terbaru, hingga penggunaan anggaran, semuanya bisa dilihat secara sekilas.

Kalau terjadi masalah, misalnya agent macet, berhenti berjalan, atau menghasilkan output berkualitas rendah, heartbeat log adalah tempat pertama yang perlu Anda periksa.

Penyebab umum error atau output berkualitas rendah di Paperclip biasanya meliputi deskripsi tugas yang terlalu samar, API key yang belum ditambahkan, atau agen yang mencoba mendelegasikan tugas ke agen lain yang tidak memiliki kapabilitas yang diperlukan.

8. Optimalkan dan scale setup Anda

Seiring pertumbuhan organisasi Paperclip Anda, peningkatan kualitas workflow bergantung pada tujuan yang lebih jelas dan pembagian peran yang lebih tepat.

Kalau sebuah agent menghasilkan output yang tidak membantu, tinjau kembali deskripsi perannya, tambahkan tanggung jawab yang lebih spesifik, dan sertakan contoh seperti apa hasil kerja yang baik.

Kalau tugas ada yang terlewat atau salah dialihkan, tinjau kembali alur pelaporan Anda dan pastikan logika delegasi yang digunakan masih relevan.

Dari sisi teknis, Anda mungkin perlu memperluas infrastruktur VPS seiring meningkatnya penggunaan, jadi pantau penggunaan CPU dan RAM secara rutin melalui control panel Anda.

Kalau penggunaan secara konsisten berada di atas 70-80%, itu menjadi sinyal yang baik untuk mengupgrade ke tier berikutnya. Sebagian besar penyedia memungkinkan Anda melakukan scale tanpa downtime atau kehilangan data, sehingga Anda bisa menyesuaikan resource secara bertahap.

Terakhir, struktur Anda kemungkinan akan terus berkembang. Setelah satu atau dua minggu penggunaan nyata, pola akan mulai terlihat, beberapa peran mungkin terlalu terbebani, agen tertentu bisa saling tumpang tindih, atau target yang ditetapkan mungkin terlalu luas untuk didelegasikan secara efektif. Anggap ini sebagai hal yang wajar, bukan kegagalan. Tinjau log Anda, amati bagaimana alur kerja benar-benar berjalan, lalu sesuaikan setup Anda berdasarkan temuan tersebut.

Praktik terbaik untuk menyiapkan Paperclip

Langkah-langkah di atas membuat Paperclip bisa berjalan. Praktik-praktik ini membantu prosesnya tetap berjalan dengan baik seiring waktu:

• Tulis prompt sistem Anda sendiri. Saat menambahkan AI agent dan menentukan tugasnya, tulis prompt Anda sendiri untuk meningkatkan kualitas hasilnya. Ikuti praktik terbaik prompt engineering saat menulisnya, sertakan tanggung jawab agen, bagaimana agen tersebut sebaiknya mengambil keputusan, dan seperti apa output yang baik sesuai perannya.
• Uji satu workflow sebelum membuat workflow lainnya. Tentukan satu tujuan yang jelas, biarkan agen Anda mengerjakannya dari awal sampai akhir, lalu tinjau hasilnya sebelum menambahkan lebih banyak agen atau tujuan. Workflow paralel lebih sulit ditangani saat proses troubleshooting ketika terjadi masalah.
• Periksa log sejak awal dan lakukan secara rutin. 48 jam pertama biasanya memberi gambaran paling jelas. Agent akan dengan cepat menemukan salah konfigurasi, peran yang tidak jelas, dan API key yang belum ada. Membaca log di jendela ini akan sangat menghemat waktu nantinya.
• Jaga agar tujuan tetap relevan. Setiap tugas yang dibuat agent Anda selalu mengacu pada goal yang sedang aktif, goal yang sudah usang membuat agent Anda terus bekerja menuju sesuatu yang sudah tidak lagi Anda pedulikan. Buka menu Goals di dashboard Paperclip untuk mengedit target perusahaan Anda atau menambahkan target baru.
• Gunakan permintaan persetujuan sebagai loop feedback. Kalau permintaan CEO tidak sesuai dengan yang Anda harapkan, biasanya itu menjadi tanda bahwa system prompt atau tujuannya perlu dibuat lebih spesifik.
• Buat cadangan direktori data Anda. Struktur organisasi Paperclip, riwayat agent, dan log audit tersimpan dalam satu direktori data di server Anda. Lakukan backup secara rutin, terutama sebelum mengupgrade Paperclip atau mengubah konfigurasi VPS Anda.
• Dokumentasikan struktur organisasi Anda. Seiring tim agen Anda berkembang, simpan catatan sederhana tentang tugas masing-masing agen, adapter yang digunakan, dan tujuan yang didukungnya. Dengan begitu, Anda akan jauh lebih mudah meninjau kembali pengaturan tersebut setelah beberapa minggu tidak membukanya, atau mengajak orang lain untuk mengelolanya.

Untuk panduan lebih lanjut tentang cara menggunakan Paperclip setelah setup Anda sudah stabil, lihat panduan use case Paperclip kami.

Semua konten tutorial di website ini telah melalui peninjauan menyeluruh sesuai standar dan komitmen editorial Hostinger.

Penulis

Katerina Bosinaki

Katerina adalah Localization Project Manager di Hostinger, dengan pengalaman lebih dari 5 tahun dalam manajemen proyek dan latar belakang selama 6 tahun sebagai ahli bahasa. Ia berfokus untuk membuat teknologi lebih mudah diakses dengan mengubah panduan yang kompleks menjadi tutorial yang jelas dan mudah diikuti. Di waktu luangnya, ketika tidak mengikuti perkembangan terbaru dalam bidang lokalisasi, ia senang menonton film dan membaca buku.

Tutorial lain dari Katerina Bosinaki