OpenClaw（龙蝦） adalah proyek open source agen AI dengan kecepatan pertumbuhan di GitHub tercepat saat ini, memungkinkan Anda memasang asisten AI pribadi yang selalu online di komputer Anda sendiri, dan berinteraksi dengannya melalui aplikasi perpesanan yang biasa Anda gunakan seperti Telegram, WhatsApp, Discord, dan lainnya.
Tutorial ini membawa Anda dari nol untuk menyelesaikan instalasi, pengaturan, hingga mengirim pesan pertama, total sekitar 10 menit.
Apa itu OpenClaw? Apa bedanya dengan ChatGPT?
ChatGPT adalah alat tanya-jawab: Anda mengajukan satu pertanyaan, ia memberi Anda satu jawaban, lalu setelah percakapan selesai semuanya berakhir. OpenClaw adalah agent AI: Anda memberikan sebuah tugas, ia akan berpikir sendiri, memanggil alat, menjalankan tindakan—memeriksa Gmail Anda, melihat kalender Anda, mencari di internet, menulis program—lalu memberi tahu Anda hasilnya.
Perbedaan yang lebih penting adalah: OpenClaw berjalan di komputer Anda sendiri, data sepenuhnya berada dalam kendali Anda, dan tidak akan diunggah ke server pihak ketiga mana pun. Ia sendiri tidak menyertakan model AI, sehingga Anda perlu menyediakan sendiri API Key (Anthropic Claude, OpenAI GPT, Google Gemini, dan lainnya bisa). Biaya model dibayar langsung oleh Anda kepada penyedia.
Persiapan sebelum instalasi
Kebutuhan sistem
macOS, Linux, atau Windows (disarankan menggunakan WSL2, stabilitas lebih tinggi)
Node.js versi 22.14 atau lebih tinggi (disarankan Node 24)
Minimal satu set API Key dari model AI
Instal Node.js
Pertama konfirmasi apakah sudah terpasang dan apakah versinya cukup:
node -v
Jika versinya lebih rendah dari v22.14 atau belum terpasang, pilih metode instalasi sesuai sistem:
Mendapatkan AI model API Key
OpenClaw mendukung berbagai penyedia model, berikut adalah tiga pilihan yang paling umum:
Anthropic Claude: buka console.anthropic.com untuk membuat akun, lalu tambahkan kunci di halaman API Keys. Claude Sonnet 4.x adalah pilihan paling populer saat ini.
OpenAI GPT: buka platform.openai.com untuk membuat API Key.
Google Gemini: buka aistudio.google.com untuk mendapatkan API Key secara gratis.
Salin API Key tersebut untuk disiapkan, nanti saat instalasi Anda perlu menempelkannya.
Langkah pertama: Instal OpenClaw
macOS dan Linux hanya perlu satu perintah:
curl -fsSL | bash
Untuk pengguna Windows, jalankan di PowerShell:
iwr -useb | iex
Setelah instalasi selesai, konfirmasi bahwa perintah bisa digunakan:
openclaw --version
Langkah kedua: Jalankan panduan Onboarding
Jalankan perintah berikut untuk memulai wizard pengaturan interaktif, sekaligus membuat OpenClaw berjalan sebagai layanan latar (background) saat sistem menyala:
openclaw onboard --install-daemon
Wizard akan menanyakan beberapa pertanyaan secara berurutan:
Pilih penyedia model: pilih penyedia tempat Anda baru saja mendapatkan API Key (Anthropic, OpenAI, Google, dll.)
Tempel API Key: tempelkan kunci yang barusan Anda salin
Pilih model: disarankan memilih model andalan terbaru (misalnya claude-sonnet-4-5)
Pilih mode instalasi: pemula cukup memilih QuickStart, akan menggunakan nilai default untuk menyelesaikan semua pengaturan
Seluruh proses sekitar 2 menit, sebagian besar opsi bisa langsung ditekan Enter untuk menerima nilai default.
Langkah ketiga: Konfirmasi Gateway sedang berjalan
openclaw gateway status
Jika Anda melihat Gateway mendengarkan di port 18789, berarti instalasi berhasil.
Buka antarmuka kontrol melalui browser untuk mencoba:
openclaw dashboard
Browser akan membuka Control UI, di sini Anda bisa mengirim pesan langsung ke asisten AI untuk memastikan semuanya berjalan normal.
Langkah keempat: Mengintegrasikan Telegram (cara tercepat untuk memulai)
Telegram adalah jalur perpesanan resmi OpenClaw yang paling lengkap, pengaturannya juga paling mudah, Anda hanya perlu satu Bot Token.
4-1 Ajukan Bot Token di BotFather
Buka Telegram, cari dan buka @BotFather (pastikan ada centang biru resmi di sampingnya)
Kirim /newbot
Ikuti petunjuk untuk memasukkan nama Bot (nama tampilan) dan akun Bot (harus diakhiri dengan bot, misalnya my_ai_assistant_bot)
BotFather akan memberi Anda sebuah Token, formatnya mirip 123456789:AAGxxxxxxxxxxxxxxxxx, salinlah itu
4-2 Pengaturan Token
Edit file konfigurasi OpenClaw (jalur default
~/.openclaw/config.json5
), lalu tambahkan pengaturan Telegram:
{ channels: { telegram: { enabled: true, botToken: “tempel Token Anda di sini”, dmPolicy: “pairing”, }, }, }
4-3 Restart Gateway dan lakukan pairing
openclaw gateway restart openclaw pairing list telegram
Setelah itu, di Telegram temukan Bot yang baru Anda buat, kirim pesan apa pun padanya, Anda akan menerima kode pairing. Jalankan:
openclaw pairing approve telegram
Selesai, kirim pesan ke Bot Anda di Telegram, maka Bot akan menerima balasan dari asisten AI.
FAQ Masalah yang sering terjadi
Bagaimana jika terjadi error versi Node?
Jalankan
node -v
untuk memastikan versinya. Jika lebih rendah dari v22.14, instal ulang Node.js sesuai tabel di atas. Pengguna macOS yang sudah menginstal Homebrew bisa menjalankan brew upgrade node untuk upgrade.
Gateway tidak bisa dijalankan?
Jalankan
openclaw gateway status
untuk melihat pesan error. Penyebab paling umum adalah port 18789 sedang dipakai, atau format API Key salah. Anda bisa menjalankan openclaw configure untuk mengatur ulang.
Bagaimana cara mengganti API Key?
Jalankan
openclaw configure
, lalu pilih langkah Model/Auth untuk pengaturan ulang.
Apakah Token akan terus terbakar?
Dalam kondisi default, OpenClaw hanya memanggil API saat menerima pesan, jadi Token tidak akan dikonsumsi tanpa alasan. Tapi jika Anda mengaktifkan beberapa Skill otomatis atau tugas terjadwal, disarankan menetapkan batas pemakaian bulanan di panel backend penyedia model untuk mencegah pengeluaran yang tidak terduga.
Apa yang bisa dilakukan selanjutnya
Integrasikan Gmail dan Google Calendar, supaya asisten membantu mengelola email dan jadwal
Instal Skills untuk memperluas kemampuan asisten (pencarian web, eksekusi program, manajemen memori, dll.)
Deploy cloud: lewat Cloudflare Tunnel agar龙蝦 online 24 jam (tutorial lanjutan, akan segera dirilis)
Artikel ini tentang OpenClaw（龙蝦 AI）tutorial instalasi lengkap 2026: dari nol menyiapkan asisten AI pribadi, mengintegrasikan Telegram pertama kali muncul di 链新闻 ABMedia.
