openclaw sessions

جلسه‌های گفت‌وگوی ذخیره‌شده را فهرست می‌کند.

فهرست‌های جلسه، بررسی زنده‌بودن کانال/ارائه‌دهنده نیستند. آن‌ها ردیف‌های گفت‌وگوی ماندگارشده از ذخیره‌گاه‌های جلسه را نشان می‌دهند. یک کانال ساکت Discord، Slack، Telegram یا کانال دیگر می‌تواند بدون ایجاد ردیف جلسه جدید، با موفقیت دوباره متصل شود تا زمانی که پیامی پردازش شود. وقتی به اتصال زنده کانال نیاز دارید، از openclaw channels status --probe، openclaw status --deep، یا openclaw health --verbose استفاده کنید.

پاسخ‌های openclaw sessions و Gateway sessions.list به‌طور پیش‌فرض محدود هستند تا ذخیره‌گاه‌های بزرگ و طولانی‌عمر نتوانند فرایند CLI یا حلقه رویداد Gateway را در انحصار بگیرند. CLI به‌طور پیش‌فرض ۱۰۰ جلسه جدیدتر را برمی‌گرداند؛ برای یک پنجره کوچک‌تر/بزرگ‌تر --limit <n> را بدهید، یا وقتی عمداً به کل ذخیره‌گاه نیاز دارید از --limit all استفاده کنید. پاسخ‌های JSON شامل totalCount، limitApplied و hasMore هستند، برای زمانی که فراخوان‌ها باید نشان دهند ردیف‌های بیشتری وجود دارد.

کلاینت‌های RPC می‌توانند configuredAgentsOnly: true را بدهند تا منبع کشف ترکیبی گسترده حفظ شود، اما فقط ردیف‌های عامل‌هایی برگردد که اکنون در پیکربندی حضور دارند. Control UI به‌طور پیش‌فرض از آن حالت استفاده می‌کند تا ذخیره‌گاه‌های عامل حذف‌شده یا فقط-دیسکی دوباره در نمای جلسه‌ها ظاهر نشوند.

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 خروجی کامل را برمی‌گرداند)

پیشرفت مسیر قابل‌خواندن برای انسان را برای جلسه‌های ذخیره‌شده دنبال کنید:

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 را نشان می‌دهند؛ خطوط تکمیل مدل، ارائه‌دهنده/مدل و وضعیت پایانی را نشان می‌دهند.

یک بسته مسیر برای یک جلسه ذخیره‌شده صادر کنید:

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/ زیر فضای کاری انتخاب‌شده resolve می‌شود.

openclaw sessions --all-agents ذخیره‌گاه‌های عامل پیکربندی‌شده را می‌خواند. کشف جلسه در Gateway و ACP گسترده‌تر است: آن‌ها ذخیره‌گاه‌های فقط-دیسکی را نیز شامل می‌شوند که زیر ریشه پیش‌فرض agents/ یا یک ریشه قالب‌دار session.store پیدا شده‌اند. آن ذخیره‌گاه‌های کشف‌شده باید به فایل‌های عادی sessions.json داخل ریشه عامل resolve شوند؛ symlinkها و مسیرهای بیرون از ریشه نادیده گرفته می‌شوند.

نمونه‌های JSON:

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

نگهداری پاک‌سازی

نگهداری را اکنون اجرا کنید (به‌جای انتظار برای چرخه نوشتن بعدی):

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 ذخیره‌گاه‌های جلسه، transcriptها و sidecarهای مسیر را نگهداری می‌کند. این فرمان تاریخچه اجرای cron را هرس نمی‌کند؛ آن تاریخچه توسط cron.runLog.keepLines در پیکربندی Cron مدیریت می‌شود و در نگهداری Cron توضیح داده شده است.

• پاک‌سازی همچنین transcriptهای اصلی بدون ارجاع، checkpointهای Compaction، و sidecarهای مسیر قدیمی‌تر از 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: ورودی‌هایی را حذف می‌کند که فایل‌های transcript آن‌ها گم شده یا فقط دارای سربرگ/خالی هستند، حتی اگر معمولاً هنوز به‌دلیل سن/تعداد حذف نمی‌شدند.

• --fix-dm-scope: وقتی session.dmScope برابر main است، ردیف‌های direct-DM کهنه مبتنی بر کلید همتا را که از مسیریابی‌های قبلی per-peer، per-channel-peer یا per-account-channel-peer باقی مانده‌اند بازنشسته می‌کند. ابتدا از --dry-run استفاده کنید؛ اعمال پاک‌سازی آن ردیف‌ها را از sessions.json حذف می‌کند و transcriptهایشان را به‌عنوان آرشیوهای حذف‌شده حفظ می‌کند.

• --active-key <key>: یک کلید فعال مشخص را از بیرون‌رانی بودجه دیسک محافظت می‌کند. اشاره‌گرهای گفت‌وگوی خارجی بادوام، مانند جلسه‌های گروهی و جلسه‌های چت محدود به thread، نیز توسط نگهداری مبتنی بر سن/تعداد/بودجه دیسک نگه داشته می‌شوند.

• --agent <id>: پاک‌سازی را برای یک ذخیره‌گاه عامل پیکربندی‌شده اجرا می‌کند.

• --all-agents: پاک‌سازی را برای همه ذخیره‌گاه‌های عامل پیکربندی‌شده اجرا می‌کند.

• --store <path>: روی یک فایل sessions.json مشخص اجرا می‌شود.

• --json: یک خلاصه JSON چاپ می‌کند. با --all-agents، خروجی شامل یک خلاصه برای هر ذخیره‌گاه است.

وقتی یک Gateway در دسترس باشد، پاک‌سازی غیر-dry-run برای ذخیره‌گاه‌های عامل پیکربندی‌شده از طریق 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    }  ]}

فشرده‌سازی یک جلسه

بودجه context را برای یک جلسه گیرکرده یا بیش‌ازحد بزرگ بازیابی کنید. 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 با LLM transcript را خلاصه می‌کند. CLI به‌طور پیش‌فرض ضرب‌الاجل کلاینت اعمال نمی‌کند؛ Gateway مالک چرخه عمر Compaction پیکربندی‌شده است.
• با --max-lines <n>، به آخرین n خط transcript کوتاه می‌کند و transcript قبلی را به‌عنوان یک sidecar با پسوند .bak آرشیو می‌کند.
• --agent <id>: عاملی که مالک جلسه است؛ برای کلیدهای global الزامی است.
• --url / --token / --password: بازنویسی‌های اتصال Gateway.
• --timeout <ms>: مهلت اختیاری RPC سمت کلاینت بر حسب میلی‌ثانیه.
• --json: payload خام RPC را چاپ می‌کند.

وقتی Gateway یک Compaction ناموفق گزارش کند یا در دسترس نباشد، فرمان با وضعیت غیرصفر خارج می‌شود؛ بنابراین cronها و اسکریپت‌ها هرگز یک no-op خاموش را با موفقیت اشتباه نمی‌گیرند.

نکته: openclaw agent --message '/compact ...' مسیر Compaction نیست. دستورهای اسلش از CLI توسط بررسی فرستنده مجاز رد می‌شوند؛ آن فراخوانی با وضعیت غیرصفر خارج می‌شود و به‌جای no-op خاموش، راهنمایی‌ای ارائه می‌کند که به اینجا اشاره دارد.

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}

مرتبط

• پیکربندی جلسه: مرجع پیکربندی
• مرجع CLI
• مدیریت جلسه