Asosiy tarkibga o'tish

​
Nosozliklarni aniqlash

Bu sahifa oqimli chiqishlar uchun nosozliklarni aniqlash yordamchilarini qamrab oladi, ayniqsa provayder reasoning’ni oddiy matn bilan aralashtirganda.

​
Runtime uchun debug override’lar

Chatda faqat runtime uchun (xotirada, diskda emas) konfiguratsiya override’larini o‘rnatish uchun /debugdan foydalaning. /debug sukut bo‘yicha o‘chirilgan; commands.debug: true bilan yoqing. Bu openclaw.json faylini tahrirlashsiz, kamdan‑kam ishlatiladigan sozlamalarni yoqib‑o‘chirish kerak bo‘lganda qulay. Misollar: 
/debug show
/debug set messages.responsePrefix="[openclaw]"
/debug unset messages.responsePrefix
/debug reset
/debug reset barcha override’larni tozalaydi va diskdagi konfiguratsiyaga qaytaradi.

​
Gateway kuzatuv (watch) rejimi

Tezkor iteratsiya uchun gateway’ni fayl kuzatuvchi ostida ishga tushiring: 
pnpm gateway:watch --force
Bu quyidagiga mos keladi: 
tsx watch src/entry.ts gateway --force
gateway:watch dan keyin istalgan gateway CLI flag’larini qo‘shing — ular har bir qayta ishga tushishda uzatiladi.

​
Dev profili + dev gateway (—dev)

Holatni izolyatsiya qilish va xatolarni tuzatish uchun xavfsiz, vaqtinchalik muhit yaratish maqsadida dev profilidan foydalaning. Ikki ta --dev flag mavjud:
  • Global --dev (profil): holatni ~/.openclaw-dev ostida izolyatsiya qiladi va gateway portini sukut bo‘yicha 19001 ga o‘rnatadi (undan kelib chiqqan portlar ham mos ravishda siljiydi).
  • gateway --dev: Gateway’ga konfiguratsiya + workspace yo‘q bo‘lsa avtomatik yaratishni aytadi (va BOOTSTRAP.md’ni o‘tkazib yuboradi).
Tavsiya etilgan oqim (dev profil + dev bootstrap): 
pnpm gateway:dev
OPENCLAW_PROFILE=dev openclaw tui
Agar hali global o‘rnatma bo‘lmasa, CLI’ni pnpm openclaw ... orqali ishga tushiring. Bu nima qiladi:
  1. Profil izolyatsiyasi (global --dev)
    • OPENCLAW_PROFILE=dev
    • OPENCLAW_STATE_DIR=~/.openclaw-dev
    • OPENCLAW_CONFIG_PATH=~/.openclaw-dev/openclaw.json
    • OPENCLAW_GATEWAY_PORT=19001 (brauzer/canvas ham mos ravishda siljiydi)
  2. Dev bootstrap (gateway --dev)
    • Agar yo‘q bo‘lsa minimal konfiguratsiyani yozadi (gateway.mode=local, loopback’ga bind).
    • agent.workspace ni dev workspace’ga o‘rnatadi.
    • agent.skipBootstrap=true qilib belgilaydi (BOOTSTRAP.md yo‘q).
    • Agar yo‘q bo‘lsa workspace fayllarini yaratadi: AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md.
    • Sukut bo‘yicha identifikatsiya: C3‑PO (protokol droidi).
    • Dev rejimida kanal provayderlarini o‘tkazib yuboradi (OPENCLAW_SKIP_CHANNELS=1).
Qayta boshlash oqimi (toza start): 
pnpm gateway:dev:reset
Eslatma: --dev global profil flag’i bo‘lib, ayrim runner’lar uni yutib yuboradi. Agar aniq ko‘rsatish kerak bo‘lsa, muhit o‘zgaruvchisi shaklidan foydalaning: 
OPENCLAW_PROFILE=dev openclaw gateway --dev --reset
--reset konfiguratsiya, credential’lar, sessiyalar va dev workspace’ni ( rm emas, trash orqali) tozalaydi, so‘ng sukutdagi dev sozlamasini qayta yaratadi. Maslahat: agar dev bo‘lmagan gateway allaqachon ishlayotgan bo‘lsa (launchd/systemd), avval uni to‘xtating: 
openclaw gateway stop

​
Xom oqim (raw stream) loglash (OpenClaw)

OpenClaw har qanday filtrlash/formatlashdan oldin assistant’ning xom oqimini loglashi mumkin. Bu reasoning’ning oddiy matn delta’lari sifatida kelayotganini (yoki alohida thinking bloklari sifatida) ko‘rishning eng yaxshi usuli. CLI orqali yoqing: 
pnpm gateway:watch --force --raw-stream
Ixtiyoriy yo‘lni almashtirish: 
pnpm gateway:watch --force --raw-stream --raw-stream-path ~/.openclaw/logs/raw-stream.jsonl
Mos keluvchi env o‘zgaruvchilar: 
OPENCLAW_RAW_STREAM=1
OPENCLAW_RAW_STREAM_PATH=~/.openclaw/logs/raw-stream.jsonl
Sukut bo‘yicha fayl: ~/.openclaw/logs/raw-stream.jsonl

​
Raw chunk logging (pi-mono)

raw OpenAI-compat chunklar bloklarga ajratilishidan oldin ularni yozib olish uchun, pi-mono alohida logger taqdim etadi: 
PI_RAW_STREAM=1
Ixtiyoriy yo‘l: 
PI_RAW_STREAM_PATH=~/.pi-mono/logs/raw-openai-completions.jsonl
Standart fayl: ~/.pi-mono/logs/raw-openai-completions.jsonl
Eslatma: bu faqat pi-mono’ning openai-completions provayderidan foydalanadigan jarayonlar tomonidan chiqariladi.

​
Xavfsizlik bo‘yicha eslatmalar

  • Raw stream loglari to‘liq promptlar, asbob chiqishi va foydalanuvchi ma’lumotlarini o‘z ichiga olishi mumkin.
  • Loglarni lokal saqlang va debuggingdan keyin o‘chiring.
  • Agar loglarni ulashsangiz, avval maxfiy kalitlar va PII ma’lumotlarini tozalang.