openclaw sessions

Cantumkan sesi percakapan yang tersimpan.

Daftar sesi bukan pemeriksaan keaktifan channel/provider. Daftar ini menampilkan baris percakapan yang dipersistenkan dari penyimpanan sesi. Discord, Slack, Telegram, atau channel lain yang senyap dapat tersambung ulang dengan sukses tanpa membuat baris sesi baru hingga sebuah pesan diproses. Gunakan openclaw channels status --probe, openclaw status --deep, atau openclaw health --verbose ketika Anda memerlukan konektivitas channel langsung.

Respons openclaw sessions dan Gateway sessions.list dibatasi secara default agar penyimpanan besar yang berumur panjang tidak memonopoli proses CLI atau event loop Gateway. CLI mengembalikan 100 sesi terbaru secara default; teruskan --limit <n> untuk jendela yang lebih kecil/besar atau --limit all ketika Anda sengaja memerlukan seluruh penyimpanan. Respons JSON menyertakan totalCount, limitApplied, dan hasMore ketika pemanggil perlu menunjukkan bahwa masih ada baris lain.

Klien RPC dapat meneruskan configuredAgentsOnly: true untuk mempertahankan sumber penemuan gabungan yang luas tetapi hanya mengembalikan baris untuk agen yang saat ini ada di konfigurasi. Control UI menggunakan mode itu secara default agar penyimpanan agen yang dihapus atau hanya ada di disk tidak muncul kembali di tampilan Sessions.

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

Pemilihan cakupan:

• default: penyimpanan agen default yang dikonfigurasi
• --verbose: pencatatan log verbose
• --agent <id>: satu penyimpanan agen yang dikonfigurasi
• --all-agents: agregasikan semua penyimpanan agen yang dikonfigurasi
• --store <path>: jalur penyimpanan eksplisit (tidak dapat digabungkan dengan --agent atau --all-agents)
• --limit <n|all>: jumlah baris maksimum untuk dikeluarkan (default 100; all memulihkan keluaran penuh)

Pantau progres trajektori yang mudah dibaca manusia untuk sesi tersimpan:

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 merender peristiwa JSONL trajektori terbaru sebagai baris progres ringkas. Tanpa --session-key, perintah ini memantau sesi yang sedang berjalan terlebih dahulu, lalu sesi tersimpan terbaru. --tail <count> mengontrol berapa banyak peristiwa yang sudah ada dicetak sebelum mode ikuti; defaultnya 80, dan 0 dimulai di akhir saat ini. --follow terus memantau file trajektori yang dipilih, termasuk file yang dipindahkan yang dirujuk oleh <session>.trajectory-path.json.

Tampilan progres sengaja dibuat konservatif: teks prompt, argumen tool, dan isi hasil tool tidak dicetak. Panggilan tool menampilkan nama tool dengan {...redacted...}; hasil tool menampilkan status seperti ok, error, atau done; baris penyelesaian model menampilkan provider/model dan status terminal.

Ekspor bundle trajektori untuk sesi tersimpan:

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

Ini adalah jalur perintah yang digunakan oleh perintah slash /export-trajectory setelah pemilik menyetujui permintaan exec. Direktori keluaran selalu di-resolve di dalam .openclaw/trajectory-exports/ di bawah workspace yang dipilih.

openclaw sessions --all-agents membaca penyimpanan agen yang dikonfigurasi. Penemuan sesi Gateway dan ACP lebih luas: keduanya juga menyertakan penyimpanan yang hanya ada di disk yang ditemukan di bawah root agents/ default atau root session.store bertemplat. Penyimpanan yang ditemukan tersebut harus di-resolve ke file sessions.json reguler di dalam root agen; symlink dan jalur di luar root dilewati.

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

Pemeliharaan pembersihan

Jalankan pemeliharaan sekarang (alih-alih menunggu siklus tulis berikutnya):

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 menggunakan pengaturan session.maintenance dari konfigurasi:

• Catatan cakupan: openclaw sessions cleanup memelihara penyimpanan sesi, transkrip, dan sidecar trajektori. Perintah ini tidak memangkas riwayat eksekusi cron, yang dikelola oleh cron.runLog.keepLines di Konfigurasi Cron dan dijelaskan di Pemeliharaan Cron.

• Pembersihan juga memangkas transkrip primer yang tidak direferensikan, checkpoint Compaction, dan sidecar trajektori yang lebih lama dari session.maintenance.pruneAfter; file yang masih direferensikan oleh sessions.json dipertahankan.

• Pembersihan melaporkan pembersihan probe model-run gateway berumur pendek secara terpisah sebagai modelRunPruned. Ini hanya cocok dengan key eksplisit ketat berbentuk seperti agent:*:explicit:model-run-<uuid>. Retensi tetapnya adalah 24h, tetapi dibatasi tekanan: ini hanya menghapus baris probe basi ketika pemeliharaan entri sesi/tekanan batas tercapai. Ketika berjalan, pembersihan model-run terjadi sebelum pembersihan basi global dan pembatasan.

• --dry-run: pratinjau berapa banyak entri yang akan dipangkas/dibatasi tanpa menulis.

  • Dalam mode teks, dry-run mencetak tabel tindakan per sesi (Action, Key, Age, Model, Flags) ditambah ringkasan yang dikelompokkan menurut label sesi sehingga Anda dapat melihat apa yang akan dipertahankan vs dihapus.

• --enforce: terapkan pemeliharaan bahkan ketika session.maintenance.mode adalah warn.

• --fix-missing: hapus entri yang file transkripnya hilang atau hanya header/kosong, meskipun entri tersebut biasanya belum memenuhi usia/jumlah untuk dikeluarkan.

• --fix-dm-scope: ketika session.dmScope adalah main, pensiunkan baris direct-DM berkunci peer yang basi yang tertinggal dari routing per-peer, per-channel-peer, atau per-account-channel-peer sebelumnya. Gunakan --dry-run terlebih dahulu; menerapkan pembersihan menghapus baris tersebut dari sessions.json dan mempertahankan transkripnya sebagai arsip terhapus.

• --active-key <key>: lindungi key aktif tertentu dari penggusuran anggaran disk. Penunjuk percakapan eksternal yang tahan lama, seperti sesi grup dan sesi chat bercakupan thread, juga dipertahankan oleh pemeliharaan usia/jumlah/anggaran disk.

• --agent <id>: jalankan pembersihan untuk satu penyimpanan agen yang dikonfigurasi.

• --all-agents: jalankan pembersihan untuk semua penyimpanan agen yang dikonfigurasi.

• --store <path>: jalankan terhadap file sessions.json tertentu.

• --json: cetak ringkasan JSON. Dengan --all-agents, keluaran menyertakan satu ringkasan per penyimpanan.

Ketika Gateway dapat dijangkau, pembersihan non-dry-run untuk penyimpanan agen yang dikonfigurasi dikirim melalui Gateway sehingga berbagi penulis penyimpanan sesi yang sama dengan traffic runtime. Gunakan --store <path> untuk perbaikan offline eksplisit pada file penyimpanan.

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

Padatkan sesi

Rebut kembali anggaran konteks untuk sesi yang macet atau terlalu besar. openclaw sessions compact <key> adalah wrapper kelas utama di sekitar RPC gateway sessions.compact dan memerlukan gateway yang berjalan.

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

• Tanpa --max-lines, gateway LLM-meringkas transkrip. CLI tidak memberlakukan deadline klien secara default; gateway memiliki siklus hidup compaction yang dikonfigurasi.
• Dengan --max-lines <n>, perintah ini memotong ke n baris transkrip terakhir dan mengarsipkan transkrip sebelumnya sebagai sidecar .bak.
• --agent <id>: agen yang memiliki sesi; wajib untuk key global.
• --url / --token / --password: override koneksi gateway.
• --timeout <ms>: timeout RPC sisi klien opsional dalam milidetik.
• --json: cetak payload RPC mentah.

Perintah keluar non-nol ketika gateway melaporkan compaction gagal atau tidak dapat dijangkau, sehingga cron dan skrip tidak pernah keliru menganggap no-op senyap sebagai keberhasilan.

Catatan: openclaw agent --message '/compact ...' bukan jalur compaction. Perintah slash dari CLI ditolak oleh pemeriksaan pengirim berwenang; invokasi itu keluar non-nol dengan panduan yang menunjuk ke sini alih-alih diam-diam no-op.

RPC sessions.compact

openclaw gateway call sessions.compact --params '<json>' menerima:

Contoh respons ringkasan LLM:

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

Contoh respons pemotongan (--max-lines 200):

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

Terkait

• Konfigurasi sesi: Referensi konfigurasi
• Referensi CLI
• Manajemen sesi