English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

CLI commands

الجلسات

openclaw sessions

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

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

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

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

bash
openclaw sessionsopenclaw sessions --agent workopenclaw sessions --all-agentsopenclaw sessions --active 120openclaw sessions --limit 25openclaw sessions --verboseopenclaw sessions --json

اختيار النطاق:

  • الافتراضي: مخزن الوكيل الافتراضي المكوّن
  • --verbose: تسجيل مفصل
  • --agent <id>: مخزن وكيل مكوّن واحد
  • --all-agents: تجميع كل مخازن الوكلاء المكوّنة
  • --store <path>: مسار مخزن صريح (لا يمكن دمجه مع --agent أو --all-agents)
  • --limit <n|all>: الحد الأقصى للصفوف المراد إخراجها (الافتراضي 100؛ يعيد all الإخراج الكامل)

تتبّع تقدم المسار النصي القابل للقراءة للجلسات المخزنة:

bash
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 أحداث JSONL الأخيرة للمسار كسطور تقدم مضغوطة. من دون --session-key، يتتبّع الجلسات الجارية أولاً، ثم أحدث جلسة مخزنة. يتحكم --tail <count> في عدد الأحداث الموجودة التي تُطبع قبل وضع المتابعة؛ الافتراضي هو 80، و0 يبدأ من النهاية الحالية. يبقي --follow مراقبة ملفات المسار المحددة، بما في ذلك الملفات المنقولة المشار إليها بواسطة <session>.trajectory-path.json.

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

صدّر حزمة مسار لجلسة مخزنة:

bash
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 بعد أن يوافق المالك على طلب exec. يُحل دليل الإخراج دائماً داخل .openclaw/trajectory-exports/ ضمن مساحة العمل المحددة.

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

أمثلة JSON:

openclaw sessions --all-agents --json:

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": "gpt-5" },    { "agentId": "work", "key": "agent:work:main", "model": "claude-opus-4-6" }  ]}

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

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

bash
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، الذي يديره cron.runLog.keepLines في إعداد Cron والمشروح في صيانة Cron.

  • يشذّب التنظيف أيضاً النصوص المنسوخة الأساسية غير المشار إليها، ونقاط تحقق Compaction، وملفات المسار الجانبية الأقدم من session.maintenance.pruneAfter؛ وتُحفظ الملفات التي ما زال sessions.json يشير إليها.

  • يبلّغ التنظيف عن تنظيف اختبارات تشغيل نموذج Gateway قصيرة العمر بشكل منفصل باسم modelRunPruned. يطابق هذا فقط المفاتيح الصريحة الصارمة بالشكل agent:*:explicit:model-run-<uuid>. مدة الاحتفاظ الثابتة هي 24h، لكنها مقيّدة بالضغط: فهي لا تزيل صفوف الاختبار القديمة إلا عند بلوغ ضغط صيانة/حد إدخالات الجلسات. عندما يعمل، يحدث تنظيف تشغيل النموذج قبل التنظيف العام للقديم وقبل التحديد بالسقف.

  • --dry-run: معاينة عدد الإدخالات التي ستُشذّب/تُقيّد بالسقف من دون كتابة.

    • في وضع النص، يطبع dry-run جدول إجراءات لكل جلسة (Action وKey وAge وModel وFlags) إضافة إلى ملخص مجمّع حسب تسمية الجلسة حتى تتمكن من رؤية ما سيُحفظ مقابل ما سيُزال.

  • --enforce: طبّق الصيانة حتى عندما يكون session.maintenance.mode هو warn.

  • --fix-missing: أزل الإدخالات التي تكون ملفات نصوصها المنسوخة مفقودة أو تحتوي على ترويسة فقط/فارغة، حتى إن لم تكن ستخرج عادةً بسبب العمر/العدد بعد.

  • --fix-dm-scope: عندما يكون session.dmScope هو main، قم بإحالة صفوف direct-DM القديمة المفتاحية بالنظير إلى التقاعد والتي خلّفتها توجيهات per-peer أو per-channel-peer أو per-account-channel-peer السابقة. استخدم --dry-run أولاً؛ يؤدي تطبيق التنظيف إلى إزالة تلك الصفوف من sessions.json ويحفظ نصوصها المنسوخة كأرشيفات محذوفة.

  • --active-key <key>: احم مفتاحاً نشطاً محدداً من الإخلاء بسبب ميزانية القرص. تُبقي صيانة العمر/العدد/ميزانية القرص أيضاً مؤشرات المحادثة الخارجية الدائمة، مثل جلسات المجموعات وجلسات الدردشة محددة الخيط.

  • --agent <id>: شغّل التنظيف لمخزن وكيل مكوّن واحد.

  • --all-agents: شغّل التنظيف لكل مخازن الوكلاء المكوّنة.

  • --store <path>: شغّل على ملف sessions.json محدد.

  • --json: اطبع ملخص JSON. مع --all-agents، يتضمن الإخراج ملخصاً واحداً لكل مخزن.

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

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

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> هو الغلاف الأساسي حول Gateway RPC sessions.compact ويتطلب Gateway قيد التشغيل.

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

يخرج الأمر برمز غير صفري عندما يبلّغ Gateway عن فشل Compaction أو يكون غير قابل للوصول، حتى لا تخلط Crons والسكربتات أبداً بين عدم تنفيذ صامت ونجاح.

ملاحظة: openclaw agent --message '/compact ...' ليس مسار Compaction. تُرفض أوامر الشرطة المائلة من CLI بواسطة فحص المرسل المخوّل؛ ويخرج هذا الاستدعاء برمز غير صفري مع إرشاد يشير إلى هنا بدلاً من عدم التنفيذ بصمت.

sessions.compact RPC

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

الحقل النوع مطلوب الوصف
key string نعم مفتاح الجلسة المراد ضغطها (مثلاً agent:main:main).
agentId string لا معرّف الوكيل الذي يملك الجلسة (لمفاتيح global).
maxLines integer ≥ 1 لا اقتطع إلى آخر N أسطر بدلاً من تلخيص LLM.

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

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

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

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

ذو صلة

Was this useful?
On this page

On this page