Skip to main content

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:
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.
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.
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
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 …
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.
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.
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.
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

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

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

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:
Bog‘liq: