Pemecahan masalah gateway OpenClaw

Jika halaman triase cepat tidak cukup, dokumentasi mengarahkan Anda ke runbook gateway mendalam. Runbook ini adalah indeks, bukan tembok berisi perbaikan: tangga perintah, sinyal yang ditunjukkan gateway yang sehat, dan enam halaman per area gejala dengan anchor yang stabil. Bagian paling bergunanya adalah daftar pendek hal-hal yang rusak tepat setelah pembaruan. Berikut petanya.

Tangga dan enam halaman

• Jalankan perintah status, gateway status, log follow, doctor, dan channel probe dalam urutan itu; sehat berarti gateway status menunjukkan runtime yang berjalan, probe konektivitas ok, dan sebuah baris kapabilitas, doctor tidak melaporkan masalah konfigurasi atau layanan yang memblokir, dan probe menunjukkan status transport live per akun dengan penanda works atau audit ok bila didukung.
• Pembaruan dan rollback mencakup gateway yang mati atau tidak cocok akibat pembaruan, downgrade, atau instalasi split-brain: setelah pembaruan, timeout publikasi runtime model yang disiapkan, guard konfigurasi yang lebih baru, memperbaiki search path, menginstal ulang layanan, menghapus wrapper usang, dan ketidakcocokan protokol setelah rollback. Skill dan penyedia model mencakup root skill yang dilewati, error rate limit untuk konteks panjang beserta perbaikannya lewat jendela standar, kredensial yang memenuhi syarat, dan model cadangan, respons upstream yang diblokir, serta backend lokal yang kompatibel dengan OpenAI yang lolos probe tetapi gagal saat eksekusi agen.
• Balasan agen dan antarmuka kontrol mencakup eksekusi yang gagal dengan error penyimpanan, balasan yang tidak kunjung datang, konektivitas dasbor, signature connect dan autentikasi beserta peta cepat kode detail autentikasi dan connect challenge, serta langkah penandatanganan payload dan nonce perangkat. Layanan dan proses gateway mencakup layanan yang tidak mau berjalan atau tidak bertahan hidup, gateway macOS yang diam-diam berhenti sampai dasbor disentuh, loop supervisor dengan launch agent duplikat, dan proses yang keluar saat penggunaan memori tinggi.
• Validasi konfigurasi dan probe mencakup konfigurasi tidak valid yang ditolak, apa yang terjadi, inspeksi dan perbaikan, signature umumnya dan opsi perbaikannya, serta peringatan gateway probe. Pengiriman saluran dan alat mencakup saluran yang terhubung tetapi pesannya tidak mengalir, pengiriman terjadwal dan heartbeat, node yang sudah disandingkan tetapi alatnya gagal, kegagalan alat browser, signature plugin dan executable, signature sesi browser, serta signature elemen, screenshot, dan unggahan; setiap anchor lama dari halaman tunggal itu masih mengarah ke lokasi barunya.

Sebagian besar kerusakan setelah pembaruan adalah pergeseran konfigurasi atau default yang lebih ketat yang kini diberlakukan.

Jika Anda melakukan pembaruan dan ada yang rusak

Indeks ini menyimpan tiga pemeriksaan langsung di halamannya. Pertama, perilaku override autentikasi dan URL: baca mode gateway, URL remote, dan mode autentikasi, karena dengan mode disetel ke remote, baris perintah mungkin sedang menargetkan gateway remote sementara layanan lokal baik-baik saja, dan panggilan dengan URL eksplisit tidak kembali ke kredensial tersimpan; signature connect-failed berarti target URL salah, dan signature unauthorized berarti endpoint dapat dijangkau tetapi dengan autentikasi yang salah. Kedua, pagar pengaman bind dan autentikasi lebih ketat: bind non-loopback memerlukan jalur autentikasi yang valid, yaitu token atau kata sandi bersama, atau proxy tepercaya non-loopback yang dikonfigurasi dengan benar, dan kunci token lama tidak menggantikan kunci token autentikasi saat ini; penolakan bind tanpa autentikasi dan probe konektivitas yang gagal saat runtime berjalan adalah signature-nya. Ketiga, status penyandingan dan identitas perangkat: tampilkan daftar perangkat dan penyandingan saluran, lalu cari persetujuan perangkat yang tertunda untuk dasbor atau node serta persetujuan yang tertunda setelah perubahan kebijakan atau identitas; device identity required dan pairing required adalah signature-nya. Jika konfigurasi layanan dan runtime masih tidak sepakat, instal ulang metadata layanan dari profil dan direktori state yang sama, lalu mulai ulang.

Membaca sinyal

• Runtime yang berjalan dengan probe konektivitas yang gagal adalah kombinasi yang paling bermakna: prosesnya hidup, tetapi baris perintah tidak dapat menjangkaunya dengan URL dan autentikasi saat ini, jadi perbaikannya ada di mode, URL, atau token, bukan di layanan.
• Signature device identity required setelah pembaruan bukanlah bug di klien; autentikasi perangkat kini diberlakukan dan dasbor atau node memerlukan persetujuannya yang tertunda, yang ditampilkan oleh daftar perangkat dan penyandingan.
• Probe berjalan per akun: saluran dengan dua akun dapat menunjukkan satu transport berfungsi dan satu gagal, yang tidak terlihat hanya dari baris status.

Pemecahan masalah saluran OpenClaw adalah pendamping tingkat saluran untuk kasus ketika transport terhubung tetapi perilakunya salah, dan OpenClaw doctor menjelaskan perintah perbaikan yang diandalkan oleh tangga ini.

Mengapa sebuah indeks

Memecah runbook berdasarkan area gejala membuat setiap halaman cukup pendek untuk dibaca saat ada yang sedang mati, dan anchor yang dipertahankan membuat tautan dari utas dan issue lama tetap mendarat di bagian yang tepat. Urutan tangga ini juga disengaja: dimulai dari sinyal yang paling luas ke yang paling sempit, dan doctor ditempatkan sebelum probe karena doctor memperbaiki kesalahan konfigurasi yang jika tidak akan dilaporkan probe sebagai kegagalan. Penyandingan OpenClaw membahas persetujuan yang dicari oleh pemeriksaan ketiga, dan konfigurasi OpenClaw membahas kunci yang dibaca oleh dua pemeriksaan pertama.

Di Diali

Di Diali, konfigurasi runtime dihasilkan dari dasbor dan diganti pada setiap rilis, yang menghilangkan sebagian besar pergeseran yang dijelaskan di bagian setelah pembaruan, dan tangga yang sama berjalan di runtime yang di-hosting. OpenClaw yang di-hosting di Diali menjelaskan asisten yang di-hosting, dan keamanan Diali menjelaskan batas di sekitarnya.

• Lima perintah secara berurutan; runtime berjalan ditambah probe ok berarti sehat.
• Enam halaman gejala; setiap anchor lama masih mengarah ke tujuannya.
• Setelah pembaruan: mode dan URL, bind dan autentikasi, status penyandingan.