--- read_when: - Anda ingin mencantumkan sesi yang tersimpan dan melihat aktivitas terbaru summary: Referensi CLI untuk `openclaw sessions` (daftar sesi tersimpan + penggunaan) title: Sesi x-i18n: generated_at: "2026-07-04T20:43:24Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 7c24ee8a632998624ee41945b26ace3bfe37cadf9447f7632c373784a9301bde source_path: cli/sessions.md workflow: 16 --- # `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 ` 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. ```bash openclaw sessions openclaw sessions --agent work openclaw sessions --all-agents openclaw sessions --active 120 openclaw sessions --limit 25 openclaw sessions --verbose openclaw sessions --json ``` Pemilihan cakupan: - default: penyimpanan agen default yang dikonfigurasi - `--verbose`: pencatatan log verbose - `--agent `: satu penyimpanan agen yang dikonfigurasi - `--all-agents`: agregasikan semua penyimpanan agen yang dikonfigurasi - `--store `: jalur penyimpanan eksplisit (tidak dapat digabungkan dengan `--agent` atau `--all-agents`) - `--limit `: jumlah baris maksimum untuk dikeluarkan (default `100`; `all` memulihkan keluaran penuh) Pantau progres trajektori yang mudah dibaca manusia untuk sesi tersimpan: ```bash openclaw sessions tail openclaw sessions tail --follow openclaw sessions tail --session-key "agent:main:telegram:direct:123" --tail 25 openclaw sessions --agent work tail --follow openclaw 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 ` 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 `.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: ```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 ``` 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`: ```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): ```bash 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` 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](/id/automation/cron-jobs#configuration) dan dijelaskan di [Pemeliharaan Cron](/id/automation/cron-jobs#maintenance). - 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-`. 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 `: 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 `: jalankan pembersihan untuk satu penyimpanan agen yang dikonfigurasi. - `--all-agents`: jalankan pembersihan untuk semua penyimpanan agen yang dikonfigurasi. - `--store `: 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 ` untuk perbaikan offline eksplisit pada file penyimpanan. `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 } ] } ``` ## Padatkan sesi Rebut kembali anggaran konteks untuk sesi yang macet atau terlalu besar. `openclaw sessions compact ` adalah wrapper kelas utama di sekitar RPC gateway `sessions.compact` dan memerlukan gateway yang berjalan. ```bash openclaw sessions compact "agent:main:main" openclaw sessions compact "agent:main:main" --max-lines 200 openclaw 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 `, perintah ini memotong ke `n` baris transkrip terakhir dan mengarsipkan transkrip sebelumnya sebagai sidecar `.bak`. - `--agent `: agen yang memiliki sesi; wajib untuk key `global`. - `--url` / `--token` / `--password`: override koneksi gateway. - `--timeout `: 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 ''` menerima: | Bidang | Tipe | Wajib | Deskripsi | | ---------- | ----------- | ----- | ---------------------------------------------------------- | | `key` | string | ya | Key sesi untuk dipadatkan (misalnya `agent:main:main`). | | `agentId` | string | tidak | Id agen yang memiliki sesi (untuk key `global`). | | `maxLines` | integer ≥ 1 | tidak | Potong ke N baris terakhir alih-alih ringkasan LLM. | Contoh respons ringkasan LLM: ```json { "ok": true, "key": "agent:main:main", "compacted": true, "result": { "tokensBefore": 243868, "tokensAfter": 34941 } } ``` Contoh respons pemotongan (`--max-lines 200`): ```json { "ok": true, "key": "agent:main:main", "compacted": true, "archived": "/home/user/.openclaw/agents/main/sessions/transcripts/.jsonl.bak", "kept": 200 } ``` ## Terkait - Konfigurasi sesi: [Referensi konfigurasi](/id/gateway/config-agents#session) - [Referensi CLI](/id/cli) - [Manajemen sesi](/id/concepts/session)