Asosiy tarkibga o'tish

​
Gateway nosozliklarini bartaraf etish

This page is the deep runbook. Start at /help/troubleshooting if you want the fast triage flow first.

​
Buyruqlar ketma-ketligi

Avval quyidagilarni, aynan shu tartibda ishga tushiring: 
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Kutilayotgan sogʻlom holat belgilar:
  • openclaw gateway status Runtime: running va RPC probe: ok holatini koʻrsatadi.
  • openclaw doctor konfiguratsiya/xizmat bilan bogʻliq toʻsib qoʻyuvchi muammolar yoʻqligini bildiradi.
  • openclaw channels status --probe ulangan/tayyor kanallarni koʻrsatadi.

​
No replies

If channels are up but nothing answers, check routing and policy before reconnecting anything. 
openclaw status
openclaw channels status --probe
openclaw pairing list <channel>
openclaw config get channels
openclaw logs --follow
Look for:
    1. DM yuboruvchilar uchun juftlash kutilmoqda.
    1. Guruh eslatmasini cheklash (requireMention, mentionPatterns).
    1. Kanal/guruh ruxsat ro‘yxati nomuvofiqliklari.
  1. Keng tarqalgan belgilar:
    1. drop guild message (mention required → eslatma bo‘lmaguncha guruh xabari e’tiborsiz qoldiriladi.
    1. pairing request → yuboruvchi tasdiqlanishi kerak.
    1. blocked / allowlist → yuboruvchi/kanal siyosat bo‘yicha filtrlangan.
  1. Bog‘liq:

​
12. Boshqaruv paneli boshqaruv UI ulanishi

  1. Boshqaruv paneli/boshqaruv UI ulanmasa, URL, autentifikatsiya rejimi va xavfsiz kontekst taxminlarini tekshiring.
14. openclaw shlyuzi holati
Look for:
  • openclaw logs —follow
  • openclaw doctor
  • openclaw gateway status —json
  1. Qidiring:
    1. To‘g‘ri probe URL va boshqaruv paneli URL.
    1. Mijoz va shlyuz o‘rtasida autentifikatsiya rejimi/token nomuvofiqligi.
    1. Qurilma identifikatori talab qilinadigan joyda HTTP’dan foydalanish.
  1. Keng tarqalgan belgilar:

​
23. Bog‘liq:

  1. /web/control-ui
25. [/gateway/authentication](/gateway/authentication)
Look for:
    1. Shlyuz xizmati ishga tushmagan
    1. Xizmat o‘rnatilgan, lekin jarayon ishlashda qolmasa, shundan foydalaning.
  • openclaw gateway status
openclaw status
  • Gateway start blocked: set gateway.mode=local → local gateway rejimi yoqilmagan. Tuzatish: konfiguratsiyangizda gateway.mode="local" ni o‘rnating (yoki openclaw configure ni ishga tushiring). Agar OpenClaw’ni maxsus openclaw foydalanuvchisi orqali Podman bilan ishga tushirayotgan bo‘lsangiz, konfiguratsiya ~openclaw/.openclaw/openclaw.json manzilida joylashgan.
  • openclaw doctor openclaw gateway status —deep
    1. Qidiring:
  1. Runtime: stopped va chiqish bo‘yicha maslahatlar.

​
35. Gateway start blocked: set gateway.mode=local → lokal shlyuz rejimi yoqilmagan.

  1. `refusing to bind gateway …
37. without auth` → token/parolsiz loopback bo‘lmagan bind.
Look for:
  1. /gateway/doctor
  • mention required → guruh eslatish siyosati sababli xabar e’tiborsiz qoldiriladi.
  • pairing / tasdiqlash kutilayotgan izlar → yuboruvchi tasdiqlanmagan.
  • missing_scope, not_in_channel, Forbidden, 401/403 → kanal autentifikatsiyasi/ruxsatlari muammosi.
Bog‘liq:

​
Cron va heartbeat yetkazib berilishi

Agar cron yoki heartbeat ishga tushmagan yoki yetkazilmagan bo‘lsa, avval rejalashtiruvchi holatini, so‘ng yetkazib berish manzilini tekshiring. 
openclaw cron holati
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw system heartbeat last
openclaw logs --follow
Look for:
  • Cron yoqilgan va keyingi uyg‘onish vaqti mavjud.
  • Ish bajarilish tarixi holati (ok, skipped, error).
  • Heartbeat o‘tkazib yuborish sabablari (quiet-hours, requests-in-flight, alerts-disabled).
Keng tarqalgan belgilar:
  • cron: scheduler disabled; jobs will not run automatically → cron o‘chirilgan.
  • cron: timer tick failed → rejalashtiruvchi tik muvaffaqiyatsiz; fayl/log/runtime xatolarini tekshiring.
  • heartbeat skipped va reason=quiet-hours → faol soatlar oynasidan tashqarida.
  • heartbeat: unknown accountId → heartbeat yetkazib berish manzili uchun yaroqsiz accountId.
Bog‘liq:

​
Ulangan tugun vositasi ishlamaydi

Tugun ulangan bo‘lsa-yu, vositalar ishlamasa, oldingi rejim, ruxsat va tasdiqlash holatini ajrating. 
openclaw nodes holati
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
openclaw status
Look for:
  • Tugun kutilgan imkoniyatlar bilan onlayn.
  • Kamera/mikrofon/joylashuv/ekran uchun OS ruxsatlari berilgan.
  • Exec tasdiqlashlari va allowlist holati.
Keng tarqalgan belgilar:
  • NODE_BACKGROUND_UNAVAILABLE → tugun ilovasi oldingi rejimda bo‘lishi kerak.
  • *_PERMISSION_REQUIRED / LOCATION_PERMISSION_REQUIRED → OS ruxsati yetishmaydi.
  • SYSTEM_RUN_DENIED: approval required → exec tasdiqlashi kutilmoqda.
  • SYSTEM_RUN_DENIED: allowlist miss → buyruq allowlist tomonidan bloklangan.
Bog‘liq:

​
Brauzer vositasi ishlamaydi

Gateway sog‘lom bo‘lsa ham brauzer vositasi amallari muvaffaqiyatsiz bo‘lganda foydalaning. 
openclaw browser holati
openclaw browser start --browser-profile openclaw
openclaw browser profiles
openclaw logs --follow
openclaw doctor
Look for:
  • Yaroqli brauzer bajariluvchi fayli yo‘li.
  • CDP profili yetib borilishi.
  • profile="chrome" uchun kengaytma relay yorlig‘i biriktirilgan.
Keng tarqalgan belgilar:
  • Failed to start Chrome CDP on port → brauzer jarayoni ishga tushmadi.
  • browser.executablePath not found → sozlangan yo‘l yaroqsiz.
  • Chrome extension relay is running, but no tab is connected → kengaytma relesi ulangan emas.
  • Browser attachOnly is enabled ... not reachable` → faqat ulash (attach-only) profili uchun yetib boriladigan maqsad yo‘q.
Bog‘liq:

​
Agar yangilashdan keyin birdan nimadir buzilib qolgan bo‘lsa

Yangilashdan keyingi ko‘p nosozliklar konfiguratsiya siljishi yoki endi qat’iyroq sukut bo‘yicha sozlamalar qo‘llanilayotganidan kelib chiqadi.

​
1. Autentifikatsiya va URLni almashtirish xatti-harakati o‘zgardi

openclaw gateway holati
openclaw config get gateway.mode
openclaw config get gateway.remote.url
openclaw config get gateway.auth.mode
Nimani tekshirish kerak:
  • Agar gateway.mode=remote bo‘lsa, CLI chaqiruvlari masofaviy manzilga yo‘naltirilayotgan bo‘lishi mumkin, lokal xizmatingiz esa sog‘lom bo‘lsa ham.
  • Aniq --url bilan qilingan chaqiruvlar saqlangan hisob ma’lumotlariga qaytmaydi.
Keng tarqalgan belgilar:
  • gateway connect failed: → noto‘g‘ri URL manzili.
  • unauthorized → endpoint yetib boriladi, ammo autentifikatsiya noto‘g‘ri.

​
2. Bind va autentifikatsiya himoya cheklovlari qat’iylashdi

openclaw config get gateway.bind
openclaw config get gateway.auth.token
openclaw gateway status
openclaw logs --follow
Nimani tekshirish kerak:
  • Loopback bo‘lmagan bindlar (lan, tailnet, custom) uchun autentifikatsiya sozlangan bo‘lishi kerak.
  • gateway.token kabi eski kalitlar gateway.auth.tokenni almashtirmaydi.
Keng tarqalgan belgilar:
  • refusing to bind gateway ... without auth → bind + auth mos kelmasligi.
  • RPC probe: failed runtime ishlayotgan paytda → gateway tirik, ammo joriy auth/url bilan kirish imkonsiz.

​
3. Juftlash va qurilma identifikatsiyasi holati o‘zgardi

openclaw devices list
openclaw pairing list <channel>
openclaw logs --follow
openclaw doctor
Nimani tekshirish kerak:
  • Dashboard/nodlar uchun kutilayotgan qurilma tasdiqlashlari.
  • Siyosat yoki identifikatsiya o‘zgarishlaridan keyin kutilayotgan DM juftlash tasdiqlashlari.
Keng tarqalgan belgilar:
  • device identity required → qurilma autentifikatsiyasi qondirilmagan.
  • pairing required → jo‘natuvchi/qurilma tasdiqlanishi kerak.
Tekshiruvlardan keyin ham xizmat konfiguratsiyasi va runtime kelishmasa, bir xil profil/holat katalogidan xizmat metama’lumotlarini qayta o‘rnating: 
openclaw gateway install --force
openclaw gateway restart
Bog‘liq: