openclaw sessions

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

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

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

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

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 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 شوند؛ پیوندهای نمادین و مسیرهای بیرون از ریشه رد می‌شوند.

نمونه‌های 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 ذخیره‌گاه‌های نشست، رونویسی‌ها و sidecarهای مسیر اجرا را نگهداری می‌کند. این فرمان گزارش‌های اجرای cron (cron/runs/<jobId>.jsonl) را هرس نمی‌کند؛ آن‌ها با cron.runLog.maxBytes و cron.runLog.keepLines در پیکربندی Cron مدیریت می‌شوند و در نگهداری Cron توضیح داده شده‌اند.

• پاک‌سازی همچنین رونویسی‌های اصلی ارجاع‌نشده، checkpointهای Compaction و sidecarهای مسیر اجرای قدیمی‌تر از 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 است، ردیف‌های direct-DM قدیمی با کلید همتا را که از مسیریابی‌های قبلی per-peer، per-channel-peer یا per-account-channel-peer باقی مانده‌اند بازنشسته کنید. ابتدا از --dry-run استفاده کنید؛ اعمال پاک‌سازی آن ردیف‌ها را از sessions.json حذف می‌کند و رونویسی‌های آن‌ها را به‌عنوان آرشیوهای حذف‌شده حفظ می‌کند.

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

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

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

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

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

وقتی 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    }  ]}

مرتبط:

• پیکربندی نشست: مرجع پیکربندی

مرتبط

• مرجع CLI
• مدیریت نشست