Skip to main content

​
Gateway service runbook

Last updated: 2025-12-09

Deep troubleshooting

Alomatlardan boshlanadigan diagnostika aniq buyruqlar ketma-ketligi va log imzolari bilan.

Configuration

Vazifaga yo‘naltirilgan o‘rnatish qo‘llanmasi + to‘liq konfiguratsiya ma’lumotnomasi.

​
5 daqiqalik lokal ishga tushirish

1

Start the Gateway

2

Verify service health

Sog‘lom asosiy holat: Runtime: running va RPC probe: ok.
3

Validate channel readiness

Gateway konfiguratsiyasini qayta yuklash faol konfiguratsiya fayli yo‘lini kuzatadi (profil/state sukut bo‘yicha qiymatlaridan aniqlanadi yoki OPENCLAW_CONFIG_PATH o‘rnatilgan bo‘lsa, o‘shandan olinadi). Sukut bo‘yicha rejim gateway.reload.mode="hybrid".

​
Runtime modeli

  • Marshrutlash, boshqaruv tekisligi va kanal ulanishlari uchun doimiy ishlaydigan bitta jarayon.
  • Quyidagilar uchun yagona multiplekslangan port:
    • WebSocket boshqaruvi/RPC
    • HTTP API’lar (OpenAI-mos, Responses, tools invoke)
    • Boshqaruv UI va hook’lar
  • Sukut bo‘yicha bind rejimi: loopback.
  • Sukut bo‘yicha autentifikatsiya talab qilinadi (gateway.auth.token / gateway.auth.password yoki OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD).

​
Dev profili (--dev)

​
Hot reload rejimlari

​
Operator buyruqlari to‘plami

​
Remote access

Tavsiya etiladi: Tailscale/VPN. Zaxira usul: SSH tunnel.
Service install per profile:
Agar gateway auth sozlangan bo‘lsa, mijozlar hatto SSH tunnel orqali ham auth (token/password) yuborishi shart.
Qarang: Remote Gateway, Authentication, Tailscale.

​
Nazorat va xizmat hayotiy sikli

Ishlab chiqarish muhitiga yaqin ishonchlilik uchun supervised ishga tushirishdan foydalaning.
LaunchAgent yorliqlari ai.openclaw.gateway (standart) yoki ai.openclaw.<profile> (nomlangan profil). openclaw doctor xizmat konfiguratsiyasidagi tafovutlarni tekshiradi va tuzatadi.

​
Bitta hostda bir nechta gateway

Ko‘pchilik sozlamalarda bitta Gateway ishga tushirilishi kerak. Bir nechta gateway’dan faqat qat’iy izolyatsiya/yaxlitlik (masalan, qutqaruv profili) uchun foydalaning. Checklist per instance:
  • Noyob gateway.port
  • Noyob OPENCLAW_CONFIG_PATH
  • Noyob OPENCLAW_STATE_DIR
  • Noyob agents.defaults.workspace
Example:
Qarang: Multiple gateways.

​
Gateway service management (CLI)

Standart sozlamalar izolyatsiyalangan state/config va asosiy gateway porti 19001 ni o‘z ichiga oladi.

​
Protocol bo‘yicha qisqa ma’lumot (operator ko‘rinishi)

  • gateway status probes the Gateway RPC by default using the service’s resolved port/config (override with --url).
  • gateway status --deep adds system-level scans (LaunchDaemons/system units).
  • gateway status --no-probe skips the RPC probe (useful when networking is down).
  • gateway status --json is stable for scripts.
Bundled mac app:
  1. Darhol qabul qilingan tasdiq (status:"accepted")
  2. To stop it cleanly, use openclaw gateway stop (or launchctl bootout gui/$UID/bot.molt.gateway).
To‘liq protocol hujjatlari: Gateway Protocol.

​
Operational checks

​
Liveness

  • WS oching va connect yuboring.
  • Snapshot bilan hello-ok javobini kuting.

​
Readiness

​
Uzilishdan tiklanish

Events are not replayed. Ketma-ketlikda uzilishlar bo‘lsa, davom etishdan oldin holatni yangilang (health, system-presence).

​
Keng tarqalgan nosozlik belgilari

To‘liq diagnostika bosqichlari uchun Gateway Troubleshooting dan foydalaning.

​
Windows (WSL2)

  • Gateway protokoli clientlari Gateway mavjud bo‘lmaganda darhol xatolik qaytaradi (to‘g‘ridan-to‘g‘ri kanalga avtomatik o‘tish yo‘q).
  • Yaroqsiz/birinchi ulanishga tegishli bo‘lmagan freymlar rad etiladi va yopiladi.
  • Socket yopilishidan oldin muloyim yopilish shutdown hodisasini chiqaradi.
Bog‘liq: