Cara Menginstal ZeroClaw: Panduan Cepat Ramah Pemula untuk Alternatif OpenClaw Ringan

Mengapa ZeroClaw layak dipasang

Jika Anda pernah memasang alat AI, melihat biner mendarat di “PATH” Anda, dan masih tidak memiliki bukti bahwa itu dapat mencapai model, memahami ruang kerja, atau menjawab dengan aman, Anda sudah memahami masalah yang dipecahkan panduan ini. Instalasi yang selesai hanya membuktikan file disalin. Itu tidak membuktikan runtime agen dapat digunakan.

Di sinilah ZeroClaw menjadi menarik. Ini adalah runtime agen AI ringan yang dibangun di sekitar satu biner Rust, dengan dukungan untuk penyedia model yang dihosting alih-alih tumpukan lokal yang berat sejak hari pertama. Dalam praktiknya, itu lebih dekat ke “runtime penggunaan alat yang terkontrol” daripada “chatbot di terminal.” Bagi pembaca yang penasaran tentang sudut “alternatif OpenClaw”, daya tarik praktis bukan hype atau benchmark. Ini adalah cerita instalasi yang lebih ringan, bobot ketergantungan yang lebih rendah, dan fakta bahwa mengujinya di VPS Ubuntu terasa dapat dikelola alih-alih berubah menjadi proyek infrastruktur penuh.

Artikel ini tetap fokus pada satu hasil: pasang ZeroClaw, jalankan “zeroclaw onboard”, verifikasi sesi CLI pertama yang aman, dan tinggalkan dengan ide realistis tentang apa yang harus dicoba selanjutnya. Itu adalah tonggak pertama yang tepat untuk panduan VPS yang ramah pemula, karena “bekerja” harus berarti respons pertama yang berdasar yang dapat Anda periksa, bukan tur fitur yang panjang.

📝 Catatan: Panduan ini membuktikan penggunaan CLI pertama yang berfungsi. Ini bukan panduan penyebaran produksi, dan itu tidak mencoba meliput Docker, gateway publik, atau layanan latar belakang

Apa itu ZeroClaw — dalam bahasa Inggris yang sederhana

ZeroClaw lebih baik dipahami sebagai agent runtime daripada “chatbot AI.” Model hanyalah satu bagian dari sistem. ZeroClaw adalah lapisan yang menghubungkan akun provider, pilihan model, profil agent, dan workspace yang dibatasi sehingga tool dapat melakukan lebih dari sekadar menjawab satu prompt secara terisolasi.

Empat istilah di bawah ini adalah yang paling penting dalam tutorial ini:

Ide workspace itu lebih penting daripada yang terdengar. Dalam artikel ini, workspace adalah ruangan yang diizinkan agent untuk bekerja. Itulah mengapa menginstal ZeroClaw tidak sama dengan mengonfigurasi ZeroClaw: binary dapat ada di disk sementara provider, model, alias, dan workspace masih hilang atau salah kabel.

📝 Catatan: Instalasi yang berhasil hanya setengah dari cerita. Milestone yang bermakna adalah konfigurasi yang berfungsi di bawah ~/.zeroclaw yang dapat menjangkau provider dan beroperasi di dalam workspace yang terlihat.

Ini juga cara paling bersih untuk menjelaskan mengapa beberapa orang melihat ZeroClaw sebagai alternatif OpenClaw tanpa memaksa perbandingan penuh. Nilainya bukan “OpenClaw ditulis ulang dalam Rust,” dan panduan ini tidak memperlakukannya dengan cara itu. Nilainya adalah postur self-hosting yang lebih ringan, fleksibilitas provider, dan runtime single-binary yang mudah dicoba di VPS.

Kasus penggunaan pertama yang baik sama-sama berdasarkan: merangkum salinan repo yang aman, menjelaskan file konfigurasi, menangani tugas helper read-only di dalam workspace berisiko rendah, atau menggunakannya sebagai asisten yang dibatasi untuk operator yang menginginkan visibilitas sebelum mereka mengizinkan perubahan nyata.

Sebelum Anda menginstal: baseline Ubuntu, prasyarat, dan keamanan

Sebelum Anda menjalankan installer, luangkan satu menit untuk memastikan bahwa VPS benar-benar cocok untuk jalur yang digunakan artikel ini. Persyaratan minimum sangat jelas: akses SSH ke VPS Ubuntu, curl, satu akun penyedia yang dihosting dengan API key, dan mesin atau workspace berisiko rendah untuk sesi pertama.

Jalankan pemeriksaan di bawah ini terlebih dahulu. Dalam validasi yang ditunjukkan di screenshot, mereka mengembalikan Ubuntu 24.04.4 LTS (Noble Numbat), x86_64, dan /usr/bin/curl. Itu cukup untuk mengkonfirmasi baseline panduan tanpa berpura-pura setiap server akan mengembalikan output yang identik.

cat /etc/os-release

uname -m
command -v curl

Untuk contoh penyedia yang dihosting, OpenRouter adalah default yang paling bersih karena menjaga VPS walkthrough tetap ramah dan menghindari setup model lokal di server. Jika Anda sudah menggunakan penyedia lain yang didukung, itu tidak masalah, tetapi siapkan API key sebelum zeroclaw onboard mulai mengajukan pertanyaan. Tujuannya di sini adalah kesuksesan pertama, bukan belanja penyedia, jadi satu jalur yang bersih lebih baik daripada mencoba mengevaluasi setiap penyedia dalam sesi yang sama.

ZeroClaw mendukung jalur instalasi prebuilt dan source. Pikirkan rute prebuilt sebagai appliance siap pakai dan rute source sebagai kit bangun-sendiri. Keduanya sah, tetapi mereka melayani pembaca yang berbeda. Untuk quickstart ini, hal penting adalah memahami perbedaannya sekarang dan membuat rekomendasi aktual di langkah instalasi.

⚠️ Peringatan: Gunakan daftar periksa first-run ini sebelum Anda melanjutkan:

• tetap berada di workspace berisiko rendah
• pertahankan perilaku supervised default
• hindari eksposur publik dan data produksi
• buat tugas pertama read-only dengan sengaja

Instal ZeroClaw dengan skrip resmi

Setelah preflight selesai, gunakan installer resmi sebagai jalur utama. Ini adalah rute yang didukung terpendek untuk quickstart Ubuntu VPS:

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

Pada jalur instal ini, skrip berjalan non-interaktif dan secara otomatis mengambil jalur rilis yang telah dibangun sebelumnya. Dalam validasi untuk panduan ini, skrip mendeteksi target Linux, mengunduh tarball rilis GitHub yang sesuai, memverifikasi checksum, menginstal aset dashboard web di bawah ~/.local/share/zeroclaw/web/dist, dan menempatkan binary zeroclaw di ~/.cargo/bin. Karena screenshot diambil dari akun root, jalur konkret yang ditampilkan adalah /root/.local/share/zeroclaw/web/dist, /root/.cargo/bin/zeroclaw, dan /root/.bashrc; pada akun pengguna biasa, harapkan tata letak yang sama di bawah direktori home Anda sendiri.

Jalur cepat itu bukan jalan pintas atau instal yang kurang resmi. Ini adalah rute quickstart normal untuk audiens yang panduan ini ditulis untuk: unduh rilis yang sesuai, verifikasi, dan tempatkan binary di ~/.cargo/bin/zeroclaw. Jika Anda sengaja menginginkan build dari sumber, gunakan jalur repo-clone di bawah ini sebagai gantinya dari mengharapkan alur installer ini berhenti dan menawarkan pilihan build terpisah.

💡 Tip: Di Linux, masalah pasca-instal paling umum adalah PATH, bukan instalnya sendiri. Ikuti saran installer untuk menambahkan export PATH=”$HOME/.cargo/bin:$PATH” ke profil shell Anda dan muat ulang dengan source ~/.bashrc (atau buka kembali shell). Jika Anda hanya memerlukan perbaikan sementara untuk sesi saat ini, gunakan export satu baris yang ditampilkan di bawah.

Setelah binary berada di tempatnya, skrip selesai dengan pesan konfirmasi non-interaktif alih-alih meluncurkan setup secara otomatis. Dalam validasi untuk panduan ini, pesan penutup itu menunjuk ke zeroclaw quickstart, tetapi binary “v0.7.5” yang terinstal mengekspos onboard sebagai subperintah setup aktual di zeroclaw –help. Ini juga menunjukkan bahwa zeroclaw daemon adalah jalur untuk daemon selalu aktif plus dashboard web sementara zeroclaw agent adalah jalur chat CLI sekali jalan.

Untuk artikel ini, lanjutkan dengan zeroclaw onboard berikutnya. Itu membuat panduan tetap selaras dengan janji aktual artikel: sesi agent pertama yang berfungsi di terminal, bukan pasangan dashboard atau runtime selalu aktif.

Jika Anda sadar keamanan dan lebih suka memeriksa installer sebelum menjalankannya, gunakan pendekatan alternatif ini:

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

Sebelum Anda memikirkan tentang penyedia atau prompt, verifikasi bahwa binary dapat dipanggil di shell:

zeroclaw --version

Jika itu berfungsi, instalnya sendiri berhasil. Jika shell mengatakan command not found, terapkan perbaikan PATH sementara di bawah dan uji lagi:

export PATH="$HOME/.cargo/bin:$PATH"

Memisahkan langkah ini dari konfigurasi penting. zeroclaw –version yang berfungsi memberi tahu Anda bahwa masalah installer diselesaikan sebelum Anda mulai men-debug setup penyedia.

Jalankan zeroclaw onboard dan periksa apa yang dibuat

Ini adalah titik di mana “installed” perlu menjadi “configured”. Pada jalur instalasi non-interaktif yang digunakan di atas, skrip secara eksplisit melewati prompt setup. Jika pesan installer menyebutkan zeroclaw quickstart tetapi biner tidak mengenalinya, percayai zeroclaw –help dan mulai wizard first-run dengan:

zeroclaw onboard

Wizard membuka di layar workspace. Dalam run yang ditangkap, jalur workspace default adalah /root/.zeroclaw/workspace. Kecuali Anda memiliki alasan kuat untuk memindahkannya, terima default. Pada akun non-root, tata letak yang sama akan berada di direktori home Anda sendiri.

Untuk walkthrough CLI pemula ini, biarkan profil multi-workspace dinonaktifkan. Mengaktifkannya membuat direktori memori, secrets, dan audit terpisah per engagement, yang dapat berguna nanti, tetapi menambah overhead mental ekstra untuk smoke test pertama.

Di layar provider, pilih OpenRouter. Daftarnya jauh lebih besar dari yang dibutuhkan panduan pemula, yang adalah alasan mengapa membantu untuk memilih satu jalur hosted yang bersih dan tetap berpegang padanya untuk run pertama.

Tempel kunci API OpenRouter Anda saat diminta. Input tersembunyi, dan prompt secara eksplisit mencatat bahwa ZeroClaw menyimpan secret melalui keyring OS jika memungkinkan alih-alih meminta Anda untuk hard-code ke dalam config.toml.

Daftar model OpenRouter panjang. Dalam run yang ditangkap, deepseek/deepseek-v4-pro dipilih. Anda dapat memilih model OpenRouter terkini lainnya jika lebih suka, tetapi sisa walkthrough ini mengikuti seleksi yang tepat itu.

Ketika wizard menanyakan tentang pengaturan lanjutan, biarkan mereka mati untuk panduan ini. Mengaktifkannya adalah untuk override yang ditargetkan seperti temperature, timeout, base URL, atau wire protocol.

Di layar Channels, pilih Done tanpa menambahkan Discord, Telegram, Slack, atau permukaan eksternal lainnya. Itu membuat validasi pertama CLI-only. Anda dapat menambahkan channels nanti setelah jalur agent lokal berfungsi.

Untuk memory, pilih SQLite with Vector Search (recommended). Ini adalah default terkuat di sini karena menjaga semuanya lokal sambil tetap memberi Anda dukungan hybrid search dan embeddings.

Biarkan auto-save diatur ke Yes sehingga prompt Anda sendiri dicatat sebagai conversation history. Jika nanti Anda menginginkan kontrol manual yang lebih ketat, Anda dapat mematikannya dan hanya menyimpan memory secara eksplisit.

Biarkan hardware control dinonaktifkan. Setup VPS ini tidak memerlukan GPIO, papan tethered USB, atau debug probes.

Untuk public tunnel provider, pertahankan di none. Itu sesuai dengan postur keamanan artikel ini: tidak ada eksposur publik selama smoke test pertama.

Ketika langkah Personality mengatakan sudah dikonfigurasi, biarkan Reconfigure? di No. Personality default cukup untuk validasi first-run.

Yang penting di sini bukan menghafal setiap panel wizard. Yang penting adalah jalur yang dibuktikan screenshot: workspace tunggal, provider OpenRouter, entry kunci API tersembunyi, pilihan model konkret, tidak ada override lanjutan, tidak ada channel ekstra, memory SQLite lokal, auto-save on, hardware off, tidak ada public tunnel, dan tidak ada personality rewrite. Itu lebih dari cukup untuk menghasilkan konfigurasi CLI yang dapat digunakan pertama kali di bawah ~/.zeroclaw.

Setelah onboarding selesai, konfirmasi bahwa direktori config utama dan workspace ada:

Jika run onboarding selesai dengan bersih, Anda harus kembali ke shell dengan pesan config-loaded seperti di bawah ini:

ls ~/.zeroclaw
ls ~/.zeroclaw/workspace

Dalam run yang ditangkap, ~/.zeroclaw berisi config.toml dan workspace/, dan workspace itu sendiri menunjukkan IDENTITY.md dan SOUL.md.

Itu sudah cukup untuk membuktikan ZeroClaw sekarang memiliki operating room, bukan hanya binary yang diinstal. Itu juga mengapa analogi workspace berguna: Anda memeriksa bahwa ruangan ada, bahwa agent memiliki konteks di dalamnya, dan bahwa setup bergerak melampaui “installer selesai.” File seperti IDENTITY.md dan SOUL.md bukan dekoratif. Mereka adalah bagian dari konteks yang digunakan ZeroClaw untuk memahami bagaimana seharusnya berperilaku di dalam workspace itu.

Sebelum prompt live pertama, jalankan health check yang kompak:

zeroclaw status

zeroclaw doctor

Untuk smoke test CLI-only pertama ini, jangan panik jika zeroclaw doctor tidak sempurna bersih. Dalam run yang ditangkap, pemeriksaan penting lulus: file config ditemukan, provider openrouter valid, kunci API dikonfigurasi, model default diatur, dan workspace ada dan dapat ditulis.

Peringatan dan error yang tersisa tidak kritis untuk terminal chat: “no channels configured” diharapkan karena walkthrough secara sengaja melewati Discord, Telegram, dan channel eksternal lainnya; AGENTS.md not found (optional) secara eksplisit non-blocking; daemon_state.json not found hanya berarti daemon always-on belum berjalan; dan keluhan listing model live OpenRouter lebih baik dibaca sebagai keterbatasan probe daripada bukti bahwa setup provider gagal, terutama karena output masih melaporkan openrouter: 344 models.

grep -E 'default_provider|default_model|[agents.|[risk_profiles.' ~/.zeroclaw/config.toml

Sinyal sukses di sini adalah operasional, bukan kosmetik. zeroclaw status adalah sumber kebenaran terbersih untuk ringkasan runtime aktif, zeroclaw doctor memberi tahu Anda apakah ada yang penting rusak, dan output grep paling baik diperlakukan sebagai peek kasar ke dalam entri config terkait provider/model daripada yang sempurna. Harapkan wording dan kecocokan yang tepat bervariasi menurut versi. Anda tidak mencari dinding teks hijau yang sempurna. Anda mencari ketiadaan first-run blockers dan kehadiran data konfigurasi nyata.

📝 Catatan: config.toml mungkin tidak menampilkan kunci API Anda dalam plaintext. Itu bisa normal. Dalam run onboarding yang ditangkap, prompt kunci API secara eksplisit mengatakan secret akan disimpan melalui keyring OS jika memungkinkan, jadi “tidak ada kunci terlihat dalam file TOML” bukan hal yang sama dengan “setup gagal.”

Mulai chat CLI aman pertama

Dengan config dan workspace sudah siap, luncurkan agent dalam mode interaktif:

zeroclaw agent

Dalam run yang ditangkap, ZeroClaw memuat config, menginisialisasi memory yang didukung SQLite, mencetak banner mode interaktif, dan turun ke prompt >. Tujuannya bukan untuk memulai demo yang mencolok. Tujuannya adalah membuktikan konektivitas end-to-end, konfigurasi yang valid, dan kesadaran workspace yang grounded dalam satu langkah berisiko rendah. Tes read-only memberikan Anda sinyal yang jauh lebih berguna pada tahap ini daripada prompt “lihat apa yang bisa dilakukan” yang capable-write.

Untuk prompt pertama, gunakan pemeriksaan read-only yang tepat ini:

tell me your current workspace path, list the top-level files you can see there, and briefly explain what each one is for. Do not create, edit, or delete anything.

Karena runtime dalam mode supervised, balasan pertama yang berguna mungkin memerlukan persetujuan tool. Dalam run yang ditangkap, ZeroClaw meminta untuk menjalankan perintah shell read-only: “pwd && echo “—-” && ls -la”

Itulah persis jenis perintah yang Anda inginkan untuk smoke test ini: ia mencetak path workspace dan mencantumkan konten tingkat atas tanpa mengubah apa pun. Setujui dengan Y untuk yes satu kali. Anda juga bisa menolaknya dengan N, tetapi kemudian agent akan kehilangan cara termudah untuk menjawab pertanyaan dari keadaan filesystem nyata daripada menebak.

📝 Catatan: Anda juga dapat melihat peringatan pelacakan biaya untuk model OpenRouter yang dipilih sebelum prompt persetujuan. Dalam run yang ditangkap, ZeroClaw memperingatkan bahwa tidak ada entri pricing yang ditentukan untuk openrouter/deepseek/deepseek-v4-pro. Itu tidak memblokir chat itu sendiri. Itu hanya berarti penggunaan token dapat dicatat dengan biaya nol sampai Anda menentukan pricing model secara eksplisit.

Prompt ini kuat karena menguji tiga hal sekaligus. Pertama, ZeroClaw harus menjangkau provider dan mendapatkan respons kembali. Kedua, agent harus memahami workspace yang dikonfigurasi. Ketiga, jawabannya harus cukup spesifik sehingga Anda dapat membandingkannya dengan apa yang benar-benar ada di disk. Dengan kata lain, ini membuktikan agent tetap berada di dalam ruangan yang diberikan.

Balasan pertama yang baik harus memenuhi empat kondisi:

• tidak ada kesalahan autentikasi atau provider
• tidak ada “config not found” atau kegagalan missing-model
• path workspace yang benar muncul dalam jawaban
• file tingkat atas nyata dinamai, tanpa klaim bahwa apa pun telah diubah

Jika Anda ingin cara berbeda untuk menjalankan agent, Anda dapat mengirim prompt yang sama sebagai perintah one-shot daripada tetap berada dalam sesi interaktif. Perlakukan ini sebagai opsional, bukan walkthrough utama. Jalur interaktif masih merupakan pengalaman pertama yang lebih baik karena membuat runtime terasa dapat diamati daripada magis.

zeroclaw agent -m "tell me your current workspace path, list the top-level files you can see there, and briefly explain what each one is for. Do not create, edit, or delete anything."

Apa yang harus dilakukan selanjutnya setelah ZeroClaw berfungsi

Langkah selanjutnya yang tepat bukan mengaktifkan setiap fitur yang dapat Anda temukan. Ini adalah menambahkan satu lapisan terkontrol pada satu waktu, sehingga Anda selalu tahu perubahan mana yang memperkenalkan risiko baru atau gesekan baru.

💡 Tip: Setelah chat pertama yang aman berfungsi, pertahankan disiplin yang sama untuk fase berikutnya. Pindah ke salinan repo yang aman atau direktori catatan terlebih dahulu, jaga tugas tetap read-only jika memungkinkan, dan perluas hak istimewa hanya setelah alur kerja dasar terasa dapat diprediksi.

Tugas tindak lanjut yang baik sengaja membosankan: ringkas README, jelaskan file konfigurasi, atau buat daftar ide pembersihan tanpa mengubah apa pun. Jenis pekerjaan ini bernilai tinggi karena menggunakan runtime yang sama yang baru saja Anda validasi, tetapi tidak memaksa Anda ke akses tulis sebelum Anda mempercayai alat tersebut. Jika Anda menginginkan ruang kerja nyata pertama yang lebih baik, gunakan salinan repo yang aman, direktori catatan staging, atau folder docs internal kecil daripada apa pun yang menghadap produksi.

Langkah-langkah selanjutnya yang baik, secara berurutan, terlihat seperti ini:

• arahkan ZeroClaw ke salinan repo yang aman atau direktori catatan
• coba satu tugas pembantu read-only
• bandingkan penyedia hanya setelah alur kerja dasar terasa stabil
• lihat layanan, saluran, atau Docker nanti sebagai proyek terpisah

Jika Anda ingin membandingkan penyedia nanti, lakukan itu setelah alur kerja dasar stabil. Jika Anda menginginkan langkah infrastruktur berikutnya setelah kesuksesan CLI, ini adalah perintah yang perlu diketahui:

zeroclaw service install
zeroclaw service start
zeroclaw service status

Ini adalah titik di mana artikel ini harus berhenti dan topik berikutnya harus dimulai. Manajemen layanan, penerapan Docker, gateway publik, saluran pesan, dan pengerasan keamanan yang lebih dalam layak mendapatkan panduan mereka sendiri.

Jika tes smoke pertama ini berguna, Ubuntu VPS dari AlexHost adalah tempat alami untuk terus bereksperimen dengan runtime agen ringan tanpa mengubah hari pertama menjadi proyek platform penuh. Cara yang tepat untuk melanjutkan adalah keluar, bukan menyamping: gunakan setup resmi, layanan, penyedia, dan dokumentasi keamanan ketika Anda siap untuk lapisan berikutnya.

Kesimpulan: dari penasaran ke operasional

Hasil penting bukan bahwa ZeroClaw terinstal. Hasil penting adalah bahwa ZeroClaw menjawab dengan aman dari sesi pertama yang terverifikasi di VPS. Itu berarti baseline Ubuntu sudah diperiksa, installer berjalan, “zeroclaw onboard” selesai, config dan workspace dibuat, health checks terlihat masuk akal, dan balasan read-only pertama kembali berdasarkan konteks workspace nyata.

Itu adalah titik henti yang bermakna. Jaga eksperimen awal Anda tetap kecil, diawasi, dan dapat diamati, kemudian perluas satu lapisan pada satu waktu menuju layanan, batas keamanan yang lebih ketat, atau integrasi saluran ketika Anda benar-benar membutuhkannya. Untuk quickstart VPS Ubuntu pertama, kepercayaan yang terkontrol adalah kemenangan. Anda tidak perlu meninggalkan artikel ini dengan stack otomasi lengkap. Anda perlu meninggalkannya mengetahui runtime berfungsi, batas keamanan tetap utuh, dan langkah berikutnya adalah pilihan Anda bukan sebuah tebakan.