openclaw sessions

اعرض جلسات المحادثة المخزنة.

قوائم الجلسات ليست فحوصات للتأكد من نشاط القناة/المزوّد. فهي تعرض صفوف المحادثات الدائمة من مخازن الجلسات. يمكن لقناة Discord أو Slack أو Telegram أو أي قناة أخرى هادئة إعادة الاتصال بنجاح من دون إنشاء صف جلسة جديد حتى تتم معالجة رسالة. استخدم openclaw channels status --probe، أو openclaw status --deep، أو openclaw health --verbose عندما تحتاج إلى اتصال مباشر بالقناة.

openclaw sessionsopenclaw sessions --agent workopenclaw sessions --all-agentsopenclaw sessions --active 120openclaw sessions --limit 25openclaw sessions --store ./tmp/sessions.jsonopenclaw sessions --json

العلامات:

يكون openclaw sessions واستدعاء RPC ‏sessions.list في Gateway محدودَين افتراضيًا حتى لا تستحوذ المخازن الكبيرة طويلة العمر على عملية CLI أو حلقة أحداث Gateway. يعيد CLI أحدث 100 جلسة افتراضيًا؛ مرّر --limit <n> لنافذة أصغر/أكبر أو --limit all عندما تحتاج عمدًا إلى المخزن الكامل. تتضمن استجابات JSON ‏totalCount وlimitApplied وhasMore عندما يحتاج المستدعون إلى إظهار وجود مزيد من الصفوف.

يمكن لعملاء RPC تمرير configuredAgentsOnly: true للإبقاء على مصدر الاكتشاف المدمج الواسع مع إعادة صفوف الوكلاء الموجودين حاليًا في الإعدادات فقط. تستخدم واجهة التحكم هذا الوضع افتراضيًا حتى لا تظهر مخازن الوكلاء المحذوفة أو الموجودة على القرص فقط مجددًا في عرض الجلسات.

يقرأ --all-agents مخازن الوكلاء المهيأة. اكتشاف جلسات Gateway وACP أوسع نطاقًا: فهو يتضمن أيضًا مخازن SQLite التي تُحل من جذور الوكلاء المهيأة أو جذر session.store ذي القالب. يجب أن تُحل مسارات المحدد القديمة داخل جذر الوكيل؛ وتُتخطى الروابط الرمزية والمسارات الواقعة خارج الجذر.

openclaw sessions --all-agents --json:

{  "path": null,  "stores": [    { "agentId": "main", "path": "/home/user/.openclaw/agents/main/sessions/sessions.json" },    { "agentId": "work", "path": "/home/user/.openclaw/agents/work/sessions/sessions.json" }  ],  "allAgents": true,  "count": 2,  "totalCount": 2,  "limitApplied": 100,  "hasMore": false,  "activeMinutes": null,  "sessions": [    { "agentId": "main", "key": "agent:main:main", "model": "openai/gpt-5.6-sol" },    { "agentId": "work", "key": "agent:work:main", "model": "anthropic/claude-sonnet-4-6" }  ]}

تتبّع تقدم المسار

openclaw sessions tailopenclaw sessions tail --followopenclaw sessions tail --session-key "agent:main:telegram:direct:123" --tail 25openclaw sessions --agent work tail --followopenclaw sessions --all-agents tail --follow

يعرض openclaw sessions tail أحداث مسار وقت التشغيل الحديثة كسطور تقدم موجزة. من دون --session-key، يتتبّع الجلسات قيد التشغيل أولًا، ثم أحدث جلسة مخزنة. يتحكم --tail <count> في عدد الأحداث الموجودة التي تُطبع قبل وضع المتابعة؛ الافتراضي 80، ويبدأ 0 من النهاية الحالية. يواصل --follow مراقبة الجلسة المحددة المدعومة بـSQLite أو ملف مسار قديم صريح.

عرض التقدم متحفظ عمدًا: لا يُطبع نص الموجّه، ولا وسائط الأدوات، ولا محتويات نتائج الأدوات. تعرض استدعاءات الأدوات اسم الأداة مع {...redacted...}؛ وتعرض نتائج الأدوات حالة مثل ok، أو error، أو done؛ وتعرض سطور إكمال النموذج المزوّد/النموذج والحالة النهائية.

تصدير حزمة مسار

openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --workspace .openclaw sessions export-trajectory --session-key "agent:main:telegram:direct:123" --output bug-123 --json

هذا هو مسار الأمر الذي يستخدمه أمر الشرطة المائلة /export-trajectory بعد موافقة المالك على طلب التنفيذ. يُحل دليل المخرجات دائمًا داخل .openclaw/trajectory-exports/ ضمن مساحة العمل المحددة.

صيانة التنظيف

شغّل الصيانة الآن بدلًا من انتظار دورة الكتابة التالية:

openclaw sessions cleanup --dry-runopenclaw sessions cleanup --agent work --dry-runopenclaw sessions cleanup --all-agents --dry-runopenclaw sessions cleanup --enforceopenclaw sessions cleanup --enforce --active-key "agent:main:telegram:direct:123"openclaw sessions cleanup --dry-run --fix-dm-scopeopenclaw sessions cleanup --json

يستخدم openclaw sessions cleanup إعدادات session.maintenance من الإعدادات (مرجع الإعدادات):

• ملاحظة النطاق: يصون openclaw sessions cleanup مخازن الجلسات، والنصوص المنسوخة، وصفوف المسارات، والملفات الجانبية القديمة للمسارات. ولا يحذف سجل تشغيل Cron، الذي يحتفظ تلقائيًا بأحدث 2000 صف لكل مهمة (إعداد Cron).
• يحذف التنظيف أيضًا عناصر النصوص المنسوخة القديمة/المؤرشفة غير المُشار إليها، ونقاط تحقق Compaction، والملفات الجانبية للمسارات الأقدم من session.maintenance.pruneAfter؛ وتُحفظ العناصر التي لا تزال صفوف جلسات SQLite تشير إليها.
• يُبلغ التنظيف بصورة منفصلة عن تنظيف عمليات فحص تشغيل نموذج Gateway قصيرة العمر باسم modelRunPruned. لا يطابق هذا إلا المفاتيح الصريحة الصارمة ذات الشكل agent:*:explicit:model-run-<uuid>. مدة الاحتفاظ ثابتة عند 24h وهي مرتبطة بالضغط: لا تزيل صفوف الفحص القديمة إلا عند بلوغ ضغط صيانة/حد إدخالات الجلسات. وعند تشغيلها، يحدث تنظيف تشغيل النموذج قبل التنظيف العام للبيانات القديمة وفرض الحد الأقصى.

العلامات:

عندما يمكن الوصول إلى Gateway، يُرسل التنظيف غير التجريبي لمخازن الوكلاء المهيأة عبر Gateway كي يستخدم كاتب مخزن الجلسات نفسه الذي تستخدمه حركة وقت التشغيل. استخدم --store <path> للإصلاح الصريح دون اتصال لمحدد مخزن قديم.

openclaw sessions cleanup --all-agents --dry-run --json:

{  "allAgents": true,  "mode": "warn",  "dryRun": true,  "stores": [    {      "agentId": "main",      "storePath": "/home/user/.openclaw/agents/main/sessions/sessions.json",      "beforeCount": 120,      "afterCount": 80,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 40,      "capped": 0    },    {      "agentId": "work",      "storePath": "/home/user/.openclaw/agents/work/sessions/sessions.json",      "beforeCount": 18,      "afterCount": 18,      "missing": 0,      "dmScopeRetired": 0,      "pruned": 0,      "capped": 0    }  ]}

ضغط جلسة

استعد ميزانية السياق لجلسة عالقة أو مفرطة الحجم. يُعد openclaw sessions compact <key> الغلاف الأساسي حول استدعاء RPC ‏sessions.compact في Gateway ويتطلب Gateway قيد التشغيل.

openclaw sessions compact "agent:main:main"openclaw sessions compact "agent:main:main" --max-lines 200openclaw sessions compact "agent:work:main" --agent work --json

• من دون --max-lines، يلخّص نموذج اللغة الكبير في Gateway النص المنسوخ. لا يفرض CLI مهلة نهائية للعميل افتراضيًا؛ إذ يدير Gateway دورة حياة Compaction المهيأة.
• مع --max-lines <n>، يقتطع النص المنسوخ إلى آخر n سطرًا ويؤرشف النص المنسوخ السابق كملف جانبي .bak.
• --agent <id>: الوكيل الذي يملك الجلسة؛ مطلوب لمفاتيح global.
• --url / --token / --password: تجاوزات اتصال Gateway.
• --timeout <ms>: مهلة اختيارية لاستدعاء RPC من جانب العميل بالمللي ثانية.
• --json: اطبع حمولة RPC الأولية.

يخرج الأمر برمز غير صفري عندما يُبلغ Gateway عن فشل Compaction أو يتعذر الوصول إليه، لذا لا تعتبر مهام Cron والبرامج النصية أبدًا أن عدم تنفيذ أي إجراء بصمت نجاحًا.

استدعاء RPC ‏sessions.compact

يقبل openclaw gateway call sessions.compact --params '<json>' ما يلي:

مثال على استجابة التلخيص باستخدام LLM:

{  "ok": true,  "key": "agent:main:main",  "compacted": true,  "result": { "tokensBefore": 243868, "tokensAfter": 34941 }}

مثال على استجابة الاقتطاع (--max-lines 200):

{  "ok": true,  "key": "agent:main:main",  "compacted": true,  "archived": "/home/user/.openclaw/agents/main/sessions/transcripts/<id>.jsonl.bak",  "kept": 200}

ذو صلة

• إعداد الجلسة
• إدارة الجلسات
• Compaction
• مرجع CLI