​

Sessiyalarni Boshqarish & Kompaktatsiya (Chuqur Tahlil)

• Sessiya marshrutizatsiyasi (kiruvchi xabarlar sessionKey ga qanday moslanadi)
• Sessiya ombori (sessions.json) va u nimalarni kuzatadi
• Transkriptni saqlash (*.jsonl) va uning tuzilmasi
• Transkript gigiyenasi (ishga tushirishdan oldin provayderga xos tuzatishlar)
• Kontekst cheklovlari (kontekst oynasi va kuzatiladigan tokenlar)
• Kompaktatsiya (qo‘lda + avto-kompaktatsiya) va pre-kompaktatsiya ishlarini qayerga ulash mumkinligi
• Yashirin xizmat ishlari (masalan, foydalanuvchiga ko‘rinmas chiqishsiz xotira yozuvlari)

• /concepts/session
• /concepts/compaction
• /concepts/session-pruning
• /reference/transcript-hygiene

​

Haqiqat manbai: Gateway

• UI’lar (macOS ilovasi, veb Control UI, TUI) sessiyalar ro‘yxati va token hisoblari uchun Gateway’dan so‘rov yuborishi kerak.
• Masofaviy rejimda sessiya fayllari masofaviy xostda bo‘ladi; “lokal Mac fayllarini tekshirish” Gateway foydalanayotgan ma’lumotni aks ettirmaydi.

​

Ikki saqlash qatlami

1. Sessiya ombori (sessions.json)
   • Kalit/qiymat xaritasi: sessionKey -> SessionEntry
   • Kichik, o‘zgaruvchan, tahrirlash (yoki yozuvlarni o‘chirish) xavfsiz
   • Sessiya metama’lumotlarini kuzatadi (joriy sessiya identifikatori, oxirgi faollik, toggle’lar, token hisoblagichlari va h.k.)
2. Transkript (<sessionId>.jsonl)
   • Daraxt tuzilmasiga ega append-only transkript (id + parentId)
   • Haqiqiy suhbat + tool chaqiruvlari + kompaktatsiya xulosalarini saqlaydi
   • Keyingi turn’lar uchun model kontekstini qayta tiklashda ishlatiladi

​

Diskdagi joylashuv

• Ombor: ~/.openclaw/agents/<agentId>/sessions/sessions.json
• Transkriptlar: ~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl
  • Telegram mavzu sessiyalari: .../<sessionId>-topic-<threadId>.jsonl

​

Sessiya kalitlari (sessionKey)

• Asosiy/to‘g‘ridan-to‘g‘ri chat (har bir agent uchun): agent:<agentId>:<mainKey> (standart main)
• Guruh: agent:<agentId>:<channel>:group:<id>
• Xona/kanal (Discord/Slack): agent:<agentId>:<channel>:channel:<id> yoki ...:room:<id>
• Cron: cron:<job.id>
• Webhook: hook:<uuid> (agar alohida belgilanmagan bo‘lsa)

​

Sessiya identifikatorlari (sessionId)

• Reset (/new, /reset) ushbu sessionKey uchun yangi sessionId yaratadi.
• Kundalik reset (standart: Gateway xostining lokal vaqti bilan 4:00) reset chegarasidan keyingi birinchi xabarda yangi sessionId yaratadi.
• Idle expiry (session.reset.idleMinutes or legacy session.idleMinutes) creates a new sessionId when a message arrives after the idle window. When daily + idle are both configured, whichever expires first wins.

​

Sessiya ombori sxemasi (sessions.json)

• sessionId: joriy transkript identifikatori (agar sessionFile o‘rnatilmagan bo‘lsa, fayl nomi shundan olinadi)
• updatedAt: oxirgi faollik vaqti
• sessionFile: ixtiyoriy aniq transkript yo‘li
• chatType: direct | group | room (UI va yuborish siyosati uchun)
• provider, subject, room, space, displayName: guruh/kanal yorlig‘i uchun metama’lumot
• Toggle’lar:
  • thinkingLevel, verboseLevel, reasoningLevel, elevatedLevel
  • sendPolicy (sessiya darajasida override)
• Model tanlash:
  • providerOverride, modelOverride, authProfileOverride
• Token hisoblagichlari (eng yaxshi taxmin / provayderga bog‘liq):
  • inputTokens, outputTokens, totalTokens, contextTokens
• compactionCount: ushbu sessiya kaliti uchun avto-kompaktatsiya nechta bajarilgan
• memoryFlushAt: oxirgi pre-kompaktatsiya memory flush vaqti
• memoryFlushCompactionCount: oxirgi flush qaysi kompaktatsiya sonida bajarilgan

​

Transkript tuzilmasi (*.jsonl)

• Birinchi qatorda: sessiya sarlavhasi (type: "session", id, cwd, timestamp, ixtiyoriy parentSession)
• Keyin: id + parentId ga ega sessiya yozuvlari (daraxt)

• message: user/assistant/toolResult xabarlari
• custom_message: kengaytma kiritgan va model kontekstiga kiradigan xabarlar (UI’da yashirilishi mumkin)
• custom: model kontekstiga kirmaydigan kengaytma holati
• compaction: firstKeptEntryId va tokensBefore bilan saqlangan kompaktatsiya xulosasi
• branch_summary: daraxt shoxobchasida navigatsiya qilinganda saqlanadigan xulosa

​

Kontekst oynasi va kuzatiladigan tokenlar

1. Model kontekst oynasi: model uchun qat’iy limit (model ko‘ra oladigan tokenlar soni)
2. Sessiya ombori hisoblagichlari: sessions.json ga yoziladigan aylanma statistika ( /status va dashboard’lar uchun)

• Kontekst oynasi model katalogidan olinadi (va config orqali override qilinishi mumkin).
• Ombordagi contextTokens — ish vaqtidagi taxmin/hisobot qiymati; uni qat’iy kafolat deb qabul qilmang.

​

Kompaktatsiya: bu nima

• Kompaktatsiya xulosasi
• firstKeptEntryId dan keyingi xabarlar

​

Avto-kompaktatsiya qachon sodir bo‘ladi (Pi runtime)

1. Overflow tiklash: model kontekst overflow xatosini qaytaradi → kompaktatsiya → qayta urinish.
2. Threshold nazorati: muvaffaqiyatli turn’dan keyin, quyidagi shart bajarilganda:

• contextWindow — modelning kontekst oynasi
• reserveTokens — promptlar + keyingi model javobi uchun ajratilgan zahira

​

Kompaktatsiya sozlamalari (reserveTokens, keepRecentTokens)

{
  compaction: {
    enabled: true,
    reserveTokens: 16384,
    keepRecentTokens: 20000,
  },
}

• Agar compaction.reserveTokens < reserveTokensFloor bo‘lsa, OpenClaw uni oshiradi.
• Standart minimum: 20000 token.
• Minimumni o‘chirish uchun: agents.defaults.compaction.reserveTokensFloor: 0.
• Agar allaqachon yuqori bo‘lsa, OpenClaw o‘zgartirmaydi.

​

Foydalanuvchiga ko‘rinadigan joylar

• /status (har qanday chat sessiyasida)
• openclaw status (CLI)
• openclaw sessions / sessions --json
• Verbose rejim: 🧹 Auto-compaction complete + kompaktatsiya soni

​

Yashirin xizmat turn’lari (NO_REPLY)

• Assistant chiqishini NO_REPLY bilan boshlaydi — bu “foydalanuvchiga javob yuborilmasin” degani.
• OpenClaw yetkazish qatlamida buni olib tashlaydi/yashiradi.

​

Pre-kompaktatsiya “memory flush” (joriy qilingan)

1. Sessiya kontekst foydalanishini kuzatish.
2. U “yumshoq threshold” (Pi kompaktatsiya threshold’idan past) dan oshganda, agentga jim “xotirani hozir yoz” direktivasini yuborish.
3. Foydalanuvchi hech narsa ko‘rmasligi uchun NO_REPLY dan foydalanish.

• enabled (standart: true)
• softThresholdTokens (standart: 4000)
• prompt (flush turn uchun user xabari)
• systemPrompt (flush turn uchun qo‘shimcha system prompt)

• Standart prompt/system prompt yetkazishni bostirish uchun NO_REPLY ko‘rsatmasini o‘z ichiga oladi.
• Flush har bir kompaktatsiya siklida bir marta ishlaydi (sessions.json da kuzatiladi).
• Flush faqat o‘rnatilgan Pi sessiyalari uchun ishlaydi (CLI backend’lar o‘tkazib yuboradi).
• Agar sessiya workspace’i faqat o‘qish rejimida bo‘lsa (workspaceAccess: "ro" yoki "none"), flush o‘tkazib yuboriladi.
• Workspace fayl tuzilmasi va yozish andozalari uchun Memory ga qarang.

​

Muammolarni bartaraf etish ro‘yxati

• Sessiya kaliti noto‘g‘rimi? /concepts/session dan boshlang va /status dagi sessionKey ni tasdiqlang.
• Saqlash (store) va transkript mos kelmayaptimi? openclaw status dan Gateway xosti va saqlash yo‘lini tasdiqlang.
• Siqish (compaction) haddan tashqari ko‘pmi? Tekshiring:
  • model kontekst oynasi (juda kichik emasmi)
  • kompaktatsiya sozlamalari (reserveTokens model oynasiga nisbatan juda yuqori bo‘lsa, erta kompaktatsiya bo‘lishi mumkin)
  • tool-result hajmi: session pruning’ni yoqing/moslang
• Jim navbatlar sizib chiqyaptimi? Javob NO_REPLY (aniq token) bilan boshlanishini va siz streaming bostirish tuzatishi kiritilgan buildda ekaningizni tasdiqlang.