Apa Itu OpenClaw dan Kenapa Developer Perlu Tahu
OpenClaw adalah AI assistant open-source yang berjalan di komputer atau server milik sendiri dan menemui penggunanya langsung di aplikasi chat yang sudah dipakai sehari-hari — Discord, Telegram, Slack, Microsoft Teams, WhatsApp, iMessage, dan lebih dari 20 channel lainnya, ditambah aplikasi native untuk macOS, iOS, Android, Windows, dan Linux. Satu komponen bernama Gateway menjalankan semuanya sebagai control plane lokal, baik untuk pemakaian personal di laptop maupun deployment tim bersama; bedanya cuma di sisi konfigurasi.
Yang membuat OpenClaw berbeda dari sekadar chatbot berbasis API: state, memory, dan kredensial tersimpan di perangkat sendiri, bukan di cloud vendor. Model dan agent harness (Claude, Codex CLI, atau model lokal) diperlakukan sebagai plugin yang bisa ditukar tanpa mengubah bagian lain sistem. Proyek ini dikembangkan secara terbuka oleh OpenClaw Foundation, organisasi nonprofit 501(c)(3) independen, tanpa tier berbayar, tanpa layanan hosted resmi, dan tanpa token kripto.
Di ekosistem agent open source, OpenClaw menempati posisi yang cukup unik: salah satu proyek yang menggabungkan akses sistem penuh, puluhan integrasi channel messaging, memory persisten, dan mekanisme heartbeat otonom sekaligus. Ini membuatnya jauh lebih fleksibel dibanding agent coding komersial seperti Devin atau Cursor Agent yang scope-nya dibatasi ke IDE — tapi trade-off-nya adalah permukaan risiko yang lebih besar, sehingga bagian keamanan di bagian akhir artikel ini wajib dibaca sebelum dipakai serius.
Instalasi: Prasyarat, Installer Script, dan Wizard Onboarding
Sebelum instal, pastikan Node.js versi 24.16 ke atas atau 26.1 ke atas sudah terpasang (Node 26 adalah versi yang direkomendasikan). Cek versi lewat node --version.
Cara tercepat untuk mencoba tanpa instalasi permanen:
npx openclaw@latest
Kalau sudah ada login Claude Code atau Codex CLI, atau API key provider model tersimpan, OpenClaw otomatis mendeteksinya, memverifikasi lewat completion sungguhan, menyimpan konfigurasi, lalu membuka dashboard web — cuma satu langkah konfirmasi setelah pointer singkat ke panduan keamanan.
Untuk instalasi permanen, gunakan installer script sesuai sistem operasi:
# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash
# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
Kalau Node.js sudah dikelola manual, instal langsung lewat npm:
npm install -g openclaw@latest --allow-scripts=openclaw
Installer otomatis membuka wizard onboarding begitu instalasi selesai. Wizard ini memverifikasi akses model, membuat workspace, dan mengonfigurasi Gateway. Pilih "Quick start" untuk memakai akses AI yang sudah terdeteksi, atau "Custom setup" kalau ingin melewati semua opsi guided satu per satu. Setelah wizard selesai, jalankan openclaw gateway install supaya Gateway tetap berjalan sebagai service di background (LaunchAgent di macOS, systemd user unit di Linux/WSL2, atau Scheduled Task di Windows). Verifikasi dengan openclaw gateway status — harus terlihat listening di port 18789 — lalu buka Control UI dengan openclaw dashboard untuk mengirim pesan pertama.
Menghubungkan Provider Model dan Channel Chat
Proses onboarding sudah menangani sisi model: OpenClaw bisa memakai kembali sesi login Claude Code atau Codex CLI yang sudah ada, atau API key provider lain. Karena arsitekturnya model-agnostic, provider model bisa diganti kapan saja tanpa mengubah konfigurasi bagian lain.
Untuk sisi channel chat, Telegram adalah cara tercepat untuk mulai ngobrol dari HP karena hanya butuh satu bot token. Discord, Slack, WhatsApp, Microsoft Teams, dan puluhan channel lain dikonfigurasi lewat dokumentasi Channels resmi, masing-masing dengan proses autentikasi sendiri — sebagian cukup pakai bot token sederhana, sebagian lain butuh OAuth atau setup aplikasi di sisi platform.
Satu hal penting soal keamanan channel: pesan masuk harus diperlakukan sebagai untrusted input. Channel yang mendukung DM otomatis melakukan pairing untuk pengirim yang belum dikenal, dan baru bisa berkomunikasi setelah disetujui lewat:
openclaw pairing approve <channel> <code>
Konsep Skill Berbasis SKILL.md dan Cara Menambah Skill Pertama
Skill di OpenClaw adalah file instruksi markdown yang mengajari agent kapan dan bagaimana memakai sebuah tool. Setiap skill hidup dalam folder yang wajib berisi file SKILL.md dengan YAML frontmatter minimal berisi name dan description, ditambah body markdown berisi instruksi penggunaan.
OpenClaw memuat skill dari beberapa sumber sekaligus, dengan urutan prioritas berikut (kalau ada nama skill yang sama, sumber dengan prioritas lebih tinggi yang menang):
| Prioritas | Sumber | Lokasi |
|---|---|---|
| Tertinggi | Workspace skills | <workspace>/skills |
| 2 | Project agent skills | <workspace>/.agents/skills |
| 3 | Personal agent skills | ~/.agents/skills |
| 4 | Managed/local skills | <state-dir>/skills |
| Terendah | Bundled & extra dirs | bawaan install / skills.load.extraDirs |
Cara paling cepat menambahkan skill pertama adalah instal dari ClawHub, direktori skill komunitas resmi:
openclaw skills install @owner/<slug>
Skill juga bisa dipasang langsung dari repo Git (openclaw skills install git:owner/repo@ref) atau dari folder lokal (openclaw skills install ./path/to/skill --as my-tool). Setelah terpasang, skill bisa dipanggil eksplisit dengan mengetik $ di composer Control UI untuk mencari nama skill, atau lewat slash command seperti /nama-skill langsung di channel chat.
Karena skill pihak ketiga pada dasarnya adalah kode yang dijalankan agent, perlakukan setiap skill yang bukan buatan sendiri sebagai untrusted code — baca isinya dulu sebelum diaktifkan, terutama kalau diambil dari luar ClawHub.
Wajib Dibaca Sebelum Dipakai untuk Produksi
Sebelum menghubungkan pengguna lain atau menjalankan OpenClaw di server yang bisa diakses dari luar, empat hal ini wajib dipahami:
Bind ke localhost. Gateway secara default mendengarkan di port 18789. Jangan expose port ini ke internet tanpa autentikasi — kalau perlu akses remote, pakai reverse proxy dengan auth, bukan expose port secara langsung.
Permission mode. Untuk exec/shell command, mulai dari mode ask supaya setiap perintah butuh persetujuan eksplisit sebelum dijalankan. Naikkan ke mode yang lebih longgar hanya setelah yakin dengan skill dan workflow yang dipakai.
Sandboxing. Secara default, tool berjalan langsung di host untuk sesi utama kecuali sandboxing dikonfigurasi secara eksplisit. Untuk task berisiko atau input yang tidak sepenuhnya dipercaya, jalankan lewat container Docker, flag --container, atau VM terpisah.
Kontrol biaya heartbeat. Heartbeat adalah mekanisme yang membuat OpenClaw bertindak otonom tanpa menunggu prompt — secara default berjalan tiap sekitar 30 menit, 24 jam nonstop, dan setiap siklus memakan token. Menurut dokumentasi komunitas ClawDocs, biaya heartbeat bisa jadi kontributor terbesar tagihan API kalau dibiarkan default. Beberapa cara memangkasnya:
| Perubahan | Efek |
|---|---|
| Pakai model murah untuk heartbeat | Hemat 80–90% biaya heartbeat |
| Naikkan interval jadi 60 menit | Hemat ~50% |
| Aktifkan quiet hours | Hemat ~33% |
| Pakai model lokal untuk heartbeat | Hemat 100% biaya API heartbeat |
Aktifkan isolatedSession |
Kurangi context per siklus dari ~100K jadi 2–5K token |
Kombinasi beberapa perubahan di atas bisa memangkas biaya bulanan secara signifikan tanpa mengorbankan fungsi utama heartbeat.
Penutup
Dalam waktu sekitar 15 menit — instal Node.js, jalankan installer, selesaikan wizard onboarding, hubungkan satu channel seperti Telegram — developer atau technical founder sudah punya AI agent self-hosted yang berjalan di infrastruktur sendiri. Langkah selanjutnya yang wajar adalah bereksperimen dengan skill pertama dari ClawHub, lalu meluangkan waktu ekstra untuk membaca panduan security dan sandboxing resmi sebelum agent ini dipercaya menangani pekerjaan produksi.
Butuh infrastruktur yang stabil untuk menjalankan Gateway OpenClaw 24 jam nonstop? katili.dev menyediakan layanan hosting yang bisa jadi tempat deploy yang andal untuk kebutuhan self-hosted seperti ini.
