Intinya
Pemecahan masalah OpenClaw mencakup masalah pemutusan koneksi, kegagalan autentikasi, kesalahan perutean, dan masalah kinerja. Sebagian besar masalah berasal dari ketidakstabilan jaringan, kunci API yang salah, atau saluran yang salah konfigurasi. Panduan ini menyediakan perbaikan langkah demi langkah untuk 15 kesalahan OpenClaw paling umum.
Masalah Instalasi dan Penyiapan
Ketidakcocokan versi Node.js
Masalah: Perintah openclaw tidak ditemukan atau gagal dengan "versi Node tidak didukung."
Penyebab: OpenClaw memerlukan Node.js 22 atau yang lebih baru. Versi lama tidak memiliki fitur yang diperlukan.
Perbaikan:
Periksa versi Node Anda:
node --version
Jika di bawah 22, perbarui Node:
# Menggunakan nvm (disarankan)
nvm install 22
nvm use 22
# Atau unduh dari nodejs.org
Instal ulang OpenClaw:
npm install -g openclaw@latest
Verifikasi instalasi:
openclaw --version
Izin ditolak selama instalasi
Masalah: npm install -g openclaw gagal dengan EACCES atau kesalahan izin.
Penyebab: npm mencoba menulis ke direktori sistem tanpa izin yang sesuai.
Perbaikan:
Jangan gunakan sudo. Sebagai gantinya, konfigurasikan npm untuk menggunakan direktori pengguna:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
Tambahkan ke profil shell Anda (~/.zshrc atau ~/.bashrc):
export PATH=~/.npm-global/bin:$PATH
Muat ulang shell Anda:
source ~/.zshrc
Instal OpenClaw:
npm install -g openclaw@latest
File konfigurasi tidak ditemukan
Masalah: OpenClaw tidak dapat menemukan ~/.openclaw/config.json setelah instalasi.
Penyebab: Wizard orientasi tidak berjalan atau gagal secara diam-diam.
Perbaikan:
Jalankan orientasi secara manual:
openclaw onboard
Jika gagal, buat direktori konfigurasi:
mkdir -p ~/.openclaw
Buat file konfigurasi minimal:
cat > ~/.openclaw/config.json << 'EOF'
{
"version": "1.0.0",
"providers": {},
"agents": {},
"channels": {},
"routing": []
}
EOF
Jalankan orientasi lagi:
openclaw onboard
Masalah Koneksi Saluran
Kode QR WhatsApp tidak dapat dipindai
Masalah: Kode QR muncul tetapi aplikasi WhatsApp mengatakan "Kode QR tidak valid" atau tidak merespons.
Penyebab: Kode QR kedaluwarsa atau masalah jaringan antara ponsel Anda dan OpenClaw.
Perbaikan:
- Pastikan ponsel dan komputer Anda berada di jaringan yang sama
- Hasilkan ulang kode QR:
openclaw channels logout whatsapp
openclaw channels login whatsapp
- Pindai dalam 30 detik (kode QR cepat kedaluwarsa)
- Jika masih gagal, periksa pengaturan firewall:
# macOS
sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /usr/local/bin/node
# Linux (ufw)
sudo ufw allow 18789/tcp
WhatsApp terputus setelah beberapa jam
Masalah: WhatsApp berfungsi pada awalnya tetapi terputus setelah 2-4 jam.
Penyebab: Protokol WhatsApp memerlukan detak jantung berkala. Perubahan jaringan atau mode tidur mengganggu koneksi.
Perbaikan:
Aktifkan penyambungan ulang otomatis:
openclaw channels config whatsapp --auto-reconnect true --reconnect-interval 300
Ini memeriksa koneksi setiap 5 menit dan menyambungkan ulang jika diperlukan.
Jika Anda menggunakan laptop, cegah mode tidur saat OpenClaw berjalan:
# macOS
caffeinate -i openclaw gateway
# Linux
systemd-inhibit --what=sleep openclaw gateway
Untuk produksi, jalankan OpenClaw di server alih-alih laptop.
Bot Telegram tidak menerima pesan
Masalah: Bot daring tetapi tidak merespons pesan.
Penyebab: Bot tidak memiliki izin yang diperlukan atau token tidak valid.
Perbaikan:
Uji token bot:
curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe
Jika ini mengembalikan kesalahan, buat ulang token:
- Buka Telegram dan kirim pesan ke @BotFather
- Kirim
/mybots - Pilih bot Anda
- Pilih "API Token" → "Regenerate Token"
- Perbarui OpenClaw:
openclaw channels update telegram --token NEW_TOKEN
Untuk obrolan grup, tambahkan bot sebagai admin dengan izin "Baca Pesan".
Bot Discord terlihat luring
Masalah: Bot terlihat luring di daftar server Discord.
Penyebab: "Message Content Intent" hilang atau token tidak valid.
Perbaikan:
- Buka Portal Pengembang Discord
- Pilih aplikasi Anda
- Buka tab "Bot"
- Aktifkan "Message Content Intent" di bawah Privileged Gateway Intents
- Simpan perubahan
- Mulai ulang OpenClaw:
openclaw gateway restart
Jika bot masih luring, periksa token:
openclaw channels test discord
Jika gagal, buat ulang token di Portal Pengembang dan perbarui OpenClaw.
Bridge iMessage tidak berfungsi (macOS)
Masalah: Saluran iMessage menampilkan "terputus" atau tidak menerima pesan.
Penyebab: Izin aksesibilitas hilang atau aplikasi Pesan tidak berjalan.
Perbaikan:
- Buka Pengaturan Sistem → Privasi & Keamanan → Aksesibilitas
- Tambahkan Terminal (atau aplikasi terminal Anda) ke daftar yang diizinkan
- Mulai ulang OpenClaw:
openclaw gateway restart
- Pastikan aplikasi Pesan berjalan dan telah masuk
- Uji dengan mengirim pesan ke diri sendiri
Jika masih tidak berfungsi, periksa proses bridge:
ps aux | grep openclaw-imessage-bridge
Jika tidak berjalan, mulai secara manual:
openclaw channels restart imessage
Kesalahan Autentikasi dan API
Kunci API tidak valid
Masalah: Kesalahan "Authentication failed" atau "Invalid API key" di log.
Penyebab: Kunci API salah, kunci kedaluwarsa, atau kunci tanpa izin yang sesuai.
Perbaikan:
Verifikasi kunci API Anda:
# Untuk Anthropic
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: YOUR_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-4-6","max_tokens":10,"messages":[{"role":"user","content":"Hi"}]}'
# Untuk OpenAI
curl https://api.openai.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-4","messages":[{"role":"user","content":"Hi"}],"max_tokens":10}'
Jika perintah curl gagal, kunci Anda tidak valid. Dapatkan yang baru dari dasbor penyedia Anda.
Perbarui OpenClaw:
openclaw config set --provider anthropic --api-key NEW_KEY
Mulai ulang Gateway:
openclaw gateway restart
Batas laju terlampaui
Masalah: Kesalahan "Rate limit exceeded" atau "Terlalu banyak permintaan".
Penyebab: Anda mengirim terlalu banyak permintaan ke penyedia AI Anda.
Perbaikan:
Periksa penggunaan Anda:
openclaw stats --period 1h
Aktifkan pembatasan laju:
openclaw limits set --max-requests 50 --window 3600
Ini membatasi Anda hingga 50 permintaan per jam. Sesuaikan berdasarkan batas penyedia Anda.
Untuk lalu lintas mendadak, aktifkan antrean:
openclaw config set --enable-queue true --queue-max-size 100
Pesan mengantre saat Anda mencapai batas laju dan diproses saat kapasitas tersedia.
Model tidak ditemukan
Masalah: Kesalahan "Model tidak ditemukan" atau "Model tidak valid".
Penyebab: Anda menentukan model yang tidak ada atau tidak tersedia untuk akun Anda.
Perbaikan:
Daftar model yang tersedia:
# Anthropic
curl https://api.anthropic.com/v1/models \
-H "x-api-key: YOUR_KEY"
# OpenAI
curl https://api.openai.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
Perbarui konfigurasi agen Anda:
openclaw agents update default --model claude-sonnet-4-6
Mulai ulang Gateway:
openclaw gateway restart
Kredit tidak mencukupi
Masalah: Kesalahan "Kredit tidak mencukupi" atau "Pembayaran diperlukan".
Penyebab: Akun penyedia AI Anda kehabisan kredit atau mencapai batas penagihan.
Perbaikan:
Periksa saldo akun Anda di dasbor penyedia Anda:
- Anthropic: https://console.anthropic.com/settings/billing
- OpenAI: https://platform.openai.com/account/billing
Tambahkan kredit atau perbarui metode pembayaran Anda.
Sambil menunggu, rutekan ke model gratis atau lokal:
openclaw agents add fallback --provider ollama --model llama2
openclaw routing add --fallback fallback
Kegagalan Perutean Pesan
Pesan pergi ke agen yang salah
Masalah: Pesan diarahkan ke agen AI yang salah meskipun ada aturan perutean.
Penyebab: Aturan perutean bertentangan atau memiliki prioritas yang salah.
Perbaikan:
Daftarkan semua aturan perutean:
openclaw routing list
Periksa konflik. Aturan dengan prioritas lebih tinggi akan cocok terlebih dahulu. Jika Anda memiliki:
Prioritas 5: saluran=whatsapp → agen=default
Prioritas 10: pengirim=+1234567890 → agen=vip
Pesan dari +1234567890 di WhatsApp akan masuk ke vip (prioritas 10 menang).
Hapus aturan yang bertentangan:
openclaw routing remove <rule-id>
Tambahkan aturan dengan prioritas yang benar:
openclaw routing add --channel whatsapp --agent default --priority 1
openclaw routing add --sender +1234567890 --agent vip --priority 10
Uji perutean:
openclaw routing test --channel whatsapp --sender +1234567890 --message "test"
Ini menunjukkan agen mana yang akan menangani pesan tanpa mengirimnya.
Perutean kata kunci tidak berfungsi
Masalah: Pesan dengan kata kunci tertentu tidak diarahkan ke agen yang dikonfigurasi.
Penyebab: Kata kunci peka huruf besar/kecil atau pesan tidak mengandung kata kunci yang persis sama.
Perbaikan:
Buat kata kunci tidak peka huruf besar/kecil:
openclaw routing add --keyword "debug" --agent debugging --case-insensitive
Gunakan regex untuk pencocokan fleksibel:
openclaw routing add --pattern "debug|error|bug" --agent debugging
Ini cocok dengan "debug", "error", atau "bug" di mana saja dalam pesan.
Uji pencocokan kata kunci:
openclaw routing test --message "Saya menemukan masalah debug"
Kesalahan fungsi perutean kustom
Masalah: Fungsi perutean kustom menghasilkan kesalahan atau tidak dijalankan.
Penyebab: Kesalahan sintaks, dependensi hilang, atau nilai kembalian salah.
Perbaikan:
Uji fungsi perutean Anda:
openclaw routing test-custom ~/.openclaw/routing.js --message "test"
Ini menjalankan fungsi Anda dan menunjukkan hasil atau kesalahan.
Masalah umum:
- Kesalahan sintaks: Periksa sintaks JavaScript Anda
- Return hilang: Selalu kembalikan nama agen
- Fungsi async: Jangan gunakan async/await dalam fungsi perutean (mereka harus sinkron)
Contoh fungsi yang benar:
module.exports = function route(message) {
// Selalu kembalikan string (nama agen)
if (message.channel === 'whatsapp') {
return 'whatsapp-agent';
}
return 'default';
};
Contoh fungsi yang salah:
// JANGAN LAKUKAN INI
module.exports = async function route(message) {
const result = await someAsyncOperation();
return result; // Fungsi Async tidak didukung
};
Agen fallback tidak terpicu
Masalah: Saat agen utama gagal, pesan tidak diarahkan ke fallback.
Penyebab: Fallback tidak dikonfigurasi atau agen utama tidak melaporkan kegagalan dengan benar.
Perbaikan:
Konfigurasi fallback:
openclaw routing set-fallback backup-agent
Uji fallback:
# Nonaktifkan agen utama sementara
openclaw agents disable default
# Kirim pesan uji
openclaw routing test --message "test"
# Seharusnya menampilkan agen fallback
Aktifkan kembali agen utama:
openclaw agents enable default
Masalah Kinerja dan Memori
Penggunaan memori tinggi
Masalah: OpenClaw menggunakan RAM 2GB+ dan terus bertambah.
Penyebab: Data sesi terakumulasi dari waktu ke waktu tanpa pembersihan.
Perbaikan:
Periksa penggunaan memori:
openclaw stats --memory
Hapus sesi lama:
openclaw sessions clear --older-than 7d
Kurangi waktu tunggu sesi:
openclaw config set --session-timeout 1800
Sesi sekarang kedaluwarsa setelah 30 menit tidak aktif, bukan 1 jam default.
Aktifkan pembersihan otomatis:
openclaw config set --auto-cleanup true --cleanup-interval 3600
Ini menjalankan pembersihan setiap jam.
Waktu respons lambat
Masalah: Respons AI membutuhkan waktu 30+ detik atau kehabisan waktu (timeout).
Penyebab: Latensi jaringan, penyedia AI lambat, atau antrean yang menumpuk.
Perbaikan:
Periksa status antrean:
openclaw queue status
Jika antrean memiliki 50+ pesan, tingkatkan konkurensi:
openclaw config set --max-concurrent-requests 10
Ini memproses 10 pesan secara bersamaan alih-alih 3 default.
Periksa latensi jaringan ke penyedia AI Anda:
# Anthropic
ping api.anthropic.com
# OpenAI
ping api.openai.com
Jika latensi tinggi (>200ms), pertimbangkan untuk menggunakan penyedia yang berbeda atau model lokal.
Aktifkan batas waktu permintaan:
openclaw config set --request-timeout 30000
Permintaan yang memakan waktu lebih dari 30 detik akan gagal dan mencoba lagi.
Gateway menjadi tidak responsif
Masalah: Gateway berhenti merespons pesan atau panggilan API.
Penyebab: Deadlock, loop tak terbatas, atau kehabisan sumber daya.
Perbaikan:
Periksa status Gateway:
openclaw gateway status
Jika membeku, dapatkan thread dump:
kill -SIGUSR1 $(pgrep -f "openclaw gateway")
Ini menulis thread dump ke ~/.openclaw/gateway.log. Cari operasi yang macet.
Mulai ulang Gateway:
openclaw gateway restart
Aktifkan pemeriksaan kesehatan:
openclaw config set --health-check-interval 60
Gateway sekarang memeriksa kesehatannya sendiri setiap 60 detik dan memulai ulang jika tidak responsif.
Lonjakan penggunaan CPU
Masalah: OpenClaw menggunakan 100% CPU secara konstan.
Penyebab: Loop tak terbatas, logging berlebihan, atau banjir pesan.
Perbaikan:
Periksa apa yang mengonsumsi CPU:
top -p $(pgrep -f "openclaw gateway")
Kurangi tingkat log:
openclaw config set --log-level warn
Ini menonaktifkan log debug dan info, mengurangi I/O.
Periksa banjir pesan:
openclaw stats --messages --period 1h
Jika Anda menerima 1000+ pesan per jam, aktifkan pembatasan laju per saluran:
openclaw channels config whatsapp --rate-limit 100 --rate-window 3600
Gateway Macet dan Memulai Ulang
Gateway macet saat startup
Masalah: openclaw gateway macet segera tanpa pesan kesalahan.
Penyebab: File konfigurasi rusak atau dependensi hilang.
Perbaikan:
Jalankan dalam mode debug:
openclaw gateway --debug
Ini menampilkan pesan kesalahan yang detail.
Penyebab umum:
- Konfigurasi rusak: Cadangkan dan atur ulang konfigurasi
cp ~/.openclaw/config.json ~/.openclaw/config.json.backup
openclaw config reset
openclaw onboard
- Dependensi hilang: Instal ulang OpenClaw
npm uninstall -g openclaw
npm install -g openclaw@latest
- Port sudah digunakan: Ubah port
openclaw gateway --port 18790
Gateway macet selama operasi
Masalah: Gateway berjalan beberapa saat kemudian macet secara tak terduga.
Penyebab: Pengecualian tidak tertangani, kebocoran memori, atau proses eksternal yang menghentikannya.
Perbaikan:
Periksa log kerusakan:
tail -100 ~/.openclaw/gateway.log
Cari stack trace atau pesan kesalahan sebelum kerusakan.
Aktifkan dump kerusakan:
openclaw config set --enable-crash-dumps true
Kerusakan berikutnya menulis dump ke ~/.openclaw/crashes/. Bagikan ini dengan tim OpenClaw untuk debugging.
Jalankan Gateway dengan mulai ulang otomatis:
openclaw gateway --auto-restart
Gateway memulai ulang secara otomatis setelah macet.
Untuk produksi, gunakan pengelola proses:
# Menggunakan pm2
npm install -g pm2
pm2 start openclaw -- gateway
pm2 save
pm2 startup
Data sesi hilang setelah memulai ulang
Masalah: Percakapan diatur ulang setelah Gateway memulai ulang.
Penyebab: Sesi tidak dipertahankan ke disk atau file sesi rusak.
Perbaikan:
Aktifkan persistensi sesi:
openclaw config set --persist-sessions true --session-file ~/.openclaw/sessions.db
Sesi sekarang disimpan ke disk setiap 30 detik.
Periksa file sesi:
ls -lh ~/.openclaw/sessions.db
Jika berukuran 0 byte atau hilang, sesi tidak disimpan. Periksa ruang disk:
df -h ~
Jika disk penuh, kosongkan ruang dan mulai ulang Gateway.
Pulihkan dari cadangan:
cp ~/.openclaw/sessions.db.backup ~/.openclaw/sessions.db
openclaw gateway restart
Masalah Spesifik Platform
macOS: "openclaw" tidak dapat dibuka
Masalah: macOS memblokir OpenClaw dengan peringatan "pengembang tidak dikenal".
Penyebab: Fitur keamanan Gatekeeper macOS.
Perbaikan:
Izinkan OpenClaw:
xattr -d com.apple.quarantine $(which openclaw)
Atau buka Pengaturan Sistem → Privasi & Keamanan dan klik "Izinkan Bagaimanapun" di samping peringatan OpenClaw.
Linux: Izin ditolak untuk inotify
Masalah: "ENOSPC: Batas sistem untuk jumlah pengawas file tercapai."
Penyebab: Linux membatasi jumlah file yang dapat diawasi oleh sebuah proses.
Perbaikan:
Tingkatkan batas:
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
Mulai ulang OpenClaw:
openclaw gateway restart
Windows: Perintah tidak ditemukan
Masalah: Perintah openclaw tidak dikenali di Windows.
Penyebab: Direktori bin global npm tidak ada di PATH.
Perbaikan:
Temukan direktori global npm:
npm config get prefix
Tambahkan ke PATH:
- Buka Properti Sistem → Variabel Lingkungan
- Edit "Path" di bawah Variabel pengguna
- Tambahkan
C:\Users\NamaAnda\AppData\Roaming\npm(atau path dari atas) - Klik OK dan mulai ulang terminal Anda
Verifikasi:
openclaw --version
Docker: Masalah jaringan
Masalah: OpenClaw di Docker tidak dapat terhubung ke platform pesan.
Penyebab: Isolasi jaringan Docker.
Perbaikan:
Jalankan dengan jaringan host:
docker run --network host openclaw/openclaw gateway
Atau ekspos port Gateway:
docker run -p 18789:18789 openclaw/openclaw gateway
Untuk WhatsApp, Anda perlu mengekspos port tambahan untuk pemindaian kode QR:
docker run -p 18789:18789 -p 3000:3000 openclaw/openclaw gateway
Alat Debugging dan Log
Aktifkan logging debug
Dapatkan log detail:
openclaw config set --log-level debug
openclaw gateway restart
Log masuk ke ~/.openclaw/gateway.log secara default.
Pantau log secara real-time:
tail -f ~/.openclaw/gateway.log
Uji komponen individual
Uji saluran:
openclaw channels test whatsapp
openclaw channels test telegram
openclaw channels test discord
Uji agen:
openclaw agents test default --message "Halo"
Uji perutean:
openclaw routing test --channel whatsapp --sender +1234567890 --message "masalah debug"
Periksa status Gateway
Dapatkan status saat ini:
openclaw gateway inspect
Ini menunjukkan:
- Saluran aktif dan statusnya
- Agen yang dikonfigurasi dan kesehatannya
- Aturan perutean dan prioritas
- Ukuran antrean dan pesan yang tertunda
- Penggunaan memori dan waktu aktif
Ekspor diagnostik
Hasilkan laporan diagnostik:
openclaw diagnostics export > openclaw-diagnostics.json
Ini mencakup:
- Konfigurasi (dengan kunci API disunting)
- Log terbaru
- Jumlah kesalahan
- Metrik kinerja
- Info sistem
Bagikan ini dengan dukungan saat melaporkan masalah.
Debugging jaringan
Uji konektivitas ke penyedia AI:
openclaw network test anthropic
openclaw network test openai
Ini memeriksa:
- Resolusi DNS
- Jabat tangan TLS
- Keterjangkauan endpoint API
- Latensi
Jika ada pemeriksaan yang gagal, Anda memiliki masalah jaringan.
FAQ
Mengapa OpenClaw menggunakan begitu banyak memori?
OpenClaw menyimpan riwayat sesi di memori untuk akses cepat. Setiap sesi menyimpan konteks percakapan penuh. Jika Anda memiliki 100 sesi aktif dengan masing-masing 50 pesan, itu berarti 5000 pesan dalam memori.
Kurangi penggunaan memori:
- Kurangi waktu tunggu sesi
- Aktifkan pembersihan otomatis
- Batasi panjang konteks per sesi
openclaw config set --session-timeout 1800 --auto-cleanup true --max-context-length 50
Bisakah saya menjalankan OpenClaw tanpa internet?
Ya, jika Anda menggunakan model AI lokal. Instal Ollama dan konfigurasikan OpenClaw untuk menggunakannya:
# Instal Ollama
curl https://ollama.ai/install.sh | sh
# Tarik model
ollama pull llama2
# Konfigurasi OpenClaw
openclaw agents add local --provider ollama --model llama2 --endpoint http://localhost:11434
Platform pesan masih membutuhkan internet, tetapi inferensi AI berjalan secara lokal.
Bagaimana cara bermigrasi ke mesin baru?
Ekspor konfigurasi Anda:
openclaw config export > openclaw-backup.json
Salin openclaw-backup.json ke mesin baru.
Instal OpenClaw:
npm install -g openclaw@latest
Impor konfigurasi:
openclaw config import openclaw-backup.json
Sambungkan kembali saluran (kode QR dan token tidak ditransfer):
openclaw channels login whatsapp
openclaw channels update telegram --token TOKEN_ANDA
Mengapa pesan tiba tidak berurutan?
OpenClaw memproses pesan secara bersamaan. Jika Anda mengirim 3 pesan dengan cepat, pesan tersebut mungkin mencapai penyedia AI dalam urutan yang berbeda tergantung pada waktu jaringan.
Aktifkan pemrosesan berurutan:
openclaw config set --max-concurrent-requests 1
Ini memproses satu pesan pada satu waktu, menjaga urutan. Lebih lambat tetapi menjamin urutan.
Bisakah saya menggunakan OpenClaw untuk produksi?
Ya, tetapi ikuti panduan ini:
- Jalankan di server, bukan laptop
- Gunakan pengelola proses (pm2, systemd)
- Aktifkan persistensi sesi
- Siapkan pemantauan dan peringatan
- Konfigurasi batas laju
- Gunakan reverse proxy (nginx) untuk UI Kontrol
- Aktifkan HTTPS
- Cadangkan konfigurasi secara teratur
Contoh layanan systemd:
[Unit]
Description=OpenClaw Gateway
After=network.target
[Service]
Type=simple
User=openclaw
WorkingDirectory=/home/openclaw
ExecStart=/usr/bin/openclaw gateway --port 18789
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
Bagaimana cara melaporkan bug?
- Hasilkan diagnostik:
openclaw diagnostics export > diagnostics.json
- Buka masalah di GitHub
- Sertakan:
- Versi OpenClaw (
openclaw --version) - Versi Node.js (
node --version) - Sistem operasi
- Langkah-langkah untuk mereproduksi
- Laporan diagnostik (sunting data sensitif)
Kesimpulan
Sebagian besar masalah OpenClaw berasal dari masalah jaringan, konfigurasi yang salah, atau kekhasan khusus platform. Panduan ini mencakup 15 kesalahan paling umum dan perbaikannya.
Langkah-langkah pemecahan masalah utama:
- Periksa log terlebih dahulu (
~/.openclaw/gateway.log) - Uji komponen secara individual (saluran, agen, perutean)
- Aktifkan mode debug untuk kesalahan detail
- Gunakan alat diagnostik untuk mengekspor status
- Bergabunglah dengan komunitas untuk mendapatkan bantuan
Jika Anda membangun alur kerja API bersama OpenClaw, periksa Apidog untuk desain API, pengujian, dan dokumentasi. Ini melengkapi antarmuka percakapan OpenClaw dengan manajemen API terstruktur.
tombol
Langkah selanjutnya:
- Tandai panduan ini untuk referensi cepat
- Siapkan pemantauan untuk mendeteksi masalah lebih awal
- Bergabunglah dengan Discord OpenClaw untuk bantuan real-time
- Kontribusikan perbaikan kembali ke proyek di GitHub