OpenClaw: apa itu, cara memasangnya, dan menghubungkannya ke Telegram

OpenClaw muncul di linimasa saya musim dingin lalu, ketika proyek ini berganti nama dua kali dalam seminggu dan memperoleh ratusan ribu bintang di GitHub. Sejak itu, semakin banyak orang mencari “instalasi openclaw” dan “openclaw telegram”.

Di bawah ini, saya membahas dokumentasi resminya: apa sebenarnya alat ini, apa bedanya dengan Claude Code, cara memasangnya di Windows, macOS, atau Linux, cara memilih model, dan cara menghubungkan bot Telegram. Saya juga membahas keamanan secara terpisah, karena OpenClaw pernah terlibat dalam beberapa insiden besar.

Pelajari cara menggunakan layanan ini di dokumentasi Ailoot.

Apa itu OpenClaw dengan bahasa sederhana?#

OpenClaw menghubungkan model AI ke bot Telegram Anda. Dengan alat serta izin terkait yang dikonfigurasi, asisten dapat merangkum pesan atau menjadwalkan pengingat. Proses gateway dan konfigurasi lokal berjalan di komputer atau server Anda. Ini tidak menjadikan semua percakapan lokal: saat memilih model cloud, permintaan dan konteks percakapan terkait dikirim ke penyedia tersebut. Jika terhubung melalui Ailoot, permintaan melewati Ailoot ke penyedia model terpilih. Inferensi lokal membutuhkan model lokal tanpa fallback cloud; pesan Telegram tetap melewati Telegram, dan alat yang diaktifkan dapat menghubungi layanan lain.

Proyek ini dikembangkan oleh komunitas open source OpenClaw. Repositori GitHub dibuat pada 24 November 2025, dan per 22 Agustus 2026, repositori tersebut memiliki 387 ribu bintang dan 81 ribu fork—salah satu proyek terbuka yang tumbuh paling cepat tahun ini. Bahasa pemrogramannya adalah TypeScript.

Riwayat nama proyek ini cukup lucu dan layak diketahui agar Anda tidak bingung saat membaca artikel lama. Awalnya proyek ini bernama Warelay, sebuah gateway untuk WhatsApp. Kemudian namanya menjadi Clawdbot. Pada Januari 2026, Anthropic meminta pergantian nama karena merek dagang, dan proyek ini menggunakan nama Moltbot selama beberapa hari. Pada 30 Januari 2026, proyek ini mendapat nama akhirnya: OpenClaw. Jadi, jika Anda menemukan petunjuk tentang “Clawdbot” atau “Moltbot”, itu proyek yang sama; artikel tersebut hanya ditulis sebelum pergantian nama.

Maskot proyek ini adalah Molty si lobster, dan “berganti kulit” menjadi metafora resmi untuk setiap pergantian nama.

Apa bedanya OpenClaw dengan Claude Code dan Hermes Agent?#

Saya sering ditanya tentang perbedaan ini karena dari luar semuanya tampak seperti “agen AI”. Berikut tabel perbandingannya:

Cara membaca tabel ini. Saya menggunakan Claude Code untuk pengembangan: alat ini paling unggul saat Anda membutuhkan model yang kuat dan bekerja dengan kode. OpenClaw dan Hermes digunakan untuk hal lain: agen yang berjalan terus-menerus, berada di Telegram, mengingat percakapan kemarin, dan menyelesaikan tugas sesuai jadwal. Pilihan antara OpenClaw dan Hermes lebih sulit; sudah ada panduan Hermes dengan petunjuk instalasi dan pengaturan.

Jika Anda sedang memilih alat, mulailah dengan ikhtisar: alat yang digunakan orang untuk menulis kode pada 2026 dan tugas yang sebaiknya didelegasikan kepada agen AI. Saya juga punya artikel terpisah tentang memasang Claude Code.

Apa yang diperlukan sebelum memasang OpenClaw?#

Periksa versi Node terlebih dahulu—ini satu-satunya persyaratan yang ketat:

node --version

Versi 22.22.3+, 24.15+, dan 25.9+ didukung; Node 26 direkomendasikan. Jika perintah menghasilkan “command not found” atau versinya sudah lama, jangan khawatir: penginstal resmi akan mengunduh Node versi terbaru untuk Anda, jadi Anda tidak perlu memasangnya secara manual.

Hal berikutnya yang perlu diputuskan adalah model. OpenClaw tidak berpikir sendiri: OpenClaw memanggil model yang Anda pilih. Berikut pilihan biayanya: kunci Anthropic, OpenAI, atau Google—Anda membayar penyedia sesuai penggunaan sebenarnya; atau model lokal melalui Ollama—gratis dari segi biaya, tetapi membutuhkan perangkat keras yang memadai. Saya membahas kedua pilihan ini di bagian terpisah di bawah.

Bagaimana cara memasang OpenClaw di macOS dan Linux?#

Cara yang direkomendasikan adalah menggunakan penginstal resmi:

1. Jalankan penginstal

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   Skrip ini mendeteksi OS Anda, memeriksa Node (dan memasangnya jika perlu), memasang OpenClaw, lalu membuka wizard pengaturan. Jika ingin melihat-lihat sebelum menjalankan wizard, tambahkan flag: bash -s -- --no-onboard.

2. Periksa apakah semuanya berhasil dipasang

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   Perintah pertama menampilkan versi, perintah kedua memeriksa konfigurasi, dan perintah ketiga memastikan gateway berjalan dan mendengarkan di port 18789.

Jika Anda menggunakan npm dan ingin mengelola instalasi sendiri:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Ada kendala baru-baru ini di sini yang dibahas dalam bab terpisah pada dokumentasi. npm 12 memblokir skrip instalasi paket secara default, dan tanpa flag --allow-scripts=openclaw, instalasi akan berhenti dengan pesan allowScripts. Di npm 11.15 dan versi lebih lama, flag ini tidak diperlukan—belum ada pembatasan seperti itu. Periksa versi Anda dengan: npm --version.

Flag --install-daemon pada perintah kedua mengatur mulai otomatis: di macOS, berupa LaunchAgent; di Linux, berupa layanan systemd. Flag memulai gateway setelah reboot atau login, sesuai syarat pengelola layanan. Flag tidak mencegah tidur atau menjaga gateway berjalan ketika komputer mati. Balasan Telegram memerlukan host terjaga serta terhubung jaringan; gunakan server selalu aktif jika perlu balasan saat laptop tidur atau mati.

Bagaimana cara memasang OpenClaw di Windows?#

Pilihan pertama ditujukan bagi orang yang lebih suka jendela aplikasi daripada terminal. Windows Hub adalah aplikasi OpenClaw native untuk Windows 10 (20H2+) dan Windows 11, dan saat ini masih dalam versi beta. Buka halaman rilis Windows Hub dan unduh penginstal untuk prosesor Anda: OpenClawCompanion-Setup-x64.exe untuk komputer biasa, atau arm64 untuk ARM. Setelah instalasi, OpenClaw Companion akan muncul di menu Start, dengan ikon tray, jendela obrolan, dan pengaturan.

Saat pertama kali dibuka, aplikasi akan menawarkan “Set up locally”—terima pilihan tersebut. Aplikasi akan membuat lingkungan WSL khusus bernama OpenClawGateway, memasang gateway di dalamnya, lalu menghubungkannya. Instalasi Ubuntu yang sudah ada tidak akan disentuh, jika Anda memilikinya.

Pilihan kedua adalah melalui PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw gateway install

Baris pertama memasang OpenClaw; baris kedua mendaftarkan mulai otomatis melalui Windows Task Scheduler. Jika kebijakan komputer Anda memblokir pembuatan tugas, OpenClaw akan beralih sendiri ke cara cadangan: pintasan di folder Startup, agar gateway berjalan saat Anda masuk.

Pilihan ketiga adalah WSL2, yang menurut dokumentasi merupakan lingkungan runtime paling kompatibel di Windows. Pasang Ubuntu, aktifkan systemd, lalu ikuti petunjuk Linux dari bagian sebelumnya:

wsl --install -d Ubuntu-24.04

Di dalam WSL, aktifkan systemd di /etc/wsl.conf (bagian [boot], baris systemd=true), mulai ulang WSL dengan menjalankan wsl --shutdown dari PowerShell, lalu pasang OpenClaw menggunakan perintah Linux. Jika istilah “distribution” dan “systemd” tidak berarti apa-apa bagi Anda, gunakan Windows Hub; semua itu akan dilakukan untuk Anda.

Bagaimana cara memilih model dan menyelesaikan pengaturan awal?#

Model adalah mesin asisten. Wizard pengaturan akan menawarkan daftar penyedia, dan berikut tiga pilihan praktis:

Ada detail menarik tentang Anthropic: jika Claude Code sudah terpasang di perangkat dan Anda sudah masuk, OpenClaw dapat menggunakan login tersebut. Pertama, jalankan claude auth login di perangkat, lalu beri tahu OpenClaw untuk menggunakannya:

openclaw models auth login --provider anthropic --method cli --set-default

Jika gateway berjalan sebagai layanan latar belakang (seperti saat menggunakan --install-daemon), kunci harus tersedia bagi layanan tersebut. Untuk itu, masukkan kunci ke ~/.openclaw/.env—wizard akan melakukannya untuk Anda, jadi Anda tidak perlu mengedit berkas secara manual. Setelah ada perubahan, mulai ulang dan periksa:

openclaw gateway restart
openclaw models status

Jika biaya menjadi kendala, model lokal pada bagian Ollama adalah pilihan yang tepat.

Bagaimana cara menghubungkan OpenClaw ke Telegram?#

Telegram adalah kanal tercepat untuk dihubungkan: Anda hanya memerlukan token bot, tanpa verifikasi akun bisnis. Dokumentasi menyebutnya cara termudah untuk mulai berkirim pesan dengan asisten melalui ponsel. Berikut proses lengkapnya:

1. Buat bot dengan BotFather

   Buka obrolan Telegram dengan @BotFather (pastikan nama penggunanya persis seperti itu—banyak akun palsu), kirim /newbot, lalu pilih nama dan nama pengguna yang diakhiri dengan bot. Anda akan menerima token seperti 123456789:ABCdef... sebagai balasan—token ini adalah kunci bot Anda, jadi jaga seperti kata sandi.

2. Masukkan token ke OpenClaw

   Cara termudah adalah melalui wizard: jalankan openclaw configure dan pilih kanal Telegram. Alternatif manualnya adalah pengaturan channels.telegram.botToken atau variabel lingkungan TELEGRAM_BOT_TOKEN. Dokumentasi secara khusus menyatakan bahwa perintah openclaw channels login telegram tidak ada; Telegram hanya terhubung melalui token.

3. Jalankan gateway dan kirimi bot pesan

   openclaw gateway
   

   Buka bot Anda di Telegram dan kirimi sesuatu. Bot akan membalas dengan kode pemasangan delapan karakter. Ini adalah langkah perlindungan: pesan tidak akan diproses sebelum Anda menyetujui pengirimnya.

4. Setujui diri Anda sendiri

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   Kode berlaku selama satu jam, jadi jangan menunggu terlalu lama. Pengirim pertama yang disetujui otomatis menjadi pemilik perintah istimewa.

Ada dua hal rumit yang sering ditemui orang.

Pertama, grup. OpenClaw memblokir semua grup secara default: Anda harus secara eksplisit mengizinkan bot di pengaturan channels.telegram.groups dan tetap mengaktifkan mode requireMention: true di dalam grup. Setelah itu, bot hanya akan membalas saat dipanggil dengan nama pengguna dan tidak akan ikut masuk ke percakapan umum. Telegram juga memiliki mode privasi bot sendiri: di grup, bot secara default hanya melihat perintah. Matikan melalui @BotFather dengan /setprivacy. Setelah mengubahnya, Anda perlu menghapus bot dari grup dan menambahkannya kembali; jika tidak, Telegram tidak akan menerapkan pengaturan tersebut.

Kedua, jangan membuka akses untuk semua orang. Pengaturan menyediakan mode dmPolicy: "open" dengan tanda bintang di daftar akses: siapa pun yang menemukan bot berdasarkan nama pengguna dapat memberinya perintah. Untuk asisten pribadi, ini merupakan cara langsung untuk memberi orang lain kendali atas komputer Anda. Tetap aktifkan pemasangan dengan kode atau masukkan ID numerik Anda di allowFrom.

Bagaimana cara menjalankan OpenClaw dengan model lokal melalui Ollama?#

Model lokal berjalan pada perangkat keras Anda dan tidak menimbulkan biaya token penyedia model bila hanya memakai inferensi lokal. Pilih Local only tanpa fallback cloud agar inferensi tetap lokal. Pesan Telegram tetap melewati jaringan Telegram, dan alat online yang diaktifkan dapat mengirim data ke layanan lain.

1. Pasang Ollama

   Unduh penginstal dari ollama.com/download—tersedia versi untuk macOS, Windows, dan Linux.

2. Unduh model

   ollama pull gemma4
   

3. Hubungkan Ollama ke OpenClaw

   openclaw onboard
   

   Pilih penyedia Ollama dan mode: Local only (model Anda sendiri), Cloud only (model dari ollama.com), atau Cloud + Local. Wizard akan menemukan server lokal dan menampilkan model yang sudah terpasang.

4. Periksa

   openclaw models list --provider ollama
   

Berikut catatan jujurnya, tanpa itu bagian ini akan terdengar seperti iklan. Dokumentasi OpenClaw menyatakan secara langsung bahwa penggunaan agen lokal yang nyaman membutuhkan perangkat keras setara dengan dua Mac Studio yang spesifikasinya penuh, sedangkan kartu grafis 24 GB hanya mampu menangani permintaan ringan dengan jeda. Model kecil dan sangat terkompresi memotong konteks dan kurang tahan terhadap instruksi berbahaya yang disembunyikan dalam teks orang lain. Dalam praktik sehari-hari: model lokal di laptop yang bagus cukup untuk “mencobanya dan memahami cara kerjanya”, tetapi model cloud masih jauh lebih andal untuk pekerjaan harian dengan asisten yang menggunakan alat.

Satu peringatan lagi dari dokumentasi, bagi siapa pun yang menyiapkan WSL2 + Ollama + GPU NVIDIA: penginstal Ollama Linux resmi mengaktifkan mulai otomatis dengan kebijakan mulai ulang “always”, dan pada WSL2 dengan GPU hal ini dapat membuat komputer terus-menerus memulai ulang. Solusinya adalah menonaktifkan mulai otomatis layanan. Jika Anda mengalaminya, lihat bagian pemecahan masalah di halaman Ollama pada dokumentasi.

Seberapa aman menjalankan OpenClaw?#

Saya akan mulai dari poin utama yang tidak dipahami semua orang. OpenClaw memiliki akses ke komputer Anda: berkas, perintah, dan browser. Dokumentasi menjelaskannya dengan gamblang: proyek ini dirancang untuk satu pengguna tepercaya, dan Anda tidak boleh memberi orang luar akses ke bot. Jika seseorang dapat mengirim pesan ke agen Anda, mereka dapat menggunakannya untuk bertindak di komputer Anda.

Langkah minimum yang praktis:

1. Tetap aktifkan pemasangan dengan kode atau gunakan daftar akses—saya membahas pengaturannya di bagian Telegram.
2. Jangan membuka gateway ke luar kecuali memang diperlukan. Secara default, gateway hanya mendengarkan di komputer Anda; biarkan seperti itu.
3. Jalankan pemeriksaan bawaan setelah mengubah konfigurasi:

openclaw security audit

Pemeriksaan ini mendeteksi akses terbuka, izin alat yang terlalu luas, token lemah, dan port yang terbuka. Dengan flag --fix, beberapa temuan dapat diperbaiki secara otomatis.

Catatan terpisah tentang penipuan—dan ini bukan sekadar dugaan. Ketika proyek ini mengganti nama secara mendadak pada Januari 2026, bot pemburu nama mengambil alih alamat lama dalam hitungan detik dan langsung memasang dompet kripto; “pengembang OpenClaw” palsu mulai mempromosikan penipuan token. Ada dua aturan tegas yang bisa ditarik dari kejadian ini. Unduh OpenClaw hanya dari openclaw.ai atau github.com/openclaw/openclaw. Proyek ini juga tidak memiliki mata uang kripto: “token OpenClaw” apa pun adalah penipuan. Jangan pernah mengirim uang untuk itu.

Apa yang dapat dilakukan OpenClaw setelah instalasi?#

Berikut hal-hal yang akan saya coba, secara berurutan:

1. Gateway dan model. Jalankan openclaw gateway status, lalu buka openclaw dashboard. Panel yang termuat mengonfirmasi Control UI dapat dijangkau. Kirim “Reply with: model connection test” di chat-nya dan periksa bahwa jawaban AI tiba; memuat halaman saja tidak menguji model.
2. Telegram dan tugas yang dituju. Setelah mengonfigurasi bot serta menyetujui pairing Anda sendiri, kirim pesan baru ke bot tersebut di Telegram dan periksa jawabannya tiba di sana. Kemudian coba satu tugas terbatas dengan hasil terlihat, misalnya merangkum folder uji tanpa data sensitif yang sudah Anda izinkan untuk dibaca. Untuk pengingat, periksa jadwal tersimpan serta pengingat yang benar-benar terkirim secara terpisah. Jawaban di dashboard tidak membuktikan pengiriman Telegram atau pelaksanaan jadwal.
3. Tugas terjadwal. Asisten dapat menjalankan pekerjaan sesuai jadwal—ringkasan pagi di Telegram, pemeriksaan email berkala. Itulah alasan gateway perlu terus berjalan.
4. Memori. OpenClaw menyimpan memori jangka panjang dalam berkas Markdown biasa di folder kerjanya: siapa Anda, cara merespons Anda, dan hal-hal yang diingatnya dari percakapan sebelumnya. Anda dapat membuka dan membaca berkas tersebut sendiri—tidak ada kotak hitam.
5. Keterampilan dari katalog. Proyek ini memiliki katalog keterampilan dan plugin siap pakai dengan pemeriksaan keamanan bawaan. Keterampilan orang lain berarti kode orang lain di komputer Anda, itulah sebabnya katalog tersebut memeriksanya.

Ada satu aturan di sini: jangan aktifkan semuanya sekaligus. Mulailah dengan satu percakapan yang stabil, lalu Telegram, kemudian jadwal. Dengan begitu, setiap kegagalan muncul di tahapnya sendiri, bukan berubah menjadi “semuanya rusak dan saya tidak tahu sebabnya”.

Apa yang harus dilakukan jika instalasi bermasalah?#

Mari bahas tiga skenario yang umum.

“openclaw: command not found” tepat setelah instalasi. Hampir selalu ini masalah jalur: folder paket npm global tidak ada di PATH terminal Anda. Berikut perintah diagnostik dari dokumentasi:

node -v
npm prefix -g
echo "$PATH"

Jalur dari perintah kedua seharusnya muncul di hasil perintah ketiga. Jika tidak, tambahkan ke pengaturan shell atau cukup tutup dan buka lagi terminal: kadang jalur Node baru muncul di sesi baru setelah instalasi.

Gateway berjalan, tetapi asisten diam. Gejala dalam FAQ dokumentasi: tidak ada balasan terhadap pesan pertama dan penghitung token bernilai nol. Artinya agen bahkan belum mulai—paling sering karena model belum dikonfigurasi. Periksa dengan urutan berikut:

openclaw gateway restart
openclaw status
openclaw models status

Jika model sudah dikonfigurasi tetapi tetap tidak ada balasan, openclaw logs --follow akan menampilkan log langsung dan menunjukkan bagian yang macet.

Bot Telegram tidak membalas. Periksa dengan urutan berikut: token tersebut milik bot yang sedang Anda kirimi pesan; gateway berjalan (openclaw gateway status); dan pemasangan Anda sudah disetujui (openclaw pairing list telegram). Kode pemasangan berlaku selama satu jam—jika Anda mengirim pesan ke bot kemarin, cukup kirim lagi dan setujui kode baru.

Jika benar-benar buntu, dokumentasi menyarankan sesuatu yang tidak terduga tetapi masuk akal: berikan diagnostik kepada agen AI lokal yang dapat melihat komputer Anda. Claude Code atau Codex, jika diberi keluaran openclaw status --all dan openclaw doctor, dapat memahami konfigurasi lebih cepat daripada obrolan dukungan. Kembali ke awal—AI memperbaiki AI.

Apa lagi yang ditanyakan orang tentang OpenClaw?#

Kenali Ailoot.