Pemecahan Masalah

Halaman ini adalah runbook mendalam. Mulai dari /help/troubleshooting jika Anda ingin alur triase cepat terlebih dahulu.

Tangga perintah

Jalankan ini terlebih dahulu, dalam urutan ini:

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Sinyal sehat yang diharapkan:

• openclaw gateway status menampilkan Runtime: running, Connectivity probe: ok, dan baris Capability: ....
• openclaw doctor tidak melaporkan masalah konfigurasi/layanan yang memblokir.
• openclaw channels status --probe menampilkan status transport per akun secara langsung dan, jika didukung, hasil probe/audit seperti works atau audit ok.

Setelah pembaruan

Gunakan ini saat pembaruan selesai tetapi Gateway mati, channel kosong, atau panggilan model mulai gagal dengan 401.

openclaw status --allopenclaw update status --jsonopenclaw gateway status --deepopenclaw doctor --fixopenclaw gateway restart

Cari:

• Update restart di openclaw status / openclaw status --all. Handoff yang tertunda atau gagal menyertakan perintah berikutnya untuk dijalankan.
• plugin load failed: dependency tree corrupted; run openclaw doctor --fix di bawah Channels. Itu berarti konfigurasi channel masih ada, tetapi pendaftaran Plugin gagal sebelum channel dapat dimuat.
• 401 provider setelah autentikasi ulang. openclaw doctor --fix memeriksa bayangan autentikasi OAuth per agen yang usang dan menghapus salinan lama agar semua agen me-resolve profil bersama saat ini.

Instalasi split-brain dan guard konfigurasi yang lebih baru

Gunakan ini saat layanan gateway berhenti tiba-tiba setelah pembaruan, atau log menunjukkan bahwa satu biner openclaw lebih lama daripada versi yang terakhir menulis openclaw.json.

OpenClaw menandai penulisan konfigurasi dengan meta.lastTouchedVersion. Perintah baca-saja masih dapat memeriksa konfigurasi yang ditulis oleh OpenClaw yang lebih baru, tetapi mutasi proses dan layanan menolak melanjutkan dari biner yang lebih lama. Tindakan yang diblokir mencakup memulai, menghentikan, memulai ulang, menghapus instalasi layanan gateway, instal ulang layanan paksa, startup gateway mode layanan, dan pembersihan port gateway --force.

which openclawopenclaw --versionopenclaw gateway status --deepopenclaw config get meta.lastTouchedVersion

openclaw gateway install --forceopenclaw gateway restart

Ketidakcocokan protokol setelah rollback

Gunakan ini saat log terus mencetak protocol mismatch setelah Anda menurunkan versi atau melakukan rollback OpenClaw. Ini berarti Gateway yang lebih lama sedang berjalan, tetapi proses klien lokal yang lebih baru masih mencoba menyambung kembali dengan rentang protokol yang tidak dapat digunakan oleh Gateway yang lebih lama.

openclaw --versionwhich -a openclawopenclaw gateway status --deepopenclaw doctor --deepopenclaw logs --follow

Cari:

• protocol mismatch ... client=... v<version> min=<n> max=<n> expected=<n> di log Gateway.
• Established clients: di openclaw gateway status --deep atau Gateway clients di openclaw doctor --deep. Ini mencantumkan klien TCP aktif yang terhubung ke port Gateway, termasuk PID dan baris perintah jika OS mengizinkannya.
• Proses klien yang baris perintahnya menunjuk ke instalasi OpenClaw atau wrapper lebih baru yang Anda rollback.

Perbaikan:

1. Hentikan atau mulai ulang proses klien OpenClaw usang yang ditampilkan oleh gateway status --deep.
2. Mulai ulang aplikasi atau wrapper yang menyematkan OpenClaw, seperti dasbor lokal, editor, pembantu server aplikasi, atau shell openclaw logs --follow yang berjalan lama.
3. Jalankan ulang openclaw gateway status --deep atau openclaw doctor --deep dan konfirmasi PID klien usang sudah hilang.

Jangan membuat Gateway yang lebih lama menerima protokol baru yang tidak kompatibel. Kenaikan protokol melindungi kontrak wire; pemulihan rollback adalah masalah pembersihan proses/versi.

Symlink Skills dilewati sebagai pelarian jalur

Gunakan ini saat log menyertakan:

Skipping escaped skill path outside its configured root: ... reason=symlink-escape

OpenClaw memperlakukan setiap root skill sebagai batas containment. Symlink di bawah ~/.agents/skills, <workspace>/.agents/skills, <workspace>/skills, atau ~/.openclaw/skills dilewati saat target aslinya me-resolve ke luar root tersebut kecuali target secara eksplisit dipercaya.

Periksa link:

ls -l ~/.agents/skills/<name>realpath ~/.agents/skills/<name>openclaw config get skills.load

Jika target disengaja, konfigurasikan root skill langsung dan target symlink yang diizinkan:

{  skills: {    load: {      extraDirs: ["~/Projects/manager/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],    },  },}

Lalu mulai sesi baru atau tunggu watcher skills menyegarkan. Mulai ulang gateway jika proses yang berjalan sudah ada sebelum perubahan konfigurasi.

Jangan gunakan target luas seperti ~, /, atau seluruh folder proyek yang disinkronkan. Jaga allowSymlinkTargets tetap terbatas pada root skill asli yang berisi direktori SKILL.md tepercaya.

Jika Skill Workshop apply juga harus menulis melalui jalur skill workspace tersymlink tepercaya tersebut, aktifkan skills.workshop.allowSymlinkTargetWrites. Biarkan dinonaktifkan untuk root skill bersama baca-saja.

Terkait:

• Konfigurasi Skills
• Contoh konfigurasi

Anthropic 429 memerlukan penggunaan ekstra untuk konteks panjang

Gunakan ini saat log/error menyertakan: HTTP 429: rate_limit_error: Extra usage is required for long context requests.

openclaw logs --followopenclaw models statusopenclaw config get agents.defaults.models

Cari:

• Model Anthropic yang dipilih adalah model Claude 4.x 1M berkemampuan GA, atau model memiliki params.context1m: true lama.
• Kredensial Anthropic saat ini tidak memenuhi syarat untuk penggunaan konteks panjang.
• Permintaan gagal hanya pada sesi panjang/run model yang memerlukan jalur konteks 1M.

Opsi perbaikan:

Terkait:

• Anthropic
• Penggunaan token dan biaya
• Mengapa saya melihat HTTP 429 dari Anthropic?

Respons upstream 403 diblokir

Gunakan ini saat provider LLM upstream mengembalikan 403 generik seperti Your request was blocked.

Jangan berasumsi ini selalu merupakan masalah konfigurasi OpenClaw. Respons dapat berasal dari lapisan keamanan upstream seperti CDN, WAF, aturan manajemen bot, atau reverse proxy di depan endpoint kompatibel OpenAI.

openclaw statusopenclaw gateway statusopenclaw logs --follow

Cari:

• beberapa model di bawah provider yang sama gagal dengan cara yang sama
• HTML atau teks keamanan generik, bukan error API provider normal
• peristiwa keamanan sisi provider untuk waktu permintaan yang sama
• probe curl langsung kecil berhasil sementara permintaan berbentuk SDK normal gagal

Perbaiki pemfilteran sisi provider terlebih dahulu saat bukti mengarah ke blokir WAF/CDN. Utamakan aturan allow atau skip yang terbatas sempit untuk jalur API yang digunakan OpenClaw, dan hindari menonaktifkan perlindungan untuk seluruh situs.

Terkait:

• Endpoint kompatibel OpenAI
• Konfigurasi provider
• Log

Backend lokal kompatibel OpenAI lolos probe langsung tetapi run agen gagal

Gunakan ini saat:

• curl ... /v1/models berfungsi
• panggilan langsung kecil /v1/chat/completions berfungsi
• run model OpenClaw gagal hanya pada giliran agen normal

curl http://127.0.0.1:1234/v1/modelscurl http://127.0.0.1:1234/v1/chat/completions \  -H 'content-type: application/json' \  -d '{"model":"<id>","messages":[{"role":"user","content":"hi"}],"stream":false}'openclaw infer model run --model <provider/model> --prompt "hi" --jsonopenclaw logs --follow

Cari:

• panggilan langsung kecil berhasil, tetapi run OpenClaw gagal hanya pada prompt yang lebih besar
• error model_not_found atau 404 meskipun /v1/chat/completions langsung berfungsi dengan id model polos yang sama
• error backend tentang messages[].content yang mengharapkan string
• peringatan incomplete turn detected ... stopReason=stop payloads=0 intermiten dengan backend lokal kompatibel OpenAI
• crash backend yang muncul hanya dengan jumlah token prompt lebih besar atau prompt runtime agen penuh

Terkait:

• Konfigurasi
• Model lokal
• Endpoint kompatibel OpenAI

Tidak ada balasan

Jika saluran aktif tetapi tidak ada yang menjawab, periksa perutean dan kebijakan sebelum menghubungkan ulang apa pun.

openclaw statusopenclaw channels status --probeopenclaw pairing list --channel <channel> [--account <id>]openclaw config get channelsopenclaw logs --follow

Cari:

• Penyandingan tertunda untuk pengirim DM.
• Pembatasan penyebutan grup (requireMention, mentionPatterns).
• Ketidakcocokan allowlist saluran/grup.

Tanda umum:

• drop guild message (mention required → pesan grup diabaikan sampai ada penyebutan.
• pairing request → pengirim perlu persetujuan.
• blocked / allowlist → pengirim/saluran difilter oleh kebijakan.

Terkait:

• Pemecahan masalah saluran
• Grup
• Penyandingan

Konektivitas UI kontrol dasbor

Saat UI dasbor/kontrol tidak dapat terhubung, validasi URL, mode autentikasi, dan asumsi konteks aman.

openclaw gateway statusopenclaw statusopenclaw logs --followopenclaw doctoropenclaw gateway status --json

Cari:

• URL probe dan URL dasbor yang benar.
• Ketidakcocokan mode/token autentikasi antara klien dan gateway.
• Penggunaan HTTP saat identitas perangkat diperlukan.

Jika browser lokal tidak dapat terhubung ke 127.0.0.1:18789 setelah pembaruan, pertama pulihkan layanan Gateway lokal dan pastikan layanan tersebut menyajikan dasbor:

openclaw gateway restartlsof -i :18789curl http://127.0.0.1:18789

Jika curl mengembalikan HTML OpenClaw, Gateway berfungsi dan masalah yang tersisa kemungkinan adalah cache browser, tautan dalam lama, atau status tab yang kedaluwarsa. Buka http://127.0.0.1:18789 secara langsung dan navigasi dari dasbor. Jika mulai ulang tidak membuat layanan tetap berjalan, jalankan openclaw gateway start dan periksa ulang openclaw gateway status.

Peta cepat kode detail autentikasi

Gunakan error.details.code dari respons connect yang gagal untuk memilih tindakan berikutnya:

Pemeriksaan migrasi auth perangkat v2:

openclaw --versionopenclaw doctoropenclaw gateway status

Jika log menampilkan kesalahan nonce/tanda tangan, perbarui klien yang terhubung dan verifikasi:

Jika openclaw devices rotate / revoke / remove ditolak secara tidak terduga:

• sesi token perangkat yang dipasangkan hanya dapat mengelola perangkat miliknya sendiri kecuali pemanggil juga memiliki operator.admin
• openclaw devices rotate --scope ... hanya dapat meminta scope operator yang sudah dimiliki sesi pemanggil

Terkait:

• Konfigurasi (mode autentikasi gateway)
• UI Kontrol
• Perangkat
• Akses jarak jauh
• Autentikasi proxy tepercaya

Layanan Gateway tidak berjalan

Gunakan ini saat layanan terinstal tetapi proses tidak tetap aktif.

openclaw gateway statusopenclaw statusopenclaw logs --followopenclaw doctoropenclaw gateway status --deep   # juga pindai layanan tingkat sistem

Cari:

• Runtime: stopped dengan petunjuk kode keluar.
• Ketidakcocokan konfigurasi layanan (Config (cli) vs Config (service)).
• Konflik port/listener.
• Instalasi launchd/systemd/schtasks tambahan saat --deep digunakan.
• Petunjuk pembersihan Other gateway-like services detected (best effort).

Terkait:

• Eksekusi latar belakang dan alat proses
• Konfigurasi
• Doctor

Gateway macOS berhenti merespons diam-diam, lalu pulih saat Anda menyentuh dasbor

Gunakan ini saat saluran (Telegram, WhatsApp, dll.) pada host macOS menjadi senyap selama beberapa menit hingga berjam-jam, dan gateway tampaknya kembali begitu Anda membuka UI Kontrol, masuk melalui SSH, atau berinteraksi dengan host dengan cara lain. Biasanya tidak ada gejala jelas di openclaw status karena saat Anda memeriksa, gateway sudah hidup kembali.

ls ~/.openclaw/logs/stability/ | tail -5openclaw gateway stability --bundle latestpmset -g log | grep -iE "sleep|wake|maintenance" | tail -50launchctl print gui/$UID/ai.openclaw.gateway | grep -E "state|last exit|runs"

Cari:

• Satu atau beberapa bundle *-uncaught_exception.json di ~/.openclaw/logs/stability/ dengan error.code diatur ke kode jaringan transien seperti ENETDOWN, ENETUNREACH, EHOSTUNREACH, atau ECONNREFUSED.
• Baris pmset -g log seperti Entering Sleep state due to 'Maintenance Sleep' atau en0 driver is slow (msg: WillChangeState to 0) yang selaras dengan timestamp crash. Power Nap / Maintenance Sleep secara singkat menempatkan driver Wi-Fi ke status 0; setiap connect() keluar yang terjadi dalam jendela itu dapat gagal dengan ENETDOWN bahkan pada host yang selain itu memiliki konektivitas jaringan penuh.
• Output launchctl print yang menunjukkan state = not running dengan beberapa runs terbaru dan kode keluar, terutama ketika jeda antara crash dan peluncuran berikutnya berada di kisaran satu jam, bukan detik. macOS launchd menerapkan gerbang perlindungan respawn yang tidak terdokumentasi setelah rentetan crash yang dapat berhenti menghormati KeepAlive=true sampai pemicu eksternal seperti login interaktif, koneksi dasbor, atau launchctl kickstart mengaktifkannya kembali.

Tanda umum:

• Bundle stabilitas yang error.code-nya adalah ENETDOWN atau kode terkait, dengan stack panggilan mengarah ke Node net lookupAndConnect / Socket.connect. OpenClaw 2026.5.26 dan yang lebih baru mengklasifikasikan ini sebagai kesalahan jaringan transien jinak sehingga tidak lagi menyebar ke handler uncaught tingkat atas; jika Anda memakai rilis yang lebih lama, tingkatkan versi terlebih dahulu.
• Periode senyap panjang yang berakhir seketika saat Anda terhubung ke Control UI atau SSH ke host: aktivitas yang terlihat oleh pengguna itulah yang mengaktifkan kembali gerbang respawn launchd, bukan apa pun yang dilakukan dasbor pada Gateway.
• Hitungan runs bertambah sepanjang hari tanpa baris received SIG*; shutting down yang sesuai di ~/Library/Logs/openclaw/gateway.log: shutdown bersih mencatat sinyal; crash transien tidak.

Yang harus dilakukan:

1. Tingkatkan Gateway jika Anda menjalankan rilis sebelum 2026.5.26. Setelah peningkatan, kesalahan ENETDOWN berikutnya dicatat sebagai peringatan, bukan menghentikan proses.

2. Kurangi aktivitas maintenance sleep pada host Mac mini / desktop yang dimaksudkan berjalan sebagai server selalu aktif:

   sudo pmset -a sleep 0 disksleep 0 standby 0 powernap 0

   Ini secara signifikan mengurangi, tetapi tidak sepenuhnya menghilangkan, flap driver yang mendasarinya. Sistem masih dapat melakukan sebagian maintenance sleep untuk TCP keepalive dan pemeliharaan mDNS terlepas dari flag ini.

3. Tambahkan watchdog liveness agar rentetan crash di masa depan yang diparkir oleh launchd tertangkap dengan cepat:

   # Example launchd-aware liveness check, suitable for a 5-minute cron or LaunchAgentstate=$(launchctl print gui/$UID/ai.openclaw.gateway 2>/dev/null | awk -F'= ' '/state =/ {print $2; exit}')if [ "$state" != "running" ]; then  launchctl kickstart -k gui/$UID/ai.openclaw.gatewayfi

   Intinya adalah mengaktifkan kembali gerbang respawn secara eksternal; KeepAlive=true saja tidak cukup di macOS setelah rentetan crash.

Terkait:

• Catatan platform macOS
• Pencatatan
• Doctor

Gateway keluar selama penggunaan memori tinggi

Gunakan ini saat Gateway menghilang saat beban tinggi, supervisor melaporkan restart bergaya OOM, atau log menyebutkan critical memory pressure bundle written.

openclaw gateway status --deepopenclaw logs --followopenclaw gateway stability --bundle latestopenclaw gateway diagnostics export

Cari:

• Reason: diagnostic.memory.pressure.critical di bundle stabilitas terbaru.
• Memory pressure: dengan critical/rss_threshold, critical/heap_threshold, atau critical/rss_growth.
• Nilai V8 heap: yang mendekati batas heap.
• Entri Largest session files: seperti agents/<agent>/sessions/<session>.jsonl atau sessions/<session>.jsonl.
• Counter memori cgroup Linux saat Gateway berjalan di dalam container atau layanan dengan batas memori.

Tanda umum:

• critical memory pressure bundle written muncul tidak lama sebelum restart → OpenClaw menangkap bundle stabilitas pra-OOM. Periksa dengan openclaw gateway stability --bundle latest.
• memory pressure: level=critical ... memoryPressureSnapshot=disabled muncul di log Gateway → OpenClaw mendeteksi tekanan memori kritis, tetapi snapshot stabilitas pra-OOM dimatikan.
• Largest session files: mengarah ke path transkrip tersunting yang sangat besar → kurangi riwayat sesi yang dipertahankan, periksa pertumbuhan sesi, atau pindahkan transkrip lama keluar dari penyimpanan aktif sebelum restart.
• Byte terpakai V8 heap: mendekati batas heap → turunkan tekanan prompt/sesi, kurangi pekerjaan serentak, atau naikkan batas heap Node hanya setelah memastikan workload memang diharapkan.
• Memory pressure: critical/rss_growth → memori tumbuh cepat dalam satu jendela sampling. Periksa log terbaru untuk impor besar, output tool yang tidak terkendali, retry berulang, atau batch pekerjaan agen yang antre.
• Tekanan memori kritis muncul di log tetapi tidak ada bundle → ini adalah default. Atur diagnostics.memoryPressureSnapshot: true untuk menangkap bundle stabilitas pra-OOM pada peristiwa tekanan memori kritis berikutnya.

Bundle stabilitas bebas payload. Isinya mencakup bukti memori operasional dan path file relatif yang disunting, bukan teks pesan, body webhook, kredensial, token, cookie, atau id sesi mentah. Lampirkan ekspor diagnostik ke laporan bug alih-alih menyalin log mentah.

Terkait:

• Kesehatan Gateway
• Ekspor diagnostik
• Sesi

Gateway menolak config yang tidak valid

Gunakan ini saat startup Gateway gagal dengan Invalid config atau log hot reload mengatakan ia melewati edit yang tidak valid.

openclaw logs --followopenclaw config fileopenclaw config validateopenclaw doctor

Cari:

• Invalid config at ...
• config reload skipped (invalid config): ...
• Config write rejected: ...
• File openclaw.json.rejected.* bertimestamp di samping config aktif
• File openclaw.json.clobbered.* bertimestamp jika doctor --fix memperbaiki edit langsung yang rusak
• OpenClaw menyimpan 32 file .clobbered.* terbaru untuk setiap path config dan merotasi yang lebih lama

CONFIG="$(openclaw config file)"ls -lt "$CONFIG".clobbered.* "$CONFIG".rejected.* 2>/dev/null | headdiff -u "$CONFIG" "$(ls -t "$CONFIG".clobbered.* 2>/dev/null | head -n 1)"openclaw config validateopenclaw doctor

Terkait:

• Config
• Konfigurasi: hot reload
• Konfigurasi: validasi ketat
• Doctor

Peringatan probe Gateway

Gunakan ini saat openclaw gateway probe mencapai sesuatu, tetapi tetap mencetak blok peringatan.

openclaw gateway probeopenclaw gateway probe --jsonopenclaw gateway probe --ssh user@gateway-host

Cari:

• warnings[].code dan primaryTargetId di output JSON.
• Apakah peringatan terkait fallback SSH, beberapa Gateway, scope yang hilang, atau ref auth yang tidak terselesaikan.

Tanda umum:

• SSH tunnel failed to start; falling back to direct probes. → penyiapan SSH gagal, tetapi perintah tetap mencoba target langsung yang dikonfigurasi/loopback.
• multiple reachable gateway identities detected → Gateway berbeda menjawab, atau OpenClaw tidak dapat membuktikan target yang dapat dijangkau adalah Gateway yang sama. Tunnel SSH, URL proxy, atau URL remote yang dikonfigurasi ke Gateway yang sama diperlakukan sebagai satu Gateway dengan beberapa transport, bahkan saat port transport berbeda.
• Read-probe diagnostics are limited by gateway scopes (missing operator.read) → koneksi berhasil, tetapi RPC detail dibatasi scope; pasangkan identitas perangkat atau gunakan kredensial dengan operator.read.
• Gateway accepted the WebSocket connection, but follow-up read diagnostics failed → koneksi berhasil, tetapi set RPC diagnostik penuh timeout atau gagal. Perlakukan ini sebagai Gateway yang dapat dijangkau dengan diagnostik terdegradasi; bandingkan connect.ok dan connect.rpcOk di output --json.
• Capability: pairing-pending atau gateway closed (1008): pairing required → Gateway menjawab, tetapi klien ini masih membutuhkan pairing/persetujuan sebelum akses operator normal.
• teks peringatan SecretRef gateway.auth.* / gateway.remote.* yang tidak terselesaikan → material auth tidak tersedia di path perintah ini untuk target yang gagal.

Terkait:

• Gateway
• Beberapa Gateway di host yang sama
• Akses remote

Channel terhubung, pesan tidak mengalir

Jika status channel terhubung tetapi alur pesan mati, fokus pada kebijakan, izin, dan aturan pengiriman khusus channel.

openclaw channels status --probeopenclaw pairing list --channel <channel> [--account <id>]openclaw status --deepopenclaw logs --followopenclaw config get channels

Cari:

• Kebijakan DM (pairing, allowlist, open, disabled).
• Allowlist grup dan persyaratan mention.
• Izin/scope API channel yang hilang.

Tanda umum:

• mention required → pesan diabaikan oleh kebijakan mention grup.
• Jejak pairing / persetujuan tertunda → pengirim belum disetujui.
• missing_scope, not_in_channel, Forbidden, 401/403 → masalah auth/izin channel.

Terkait:

• Pemecahan masalah channel
• Discord
• Telegram
• WhatsApp

Pengiriman Cron dan Heartbeat

Jika Cron atau Heartbeat tidak berjalan atau tidak terkirim, verifikasi status scheduler terlebih dahulu, lalu target pengiriman.

openclaw cron statusopenclaw cron listopenclaw cron runs --id <jobId> --limit 20openclaw system heartbeat lastopenclaw logs --follow

Cari:

• Cron aktif dan wake berikutnya tersedia.
• Status riwayat eksekusi job (ok, skipped, error).
• Alasan Heartbeat dilewati (quiet-hours, requests-in-flight, cron-in-progress, lanes-busy, alerts-disabled, empty-heartbeat-file, no-tasks-due).

Terkait:

• Heartbeat
• Tugas terjadwal
• Tugas terjadwal: pemecahan masalah

Node dipasangkan, alat gagal

Jika sebuah node dipasangkan tetapi alat gagal, isolasi status foreground, izin, dan persetujuan.

openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>openclaw logs --followopenclaw status

Cari:

• Node online dengan kapabilitas yang diharapkan.
• Pemberian izin OS untuk kamera/mikrofon/lokasi/layar.
• Persetujuan exec dan status allowlist.

Tanda umum:

• NODE_BACKGROUND_UNAVAILABLE → aplikasi node harus berada di foreground.
• *_PERMISSION_REQUIRED / LOCATION_PERMISSION_REQUIRED → izin OS tidak ada.
• SYSTEM_RUN_DENIED: approval required → persetujuan exec tertunda.
• SYSTEM_RUN_DENIED: allowlist miss → perintah diblokir oleh allowlist.

Terkait:

• Persetujuan exec
• Pemecahan masalah Node
• Node

Alat browser gagal

Gunakan ini saat tindakan alat browser gagal meskipun gateway itu sendiri sehat.

openclaw browser statusopenclaw browser start --browser-profile openclawopenclaw browser profilesopenclaw logs --followopenclaw doctor

Cari:

• Apakah plugins.allow diatur dan menyertakan browser.
• Path executable browser yang valid.
• Keterjangkauan profil CDP.
• Ketersediaan Chrome lokal untuk profil existing-session / user.

Terkait:

• Browser (dikelola OpenClaw)
• Pemecahan masalah browser

Jika Anda memutakhirkan dan sesuatu tiba-tiba rusak

Sebagian besar kerusakan pascapemutakhiran adalah drift konfigurasi atau default yang lebih ketat yang kini diberlakukan.

openclaw gateway statusopenclaw config get gateway.modeopenclaw config get gateway.remote.urlopenclaw config get gateway.auth.mode

openclaw config get gateway.bindopenclaw config get gateway.auth.modeopenclaw config get gateway.auth.tokenopenclaw gateway statusopenclaw logs --follow

openclaw devices listopenclaw pairing list --channel <channel> [--account <id>]openclaw logs --followopenclaw doctor

Jika konfigurasi layanan dan runtime masih tidak cocok setelah pemeriksaan, instal ulang metadata layanan dari direktori profil/status yang sama:

openclaw gateway install --forceopenclaw gateway restart

Terkait:

• Autentikasi
• Exec latar belakang dan alat proses
• Pairing milik Gateway

Terkait

• Doctor
• FAQ
• Runbook Gateway