Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

openclaw sessions

openclaw sessions
openclaw sessions --agent work
openclaw sessions --all-agents
openclaw sessions --active 120
openclaw sessions --limit 25
openclaw sessions --verbose
openclaw sessions --json

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

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

{
  "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" }
  ]
}

​

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

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

• ملاحظة النطاق: يصون openclaw sessions cleanup مخازن الجلسات والنصوص الجانبية وملفات المسارات الجانبية. لا يقلّم سجلات تشغيل Cron (cron/runs/<jobId>.jsonl)، التي يديرها cron.runLog.maxBytes وcron.runLog.keepLines في تهيئة Cron والموضحة في صيانة Cron.
• يزيل التنظيف أيضاً النصوص الجانبية الأساسية غير المرجعية ونقاط تحقق Compaction وملفات المسارات الجانبية الأقدم من session.maintenance.pruneAfter؛ تُحفظ الملفات التي لا تزال مشاراً إليها في sessions.json.
• --dry-run: معاينة عدد الإدخالات التي ستُقلّم/تُحد دون كتابة.
  • في وضع النص، تطبع التجربة الجافة جدول إجراءات لكل جلسة (Action, Key, Age, Model, Flags) حتى تتمكن من رؤية ما سيُحتفظ به مقابل ما سيُزال.
• --enforce: تطبيق الصيانة حتى عندما يكون session.maintenance.mode هو warn.
• --fix-missing: إزالة الإدخالات التي تكون ملفات نصوصها الجانبية مفقودة، حتى لو لم تكن لتخرج عادةً بسبب العمر/العدد بعد.
• --fix-dm-scope: عندما يكون session.dmScope هو main، تخلص من صفوف الرسائل المباشرة القديمة ذات مفاتيح النظراء التي خلّفتها طرق توجيه 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، يتضمن الإخراج ملخصاً واحداً لكل مخزن.

{
  "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
    }
  ]
}

• تهيئة الجلسة: مرجع التهيئة

​

ذات صلة

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