OpenClaw Tidak Merespons: Cara Mencari Tahu Penyebabnya
Kamu mengirim pesan dan tidak ada yang kembali. Asisten self-hosted punya empat tempat balasan bisa hilang, dan dari jendela chat semuanya tampak sama. Menguji satu per satu butuh sekitar lima menit dan mengubah bot yang diam menjadi kesalahan spesifik yang bisa diperbaiki.
Empat lapisan
Sebelum mengubah apa pun, ketahui apa yang sedang kamu uji. Pesan melewati keempat lapisan ini, dan salah satunya bisa menelan pesan tanpa error yang sampai ke kamu:
- Instance. Apakah OpenClaw benar-benar berjalan di server kamu?
- Penyedia model. Apakah model bahasa menerima permintaanmu?
- Integrasi chat. Apakah pesan sampai ke OpenClaw sama sekali?
- Jalur jaringan. Apakah kamu dan platform bisa menjangkau instance?
Ada satu tes yang langsung membagi masalah menjadi dua: kirim pesan di antarmuka web OpenClaw. Jika kamu mendapat jawaban di sana, lapisan satu dan dua baik-baik saja dan masalahnya ada di integrasi. Jika tidak, berhenti melihat bot sama sekali.
Lapisan 1: apakah instance berjalan?
Buka dashboard Flux dan pastikan instance aktif, bukan restart terus-menerus. Container yang terus mati lalu hidup lagi adalah versi yang paling tidak jelas dari masalah ini, karena layanannya tampak ada di antara restart.
Penyebab umum restart berulang adalah memori. Jika kamu mengarahkan OpenClaw ke model lokal dan bukan API hosted, bobot model harus muat di RAM yang sama dengan semua hal lain. Model 7B yang dikuantisasi ke 4 bit kira-kira 4 GB bobot saja, sebelum konteks percakapan dan sebelum proses asisten. Di paket 4 GB itu tidak akan berhasil, dan paket 8 GB adalah batas bawah yang realistis untuk inferensi lokal. Naik ke paket yang lebih besar atau arahkan asisten ke model hosted, di mana beban berat dikerjakan di perangkat keras penyedia dan instance kamu hanya perlu menyimpan percakapan.
Jika kamu sama sekali tidak bisa mengakses antarmuka web, catat faktanya dan lanjut ke lapisan empat sebelum menganggap instance-nya rusak.
Lapisan 2: apakah penyedia model menolakmu?
OpenClaw tidak terikat model dan kamu membawa kunci sendiri, yang berarti keheningan paling umum sama sekali tidak ada hubungannya dengan OpenClaw. Empat kegagalan dari sisi penyedia menghasilkan asisten yang berhenti menjawab, dan dari jendela chat keempatnya tidak bisa dibedakan:
- Kunci tidak valid atau sudah diganti. Kunci dicabut, dibuat ulang, dan kadang tertempel dengan spasi di akhir. Tempel ulang, jangan hanya membacanya lalu memutuskan bahwa kelihatannya sudah benar.
- Saldo kredit habis. Akun bayar sesuai pemakaian berhenti melayani permintaan begitu saldonya habis, tanpa peringatan di dalam asistenmu.
- Kamu terkena rate limit. Akun baru di setiap penyedia besar berada di tier permintaan per menit yang rendah. Rentetan pesan, atau loop agen yang memanggil model berulang kali, akan menabrak batas itu dan setiap permintaan yang ditolak tidak mengembalikan apa pun yang berguna ke chat.
- Nama model sudah tidak ada. Penyedia menghentikan pengenal model, dan konfigurasi yang ditulis berbulan-bulan lalu bisa mengarah ke sesuatu yang sudah dicabut. Permintaan gagal sebagai model yang salah, bukan kunci yang salah, dan itu mudah disalahartikan.
Periksa dashboard penyedia: halaman pemakaian, penagihan, dan rate limit memberi tahu dalam hitungan detik yang mana dari empat masalah itu, dan semuanya diperbaiki di sana, bukan di OpenClaw.
Lapisan 3: integrasi chat
Jika antarmuka web menjawab tetapi bot tidak, pesannya tidak pernah sampai. Setiap platform punya satu penyebab dominan dan layak diketahui namanya.
Telegram: Privacy Mode
Bot yang dibuat lewat BotFather memiliki Privacy Mode aktif secara default. Di grup, bot dalam kondisi itu hanya menerima pesan yang diawali perintah slash, atau yang membalas atau menyebut bot secara langsung. Pesan lainnya tidak pernah dikirim ke server kamu, jadi asistenmu tidak sedang mengabaikan orang, dia memang tidak pernah mendengarnya. Itu sebabnya bot yang sama menjawab pesan langsung dengan sempurna tetapi tampak mati di grup.
Untuk memperbaikinya, kirim pesan ke BotFather, buka Bot Settings untuk bot kamu, lalu matikan Group Privacy. Setelah itu keluarkan bot dari grup dan tambahkan lagi, karena pengaturan ini diterapkan saat bot bergabung.
Discord: Message Content Intent
Sejak 2022 Discord memperlakukan teks pesan sebagai data istimewa. Bot tanpa Message Content Intent yang aktif tetap terhubung, tetap tampil online, dan menerima event pesan dengan field isi kosong. Hasilnya adalah bot yang jelas-jelas berjalan dan tidak bereaksi terhadap apa pun.
Aktifkan di Discord Developer Portal di bawah aplikasimu, Bot, Privileged Gateway Intents, lalu restart integrasinya. Sekalian, periksa bahwa bot punya izin untuk membaca dan mengirim pesan di channel tertentu: override di level channel diam-diam mengalahkan role di level server, dan bot dengan izin server tetap bisu di satu ruangan.
WhatsApp: sesi
Koneksi WhatsApp terikat pada sesi yang tertaut, bukan token permanen, dan sesi bisa kedaluwarsa, keluar dari ponsel, atau rusak saat perangkat offline dalam waktu lama. Integrasi WhatsApp yang diam paling sering disebabkan sesi yang perlu ditautkan ulang. Pindai ulang kodenya dan uji lagi sebelum mencari di tempat lain.
Semua platform: tokennya sendiri
Untuk platform apa pun, pastikan token di dashboard adalah yang terbaru. Membuat ulang token bot di konsol platform langsung membatalkan yang lama, dan sangat mudah membuat ulang token saat sedang menyelidiki hal lain lalu lupa menempelkan yang baru.
Lapisan 4: jalur jaringan
Jika kamu mengakses OpenClaw lewat Tailscale, asisten bisa dalam kondisi sehat sementara kamu tidak bisa menjangkaunya. Kunci auth kedaluwarsa, dan kunci perangkat juga, jadi instance yang berjalan tanpa disentuh selama berbulan-bulan bisa hilang dari tailnet tanpa ada yang gagal. Periksa konsol admin Tailscale dan pastikan perangkat masih terdaftar dan masih diotorisasi. Jika tidak, buat kunci auth baru lalu deploy ulang atau hubungkan ulang.
Lapisan ini menjelaskan pola yang membingungkan: bot tetap menjawab di chat sementara antarmuka web tidak bisa kamu jangkau. Instance-nya baik-baik saja dan berjalan; yang hilang hanya jalur kamu menuju instance itu.
Menjawab, tapi buruk
Jawaban yang lambat atau terpotong berbeda dari diam, dan biasanya disebabkan salah satu dari dua hal. Percakapan panjang pada akhirnya melampaui jendela konteks model, dan saat itu permintaan mulai gagal atau asisten kehilangan bagian awal dari utas percakapan. Memulai percakapan baru adalah perbaikan cepatnya. Di sisi lain, model lokal yang besar di perangkat keras sederhana memang lambat, dan jawaban yang memakan waktu satu menit bisa habis waktu di suatu titik dalam rantai sebelum sampai ke kamu. Jika kamu butuh kecepatan di instance kecil, model hosted akan selalu mengungguli model lokal.
Daftar periksa lima menit
- Kirim pesan di antarmuka web OpenClaw. Jika ada jawaban di sana, masalahnya ada di integrasi; jika tidak ada, masalahnya ada di instance, penyedia, atau jalur kamu menuju instance.
- Periksa instance di dashboard Flux untuk restart berulang, dan periksa RAM jika kamu menjalankan model lokal.
- Periksa dashboard penyedia model untuk kunci tidak valid, saldo kosong, rate limit, atau nama model yang sudah dihentikan.
- Untuk Telegram, matikan Privacy Mode di BotFather dan tambahkan lagi bot ke grup.
- Untuk Discord, aktifkan Message Content Intent dan pastikan izin di level channel.
- Untuk WhatsApp, tautkan ulang sesinya.
- Jika antarmuka web tidak bisa dijangkau tetapi chat tetap berfungsi, periksa Tailscale untuk perangkat atau kunci auth yang kedaluwarsa.
Hampir semua kasus berakhir di langkah satu, tiga, atau empat. Pola yang perlu dipahami adalah asisten self-hosted punya lebih banyak bagian yang bergerak dibanding asisten SaaS justru karena kamu yang memilikinya, dan memilikinya berarti kesalahannya selalu bisa dilacak.
Bacaan terkait
Baru mengelola salah satunya? Mulai dari panduan self-host OpenClaw, atau baca tentang memilih model AI jika kamu sedang menimbang penyedia hosted dibanding model lokal. Untuk integrasinya sendiri, lihat Telegram, Discord, dan WhatsApp.