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

Mengapa ZeroClaw Layak Dipasang

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

Di sinilah ZeroClaw menjadi menarik. Ini adalah runtime agent AI yang ringan yang dibangun di sekitar satu biner Rust, dengan dukungan untuk penyedia model yang dihosting daripada stack lokal yang berat di hari pertama. Dalam praktiknya, ini lebih dekat ke “runtime yang menggunakan alat terkontrol” daripada “chatbot di terminal.” Bagi pembaca yang penasaran tentang sudut pandang “alternatif OpenClaw”, daya tarik praktisnya 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 daripada 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. Ini adalah tonggak pertama yang tepat untuk panduan VPS yang ramah pemula, karena “bekerja” harus berarti respons pertama yang grounded yang dapat Anda periksa, bukan tur fitur yang panjang.

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

Apa itu ZeroClaw — dalam bahasa sederhana

ZeroClaw lebih baik dipahami sebagai runtime agent daripada “chatbot AI.” Model hanya satu bagian dari sistem. ZeroClaw adalah lapisan yang menghubungkan akun penyedia, pilihan model, profil agent, dan workspace yang dibatasi sehingga alat 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 penting lebih dari yang terdengar. Dalam artikel ini, workspace adalah ruangan yang diizinkan agent untuk bekerja. Itulah mengapa memasang ZeroClaw tidak sama dengan mengonfigurasi ZeroClaw: biner dapat ada di disk sementara penyedia, model, alias, dan workspace masih hilang atau salah kabel.

📝 Catatan: Instalasi yang berhasil hanya setengah dari cerita. Tonggak yang bermakna adalah konfigurasi yang berfungsi di bawah ~/.zeroclaw yang dapat mencapai penyedia 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 penyedia, dan runtime biner tunggal yang mudah dicoba di VPS.

Kasus penggunaan pertama yang baik sama-sama grounded: merangkum salinan repo yang aman, menjelaskan file konfigurasi, menangani tugas pembantu 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 memasang: baseline Ubuntu, prasyarat, dan keamanan

Sebelum Anda menjalankan installer, luangkan satu menit untuk mengonfirmasi 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 kunci API, dan mesin atau workspace berisiko rendah untuk sesi pertama.

Jalankan pemeriksaan di bawah ini terlebih dahulu. Dalam validasi yang ditampilkan di screenshot, mereka mengembalikan Ubuntu 24.04.4 LTS (Noble Numbat), x86_64, dan /usr/bin/curl. Itu cukup untuk mengonfirmasi 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 paling bersih karena menjaga walkthrough VPS-friendly dan menghindari setup model lokal di server. Jika Anda sudah menggunakan penyedia lain yang didukung, itu baik-baik saja, tetapi siapkan kunci API sebelum zeroclaw onboard mulai mengajukan pertanyaan. Tujuannya 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 sumber. Pikirkan rute prebuilt sebagai appliance siap pakai dan rute sumber 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 pemeriksaan first-run ini sebelum Anda melanjutkan:

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

Pasang ZeroClaw dengan skrip resmi

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

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

Di jalur instalasi ini, skrip berjalan non-interaktif dan mengambil jalur rilis pre-built secara otomatis. Dalam validasi yang dijalankan untuk panduan ini, skrip mendeteksi target Linux, mengunduh tarball rilis GitHub yang cocok, memverifikasi checksum, memasang aset dashboard web di bawah ~/.local/share/zeroclaw/web/dist, dan menempatkan biner zeroclaw di ~/.cargo/bin. Karena screenshot ditangkap dari akun root, jalur konkret yang ditampilkan adalah /root/.local/share/zeroclaw/web/dist, /root/.cargo/bin/zeroclaw, dan /root/.bashrc; di akun pengguna biasa, harapkan tata letak yang sama di bawah direktori home Anda sendiri.

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

💡 Tip: Di Linux, masalah post-install paling umum adalah PATH, bukan installer itu 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 membutuhkan perbaikan sementara untuk sesi saat ini, gunakan export satu baris yang ditampilkan di bawah.

Setelah biner berada di tempat, skrip selesai dengan pesan konfirmasi non-interaktif alih-alih meluncurkan setup secara otomatis. Dalam validasi yang dijalankan untuk panduan ini, pesan penutup itu menunjuk ke zeroclaw quickstart, tetapi biner “v0.7.5” yang diinstal 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 satu kali.

Untuk artikel ini, lanjutkan dengan zeroclaw onboard selanjutnya. Itu membuat walkthrough selaras dengan janji artikel yang sebenarnya: sesi agent pertama yang berfungsi di terminal, bukan pairing 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 biner dapat dipanggil di shell:

zeroclaw --version

Jika itu berhasil, instalasi itu 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 diciptakannya

Ini adalah titik di mana “diinstal” perlu menjadi “dikonfigurasi”. Di 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. Di akun non-root, tata letak yang sama akan berada di bawah direktori home Anda sendiri.

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

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

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

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

Ketika wizard menanyakan tentang pengaturan lanjutan, biarkan mereka mati untuk panduan ini. Mengaktifkannya adalah untuk override yang ditargetkan seperti suhu, timeout, URL dasar, atau protokol kawat.

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

Untuk memori, pilih SQLite with Vector Search (recommended). Ini adalah default terkuat di sini karena menjaga semuanya lokal sambil masih memberi Anda dukungan pencarian hybrid dan embedding.

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

Biarkan kontrol hardware dinonaktifkan. Setup VPS ini tidak memerlukan GPIO, papan terikat USB, atau probe debug.

Untuk penyedia terowongan publik, simpan 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. Kepribadian default cukup untuk validasi first-run.

Yang penting di sini bukan menghafal setiap panel wizard. Yang penting adalah jalur yang dibuktikan screenshot: workspace tunggal, penyedia OpenRouter, entri kunci API tersembunyi, pilihan model konkret, tidak ada override lanjutan, tidak ada channel ekstra, memori SQLite lokal, auto-save aktif, hardware mati, tidak ada terowongan publik, dan tidak ada penulisan ulang kepribadian. Itu lebih dari cukup untuk menghasilkan konfigurasi CLI pertama yang dapat digunakan di bawah ~/.zeroclaw.

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

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

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 ruangan operasi, bukan hanya biner 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 langsung pertama, jalankan pemeriksaan kesehatan yang ringkas:

zeroclaw status

zeroclaw doctor

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

Peringatan dan kesalahan yang tersisa tidak kritis untuk chat terminal: “tidak ada channel yang dikonfigurasi” diharapkan karena walkthrough dengan 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 selalu-aktif tidak berjalan lagi; dan keluhan listing model live OpenRouter lebih baik dibaca sebagai keterbatasan probe daripada bukti bahwa setup penyedia gagal, terutama karena output masih melaporkan openrouter: 344 models.

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

Sinyal kesuksesan di sini adalah operasional, bukan kosmetik. zeroclaw status adalah sumber kebenaran paling jelas untuk ringkasan runtime aktif, zeroclaw doctor memberi tahu Anda apakah ada yang penting rusak, dan output grep paling baik diperlakukan sebagai intip kasar ke entri terkait penyedia/model daripada yang sempurna. Harapkan wording dan kecocokan yang tepat untuk bervariasi menurut versi. Anda tidak mencari dinding teks hijau yang sempurna. Anda mencari ketiadaan pemblokir first-run 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 rahasia 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 pertama yang aman

Dengan konfigurasi dan workspace di tempat, luncurkan agent dalam mode interaktif:

zeroclaw agent

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

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 alat. Dalam run yang ditangkap, ZeroClaw meminta untuk menjalankan perintah shell read-only: “pwd && echo “—-” && ls -la”

Itu persis jenis perintah yang Anda inginkan untuk smoke test ini: mencetak jalur workspace dan mencantumkan konten tingkat atas tanpa mengubah apa pun. Setujui dengan Y untuk ya satu kali. Anda juga bisa menolaknya dengan N, tetapi kemudian agent akan kehilangan cara termudah untuk menjawab pertanyaan dari keadaan filesystem nyata alih-alih 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 harga yang ditentukan untuk openrouter/deepseek/deepseek-v4-pro. Itu tidak memblokir chat itu sendiri. Ini hanya berarti penggunaan token dapat dicatat dengan biaya nol sampai Anda menentukan harga model secara eksplisit.

Prompt ini kuat karena menguji tiga hal sekaligus. Pertama, ZeroClaw harus mencapai penyedia dan mendapatkan respons kembali. Kedua, agent harus memahami workspace yang dikonfigurasi. Ketiga, jawabannya harus cukup spesifik sehingga Anda dapat membandingkannya dengan apa yang sebenarnya 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 penyedia
• tidak ada “config not found” atau kegagalan model yang hilang
• jalur workspace yang benar muncul dalam jawaban
• file tingkat atas nyata dinamai, tanpa klaim bahwa apa pun diubah

Jika Anda menginginkan cara berbeda untuk memanggil agent, Anda dapat mengirim prompt yang sama sebagai perintah one-shot alih-alih tetap 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 alih-alih ajaib.

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 bekerja

Langkah berikutnya yang tepat bukan untuk 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 aman pertama berfungsi, pertahankan disiplin yang sama untuk fase berikutnya. Pindah ke salinan repo yang aman atau direktori catatan terlebih dahulu, pertahankan tugas read-only jika memungkinkan, dan perluas hak istimewa hanya setelah alur kerja dasar terasa dapat diprediksi.

Tugas tindak lanjut yang baik membosankan dengan sengaja: merangkum README, menjelaskan file konfigurasi, atau mencantumkan ide pembersihan tanpa mengubah apa pun. Jenis pekerjaan itu sinyal tinggi karena menggunakan runtime yang sama yang baru saja Anda validasi, tetapi tidak memaksa Anda ke akses tulis sebelum Anda mempercayai alat. Jika Anda menginginkan workspace 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 berikutnya yang baik, dalam urutan, 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, channel, 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 patut diketahui:

zeroclaw service install
zeroclaw service start
zeroclaw service status

Itu 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 walkthrough mereka sendiri.

Jika smoke test pertama ini berguna, VPS Ubuntu dari AlexHost adalah tempat alami untuk terus bereksperimen dengan runtime agent yang ringan tanpa mengubah hari pertama menjadi proyek platform penuh. Cara yang tepat untuk melanjutkan adalah keluar, bukan menyamping: gunakan docs setup, layanan, p