OpenClaw—agen open-source yang disebut fans dengan nama "Lobster"—sedang mendapatkan perhatian. Dan ini bukan sekadar chatbot: setelah Anda memberikan izin yang terbatas, ia dapat bekerja di latar belakang 24/7—mengelola kotak masuk Anda, mengirim email, mengatur kalender, dan lainnya. AIPURE (hub AI tools) menyusun panduan "Besarkan Lobster Anda Sendiri" ini untuk membantu Anda menjalankannya dengan aman—sehingga Anda dapat menyelenggarakannya dengan percaya diri.
Jika Anda menginginkan asisten AI open-source yang berjalan di mesin atau server Anda sendiri—dan dapat melakukan tindakan dengan batasan—panduan penyebaran OpenClaw ini cocok untuk Anda. Kami akan membimbing pengguna power dan pembangun no-code melalui dua jalur cepat (lokal dan cloud), pengaturan default yang aman, verifikasi praktis, dan beberapa otomatisasi non-destruktif untuk dicoba pertama kali. Ide utama sepanjang panduan ini: fleksibilitas penyebaran. Anda dapat memulai secara lokal, kemudian pindah ke host cloud seperti DigitalOcean atau PaaS yang dikelola dengan sedikit rework.
Untuk dokumentasi resmi, simpan sumber daya resmi ini: Repositori GitHub OpenClaw dan Dokumentasi Instalasi OpenClaw. Saat menyebarkan ke VM cloud sederhana, Tutorial DigitalOcean tentang menjalankan OpenClaw juga sangat berguna. Untuk konteks keamanan aplikasi agen, lihat OWASP’s Agentic Top 10 (2026).
Yang Anda Butuhkan (Baca Ini Terlebih Dahulu)
Sebelum Anda memulai, siapkan beberapa dasar agar jalannya lancar:
- Sebuah komputer atau VPS dengan setidaknya 2 vCPU dan 4 GB RAM; Linux paling umum, tetapi macOS juga cocok untuk tes lokal. Untuk cloud, VM kecil dengan penyimpanan SSD adalah pilihan yang ideal. Ukuran dari panduan komunitas DigitalOcean adalah titik awal yang baik.
- Terminal dan akses SSH (untuk cloud). Anda harus merasa nyaman menyalin perintah dan membaca log dasar.
- Docker dan Docker Compose untuk jalur yang dikontainerisasi, atau Node.js (LTS atau lebih baru) jika Anda lebih memilih jalur instalasi/bangunan lokal.
- Kunci API untuk penyedia model pilihan Anda (kompatibel OpenAI atau model lokal melalui API), disimpan dengan aman. Mulailah dengan cakupan baca-saja kapan saja memungkinkan.
- Akun pengguna atau namespace khusus untuk direktori state dan workspace OpenClaw sehingga Anda dapat mencadangkannya dan memulihkannya secara independen.
Cepat Mulai A: Instalasi Lokal dalam 10–15 Menit
Jalur ini mendapatkan instance OpenClaw yang berfungsi di laptop atau kotak pengembangan Anda. Ini sempurna untuk mencoba dengan pengaturan aman.
1. Siapkan lingkungan Anda
- Pastikan Docker dan Docker Compose terinstal; atau instal Node.js terbaru jika Anda lebih suka menjalankannya dari sumber. Jika Anda memerlukan langkah-langkah yang tepat atau alternatif, panduan instalasi resmi mencakup metode yang didukung.
- Buat dua direktori untuk data persisten:
mkdir -p ~/.openclaw/statemkdir -p ~/.openclaw/workspace2. Jalankan dengan Docker Compose (direkomendasikan untuk isolasi)
Buat file docker-compose.yml minimal di folder kosong. Konfirmasi tag gambar yang benar di dokumentasi resmi/releases sebelum menyebar:
services: openclaw: image: openclaw/openclaw:latest restart: unless-stopped environment: - NODE_ENV=production - OPENCLAW_STATE_DIR=/home/node/.openclaw - OPENCLAW_WORKSPACE_DIR=/home/node/.openclaw/workspace - OPENCLAW_GATEWAY_BIND=127.0.0.1 - OPENCLAW_GATEWAY_PORT=18789 - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN} - SETUP_PASSWORD=${SETUP_PASSWORD} user: "1000:1000" # jalankan sebagai pengguna non-root jika memungkinkan volumes: - ~/.openclaw/state:/home/node/.openclaw - ~/.openclaw/workspace:/home/node/.openclaw/workspace ports: - "127.0.0.1:8080:8080" # UI/dashboard - "127.0.0.1:18789:18789" # gateway APIBuat file .env di sampingnya dan atur kredensial yang kuat:
OPENCLAW_GATEWAY_TOKEN="ubah-ke-string-acak-panjang"SETUP_PASSWORD="ubah-ke-password-yang-kuat"Jalankan:
docker compose up -d3. Onboarding dan Verifikasi
- Buka dasbor di http://127.0.0.1:8080 dan lengkapi wizard setup dengan SETUP_PASSWORD Anda. Alur quickstart dan wizard dijelaskan dalam Getting Started.
- Tambahkan satu saluran berisiko rendah (misalnya, Slack atau Discord) dan nonaktifkan penulisan file dan perintah shell untuk saat ini.
- Lakukan pemeriksaan asap cepat dari log kontainer:
docker compose logs --tail=100 openclawAnda harus melihat konfirmasi bahwa runtime sedang berjalan, gateway terikat ke 127.0.0.1:18789, dan UI mendengarkan di 8080.
4. Alternatif: Dari Sumber (Node.js)
Jika Anda lebih suka bekerja dari sumber untuk pengembangan lokal:
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm devIni membawa server pengembangan lokal. Gunakan wizard CLI jika tersedia untuk menginisialisasi state dan mengatur kredensial, lalu lanjutkan ke dasbor untuk menyelesaikan onboarding.
Mengapa memulai secara lokal? Anda menyimpan semuanya di mesin Anda, latensi rendah, dan Anda dapat mengonfirmasi dasar-dasar sebelum pindah ke penyebaran cloud multi-pengguna. Ini adalah cara termudah untuk mempelajari dasar-dasar agen otomatisasi AI open-source ini tanpa mengancam data produksi.
Cepat Mulai B: Cloud dalam 10–20 Menit di DigitalOcean
Saat Anda siap untuk berbagi akses dengan rekan tim atau menjaga asisten online 24/7, VM cloud berbiaya rendah sangat berguna. Jalur umum adalah gambar 1-Klik dari marketplace atau Droplet kecil di mana Anda menjalankan Docker Compose. Untuk panduan langkah demi langkah DO, merujuk ke panduan komunitas DigitalOcean untuk OpenClaw.
1. Buat Droplet
- Pilih ukuran dengan 2 vCPU dan 4 GB RAM (atau lebih besar jika beberapa saluran/pengguna akan terhubung).
- Tambahkan kunci SSH Anda dan batasi port masuk ke 22 (SSH), 80/443 (jika Anda akan menempatkan dasbor di balik reverse proxy), dan port UI pilihan Anda (8080) jika menguji akses langsung sementara.
2. SSH dan Siapkan Docker
ssh root@your-server-ipapt update && apt install -y docker.io docker-compose git && systemctl enable dockeradduser openclaw && usermod -aG docker openclawsu - openclaw3. Siapkan State dan Compose
mkdir -p ~/.openclaw/state ~/.openclaw/workspacemkdir ~/svc && cd ~/svcBuat docker-compose.yml (mirip dengan yang lokal) tetapi ikat dasbor di belakang localhost terlebih dahulu, kemudian nanti letakkan Nginx atau Caddy di depan untuk TLS:
services: openclaw: image: openclaw/openclaw:latest restart: unless-stopped environment: - NODE_ENV=production - OPENCLAW_STATE_DIR=/home/openclaw/.openclaw - OPENCLAW_WORKSPACE_DIR=/home/openclaw/.openclaw/workspace - OPENCLAW_GATEWAY_BIND=127.0.0.1 - OPENCLAW_GATEWAY_PORT=18789 - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN} - SETUP_PASSWORD=${SETUP_PASSWORD} user: "1000:1000" volumes: - /home/openclaw/.openclaw:/home/openclaw/.openclaw - /home/openclaw/.openclaw/workspace:/home/openclaw/.openclaw/workspace ports: - "127.0.0.1:8080:8080" - "127.0.0.1:18789:18789"Buat .env dan jalankan:
cat > .env << 'EOF'OPENCLAW_GATEWAY_TOKEN=$(openssl rand -hex 32)SETUP_PASSWORD=$(openssl rand -base64 24)EOFdocker compose up -d4. Tambahkan Reverse Proxy (opsional tetapi direkomendasikan)
Ekspor hanya HTTPS ke internet dan tetapkan gateway di localhost:
sudo apt install -y nginx certbot python3-certbot-nginxsudo nano /etc/nginx/sites-available/openclawTambahkan blok server proxy sederhana (ganti domain):
server { server_name assistant.example.com; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } listen 80;}Lalu aktifkan dan amankan:
sudo ln -s /etc/nginx/sites-available/openclaw /etc/nginx/sites-enabled/sudo nginx -t && sudo systemctl reload nginxsudo certbot --nginx -d assistant.example.com --redirect5. Verifikasi Kesehatan
- Buka https://assistant.example.com dan lengkapi onboarding.
- Periksa kontainer dan log:
docker compose psdocker compose logs --tail=100Jika Anda melihat runtime berjalan dan tidak ada konflik port, Anda siap untuk melanjutkan.
Mengapa DigitalOcean? Ini menyeimbangkan biaya, kontrol, dan kesederhanaan. Anda tetap memiliki akses root, tetapi Anda juga mendapatkan VM yang bersih dan dapat diprediksi di mana OpenClaw dapat berjalan secara berkelanjutan. Jika Anda lebih memilih blueprint PaaS, dokumentasi OpenClaw mencakup contoh penyebaran Render dengan disk persisten dan variabel lingkungan yang diperlukan.
Panduan Penyebaran OpenClaw: Pilihan Mana yang Harus Anda Pilih?
- Lokal terlebih dahulu jika Anda sedang belajar atau peduli tentang privasi dan latensi ultra-rendah.
- VM cloud kecil jika Anda menginginkan akses selalu-aktif untuk diri Anda sendiri dan rekan tim.
- PaaS yang dikelola jika Anda menghargai restart otomatis, pemeriksaan kesehatan, dan manajemen disk yang mudah. Blueprint gaya Render biasanya mencakup mount disk persisten dan beberapa variabel lingkungan yang diperlukan. Jika Anda memilih jalur ini, pastikan gateway tetap di bind internal dan bahwa Anda menyediakan kata sandi setup dan token saat penyebaran.
Langkah demi Langkah: Pola Docker/VPS yang Akan Anda Gunakan di Mana Saja
Gunakan urutan ini setiap kali Anda menginstal OpenClaw di penyedia VPS mana pun:
- Buat pengguna non-root dan instal Docker + Compose.
- Buat direktori state/workspace persisten di home pengguna tersebut.
- Ikat dasbor dan gateway ke localhost pada awalnya.
- Hasilkan kata sandi setup yang kuat dan token gateway, dan simpan di file .env dengan izin yang dibatasi.
- Jalankan layanan dan lengkapi onboarding.
- Hanya setelah pengujian, tambahkan reverse proxy dan buka port ke internet publik.
Skrip kualitas hidup kecil yang membungkus langkah-langkah 2–5 dapat membuat penyebaran yang dapat diulang menjadi sangat sederhana. Simpan di repositori pribad Anda dengan domain, port, dan jalur volume yang diparameterkan.
Pengaturan Aman Secara Default yang Harus Anda Pertahankan
- Hak terkecil: Mulai agen dengan akses baca-saja ke satu direktori tes. Jangan biarkan menulis atau menjalankan perintah shell sampai Anda memvalidasi perilakunya.
- Kredensial: Gunakan kata sandi SETUP_PASSWORD dan OPENCLAW_GATEWAY_TOKEN yang panjang dan acak. Putar mereka jika mungkin telah bocor atau ketika rekan tim meninggalkan tim.
- Ikat localhost: Tetapkan gateway ke 127.0.0.1. Jika alat jarak jauh memerlukan akses, letakkan di depan dengan reverse proxy atau solusi jaringan pribadi daripada mengekspos port mentah.
- Lingkungan terpisah: Pertahankan instance dev untuk eksperimen dan satu terpisah untuk dokumen atau alur kerja penting.
- Pencatatan dan tinjauan: Lacak log selama penggunaan awal, dan tinjau tindakan apa yang dicoba agen sebelum membuka keterampilan yang lebih kuat.
Untuk konteks keamanan yang lebih mendalam dan netral vendor saat Anda mengembangkan, konsultasikan OWASP’s Agentic Top 10 (2026) dan panduan solusi terkait.
Pemecahan Masalah dan Pemulihan (Perbaikan Cepat)
- Port sudah digunakan: Jika 8080 atau 18789 sibuk, ubah pemetaan port sisi host di docker-compose.yml dan restart.
- Kredensial salah atau hilang: Jika Anda tidak dapat otentikasi ke dasbor, reset SETUP_PASSWORD di .env Anda, lalu restart kontainer. Untuk gateway, putar OPENCLAW_GATEWAY_TOKEN dan redeploy.
- Kontainer berfluktuasi atau crash: Periksa log terbaru dan cek izin volume untuk direktori state/workspace yang dipetakan. Pastikan layanan tidak berjalan sebagai root jika gambar mengharapkan pengguna non-root.
- Gateway tidak dapat diakses: Konfirmasi bahwa gateway masih terikat ke 127.0.0.1 dan bahwa reverse proxy Anda menunjuk ke upstream yang benar. Hindari mengekspos gateway secara langsung.
- Tidak ada yang terjadi ketika Anda memintanya untuk melakukan sesuatu: Konfirmasi saluran yang relevan terhubung dan token integrasi yang diperlukan ada. Coba tugas baca-saja sederhana terlebih dahulu (misalnya, “ringkas file teks ini di workspace”).
Perintah yang sering Anda gunakan:
# Statusdocker compose ps# Logs (mengikuti)docker compose logs -f --tail=200# Restart setelah konfigurasi berubahdocker compose up -d --force-recreate# Periksa pemetaan portdocker ps --format ' -> 'Jika Anda pernah mencurigai kerusakan state atau peningkatan yang buruk, hentikan layanan, cadangkan direktori state/workspace, dan coba mulai ulang dengan gambar tag yang baru. Anda dapat mengimpor kembali secara selektif dari cadangan setelah layanan kembali sehat.
Tiga Otomatisasi Aman untuk Dicoba Pertama
1. Ringkasan Pagi untuk Diri Sendiri
Hubungkan saluran chat yang sudah Anda gunakan. Tunjukkan OpenClaw ke file kalender tes di workspace dan minta untuk mengirim ringkasan pagi singkat kepada Anda pada hari kerja. Pertahankan akses baca-saja terlebih dahulu agar tidak dapat mengubah acara—hal ini membangun kepercayaan pada penilaian dan format asisten.
2. Penyummary Pull Request GitHub
Aktifkan integrasi GitHub dan batasi ke repositori sandbox. Minta OpenClaw untuk membaca pull request terbaru dan memposting ringkasan singkat sebagai komentar. Ini menggunakan otomatisasi nyata (membaca data jarak jauh dan memposting kembali) tanpa menyentuh sistem file lokal atau menjalankan perintah shell.
3. Pemeriksaan Kehadiran File dan Pengingat
Suruh OpenClaw memeriksa apakah file tertentu ada di workspace pada pukul 18:00, kemudian kirim pengingat kepada Anda di chat jika file tersebut hilang. Ini adalah tes praktis minimal dari penjadwalan dan notifikasi yang tidak memerlukan akses tulis atau shell.
Contoh-contoh ini melatih saluran, memori, dan alat dasar sambil tetap tidak merusak. Seiring iterasi, Anda dapat memperluas ke penulisan file yang aman, kemudian dengan hati-hati mengaktifkan perintah shell untuk tugas yang sempit dan teruji dengan baik.
Tips untuk Pembaruan, Cadangan, dan Migrasi
- Pemakaian versi: Di Docker, gunakan gambar dengan tag alih-alih latest untuk stabilitas, kemudian lakukan pembaruan secara sengaja.
- Cadangan sebelum pembaruan: Hentikan kontainer dan arsipkan direktori state/workspace dengan timestamp. Simpan setidaknya dua snapshot.
- Pengembalian: Jika pembaruan berperilaku buruk, hentikan kontainer, kembalikan ke tag gambar sebelumnya, dan pulihkan snapshot state/workspace sebelumnya.
- Migrasi: Untuk memindahkan host, salin snapshot ke mesin baru, buat ulang struktur direktori dan ID pengguna yang sama, kemudian mulai layanan dengan variabel lingkungan yang sama.
Cadangan hanya memakan beberapa menit dan dapat menghemat jam debugging. Berikut caranya: atur cron mingguan cepat yang mengompresi state dan workspace Anda ke dalam tarball bertanggal dan memutar arsip lama.
Ketentuan Keamanan yang Tidak Boleh Anda Abaikan
OpenClaw kuat karena berfungsi sebagai gerbang ke sistem dan aplikasi Anda. Itulah mengapa Anda harus berhati-hati dengan izin dan cakupan. Pertimbangkan:
- Injeksi prompt dan penyalahgunaan alat: Bersikap skeptis terhadap konten dari sumber yang tidak terpercaya. Nonaktifkan alat berisiko dalam alur kerja yang memproses input yang tidak dikenal.
- Kebersihan kunci: Jangan hard-code kunci API di file Compose. Gunakan variabel lingkungan dan batasi akses ke .env. Putar kunci secara teratur.
- Eksploitasi jaringan: Gunakan jaringan pribadi atau reverse proxy dengan TLS dan otentikasi. Jangan mengekspos gateway mentah ke internet publik.
- Auditabilitas: Simpan log cukup lama untuk merekonstruksi apa yang terjadi jika ada masalah. Tinjau tindakan agen sebelum memberikan lebih banyak kekuasaan.
Ini bukan risiko teoretis—ini adalah kategori masalah yang sama yang dapat dihadapi oleh layanan otomatisasi mana pun. Hak terkecil, pemisahan tugas, dan audit rutin sangat membantu.
Alternatif dan Kapan Harus Mempertimbangkannya
Bergantung pada tujuan Anda, Anda mungkin juga mengeksplorasi proyek agen open-source lain yang menekankan trade-off yang berbeda, seperti agen kode yang berpusat pada IDE atau asisten yang berat pada penelitian. Jika kebutuhan utama Anda adalah kolaborasi kode di dalam IDE browser, Anda mungkin lebih memilih agen yang disesuaikan untuk domain tersebut. Jika Anda membutuhkan otomatisasi browser tanpa kepala secara besar-besaran, kerangka kerja yang fokus pada aspek tersebut mungkin lebih cocok. Tujuannya bukan untuk memilih “pemenang,” tetapi untuk memilih alat yang sesuai dengan alur kerja dan toleransi risiko Anda.
Ke Mana Ini Akan Berlanjut (Dan Langkah Berikutnya Anda)
Desain OpenClaw—model-agnostik, kaya saluran, dan didorong oleh gateway—membuatnya mudah untuk mengadopsi model yang lebih baru seiring waktu tanpa mengubah dasar penyebaran Anda. Mulailah secara lokal dengan pengaturan aman, pelajari bagaimana perilaku agen, kemudian promosikan ke VM cloud kecil dengan HTTPS dan kredensial yang ketat. Dari sana, perluas integrasi dan cakupan izin hanya seiring pertumbuhan kepercayaan Anda.
Jika Anda ingin tetap mengikuti tips penyebaran praktis dan tutorial terkait, AIPURE secara rutin mencakup panduan praktis dan ringkasan alat AI dan pola baru. Gunakan sebagai cara netral untuk tetap up-to-date, kemudian kembali dan sempurnakan setup Anda.
FAQ
Bagaimana ini berbeda dari chatbot biasa?
OpenClaw bukan hanya Q&A. Itu terhubung ke file, layanan, dan saluran Anda dan dapat melakukan tindakan nyata melalui gateway yang disandbox dengan batasan.
Apakah saya bisa menggunakan model lokal untuk meningkatkan privasi atau mengurangi biaya?
Ya. OpenClaw adalah model-agnostik. Anda bisa menghubungkan API-based LLM atau menunjuknya ke model lokal yang disajikan melalui API. Mulai kecil, ukur latensi dan kualitas, dan sesuaikan dari sana.
Setup "produksi" paling sederhana apa?
VM cloud kecil dengan Docker Compose, gateway terikat ke localhost, dasbor di belakang reverse proxy HTTPS, dan cadangan mingguan direktori state/workspace. Tetapkan izin shell dan tulis sampai Anda membutuhkannya.
Bagaimana cara menghapus semuanya dengan bersih?
Hentikan dan hapus kontainer Anda, hapus direktori layanan dengan file Compose, dan arsip atau hapus direktori state/workspace di home pengguna yang ditentukan. Jika Anda menambahkan reverse proxy, hapus blok server tersebut dan cabut sertifikat TLS.
Siap menjalankan agen AI lokal Anda sendiri dengan memori dan batasan yang aman? Mulailah dengan quickstart lokal dalam panduan penyebaran OpenClaw ini, verifikasi dasar-dasarnya, kemudian naik ke VM cloud kecil ketika Anda merasa nyaman. Anda akan memiliki agen otomatisasi AI open-source yang benar-benar menyelesaikan pekerjaan—sesuai dengan syarat Anda.
