> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Phiên làm việc # `openclaw sessions` Liệt kê các phiên hội thoại đã lưu. Danh sách phiên không phải là kiểm tra trạng thái hoạt động của kênh/nhà cung cấp. Chúng hiển thị các hàng hội thoại được lưu bền vững từ kho phiên. Một kênh Discord, Slack, Telegram hoặc kênh khác đang yên lặng có thể kết nối lại thành công mà không tạo hàng phiên mới cho đến khi một tin nhắn được xử lý. Dùng `openclaw channels status --probe`, `openclaw status --deep`, hoặc `openclaw health --verbose` khi bạn cần kết nối kênh trực tiếp. Phản hồi `openclaw sessions` và Gateway `sessions.list` được giới hạn theo mặc định để các kho lớn tồn tại lâu không thể chiếm độc quyền tiến trình CLI hoặc vòng lặp sự kiện Gateway. CLI trả về 100 phiên mới nhất theo mặc định; truyền `--limit ` để có cửa sổ nhỏ/lớn hơn hoặc `--limit all` khi bạn chủ ý cần toàn bộ kho. Phản hồi JSON bao gồm `totalCount`, `limitApplied`, và `hasMore` khi bên gọi cần hiển thị rằng còn nhiều hàng hơn. Máy khách RPC có thể truyền `configuredAgentsOnly: true` để giữ nguồn khám phá kết hợp rộng nhưng chỉ trả về các hàng cho agent hiện có trong cấu hình. Control UI dùng chế độ đó theo mặc định để các kho agent đã xóa hoặc chỉ có trên đĩa không xuất hiện lại trong chế độ xem Sessions. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw sessions openclaw sessions --agent work openclaw sessions --all-agents openclaw sessions --active 120 openclaw sessions --limit 25 openclaw sessions --verbose openclaw sessions --json ``` Chọn phạm vi: * mặc định: kho agent mặc định đã cấu hình * `--verbose`: ghi nhật ký chi tiết * `--agent `: một kho agent đã cấu hình * `--all-agents`: tổng hợp tất cả kho agent đã cấu hình * `--store `: đường dẫn kho rõ ràng (không thể kết hợp với `--agent` hoặc `--all-agents`) * `--limit `: số hàng tối đa để xuất (mặc định `100`; `all` khôi phục đầu ra đầy đủ) Theo dõi tiến trình quỹ đạo dễ đọc cho các phiên đã lưu: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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` hiển thị các sự kiện JSONL quỹ đạo gần đây dưới dạng các dòng tiến trình gọn. Không có `--session-key`, lệnh này theo dõi các phiên đang chạy trước, rồi đến phiên đã lưu mới nhất. `--tail ` kiểm soát số sự kiện hiện có được in trước chế độ theo dõi; mặc định là `80`, và `0` bắt đầu tại điểm cuối hiện tại. `--follow` tiếp tục theo dõi các tệp quỹ đạo đã chọn, bao gồm các tệp đã được di chuyển được tham chiếu bởi `.trajectory-path.json`. Chế độ xem tiến trình cố ý thận trọng: văn bản prompt, đối số công cụ, và nội dung kết quả công cụ không được in. Lệnh gọi công cụ hiển thị tên công cụ với `{...redacted...}`; kết quả công cụ hiển thị trạng thái như `ok`, `error`, hoặc `done`; các dòng hoàn tất của mô hình hiển thị nhà cung cấp/mô hình và trạng thái kết thúc. Xuất một gói quỹ đạo cho phiên đã lưu: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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 ``` Đây là đường dẫn lệnh được lệnh slash `/export-trajectory` dùng sau khi chủ sở hữu phê duyệt yêu cầu thực thi. Thư mục đầu ra luôn được phân giải bên trong `.openclaw/trajectory-exports/` dưới workspace đã chọn. `openclaw sessions --all-agents` đọc các kho agent đã cấu hình. Khám phá phiên của Gateway và ACP rộng hơn: chúng cũng bao gồm các kho chỉ có trên đĩa được tìm thấy dưới gốc `agents/` mặc định hoặc gốc `session.store` theo mẫu. Các kho được khám phá đó phải phân giải thành các tệp `sessions.json` thông thường bên trong gốc agent; symlink và đường dẫn ngoài gốc bị bỏ qua. Ví dụ JSON: `openclaw sessions --all-agents --json`: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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" } ] } ``` ## Bảo trì dọn dẹp Chạy bảo trì ngay bây giờ (thay vì chờ chu kỳ ghi tiếp theo): ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} 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` dùng các thiết lập `session.maintenance` từ cấu hình: * Ghi chú phạm vi: `openclaw sessions cleanup` bảo trì kho phiên, bản ghi hội thoại, và sidecar quỹ đạo. Nó không cắt tỉa lịch sử chạy cron, vốn được quản lý bởi `cron.runLog.keepLines` trong [Cấu hình Cron](/vi/automation/cron-jobs#configuration) và được giải thích trong [Bảo trì Cron](/vi/automation/cron-jobs#maintenance). * Dọn dẹp cũng cắt tỉa các bản ghi hội thoại chính không được tham chiếu, checkpoint Compaction, và sidecar quỹ đạo cũ hơn `session.maintenance.pruneAfter`; các tệp vẫn được `sessions.json` tham chiếu sẽ được giữ lại. * Dọn dẹp báo cáo riêng việc dọn dẹp probe chạy mô hình Gateway tồn tại ngắn hạn dưới dạng `modelRunPruned`. Việc này chỉ khớp các khóa rõ ràng nghiêm ngặt có dạng `agent:*:explicit:model-run-`. Thời gian lưu giữ cố định là `24h`, nhưng được chặn theo áp lực: nó chỉ xóa các hàng probe cũ khi bảo trì mục phiên/áp lực giới hạn đạt ngưỡng. Khi chạy, dọn dẹp lượt chạy mô hình diễn ra trước dọn dẹp cũ toàn cục và áp giới hạn. * `--dry-run`: xem trước số mục sẽ bị cắt tỉa/giới hạn mà không ghi. * Ở chế độ văn bản, dry-run in bảng hành động theo từng phiên (`Action`, `Key`, `Age`, `Model`, `Flags`) cùng phần tóm tắt được nhóm theo nhãn phiên để bạn có thể thấy mục nào sẽ được giữ và mục nào sẽ bị xóa. * `--enforce`: áp dụng bảo trì ngay cả khi `session.maintenance.mode` là `warn`. * `--fix-missing`: xóa các mục có tệp bản ghi hội thoại bị thiếu hoặc chỉ có phần đầu/trống, ngay cả khi chúng thường chưa bị loại theo tuổi/số lượng. * `--fix-dm-scope`: khi `session.dmScope` là `main`, loại bỏ các hàng direct-DM theo khóa peer đã cũ do định tuyến `per-peer`, `per-channel-peer`, hoặc `per-account-channel-peer` trước đây để lại. Dùng `--dry-run` trước; việc áp dụng dọn dẹp sẽ xóa các hàng đó khỏi `sessions.json` và giữ bản ghi hội thoại của chúng dưới dạng lưu trữ đã xóa. * `--active-key `: bảo vệ một khóa đang hoạt động cụ thể khỏi bị loại do ngân sách đĩa. Các con trỏ hội thoại bên ngoài bền vững, như phiên nhóm và phiên trò chuyện theo phạm vi thread, cũng được bảo giữ bởi bảo trì theo tuổi/số lượng/ngân sách đĩa. * `--agent `: chạy dọn dẹp cho một kho agent đã cấu hình. * `--all-agents`: chạy dọn dẹp cho tất cả kho agent đã cấu hình. * `--store `: chạy trên một tệp `sessions.json` cụ thể. * `--json`: in phần tóm tắt JSON. Với `--all-agents`, đầu ra bao gồm một tóm tắt cho mỗi kho. Khi Gateway có thể truy cập, dọn dẹp không phải dry-run cho các kho agent đã cấu hình được gửi qua Gateway để dùng chung bộ ghi kho phiên giống như lưu lượng runtime. Dùng `--store ` để sửa chữa ngoại tuyến rõ ràng một tệp kho. `openclaw sessions cleanup --all-agents --dry-run --json`: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "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 } ] } ``` ## Compaction một phiên Thu hồi ngân sách ngữ cảnh cho một phiên bị kẹt hoặc quá lớn. `openclaw sessions compact ` là trình bao bọc hạng nhất quanh RPC Gateway `sessions.compact` và yêu cầu Gateway đang chạy. ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw sessions compact "agent:main:main" openclaw sessions compact "agent:main:main" --max-lines 200 openclaw sessions compact "agent:work:main" --agent work --json ``` * Không có `--max-lines`, Gateway dùng LLM để tóm tắt bản ghi hội thoại. CLI không áp đặt thời hạn phía máy khách theo mặc định; Gateway sở hữu vòng đời Compaction đã cấu hình. * Với `--max-lines `, lệnh cắt ngắn còn `n` dòng bản ghi hội thoại cuối cùng và lưu trữ bản ghi hội thoại trước đó dưới dạng sidecar `.bak`. * `--agent `: agent sở hữu phiên; bắt buộc cho các khóa `global`. * `--url` / `--token` / `--password`: ghi đè kết nối Gateway. * `--timeout `: thời gian chờ RPC tùy chọn phía máy khách, tính bằng mili giây. * `--json`: in payload RPC thô. Lệnh thoát khác 0 khi Gateway báo cáo Compaction thất bại hoặc không thể truy cập, để cron và script không bao giờ nhầm một no-op im lặng là thành công. > Lưu ý: `openclaw agent --message '/compact ...'` **không** phải là đường dẫn Compaction. Lệnh slash từ CLI bị kiểm tra người gửi được ủy quyền từ chối; lời gọi đó thoát khác 0 với hướng dẫn trỏ đến đây thay vì im lặng không làm gì. ### RPC sessions.compact `openclaw gateway call sessions.compact --params ''` chấp nhận: | Trường | Kiểu | Bắt buộc | Mô tả | | ---------- | ----------- | -------- | ---------------------------------------------------- | | `key` | string | có | Khóa phiên cần Compaction (ví dụ `agent:main:main`). | | `agentId` | string | không | ID agent sở hữu phiên (cho các khóa `global`). | | `maxLines` | integer ≥ 1 | không | Cắt ngắn còn N dòng cuối thay vì tóm tắt bằng LLM. | Ví dụ phản hồi tóm tắt bằng LLM: ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "ok": true, "key": "agent:main:main", "compacted": true, "result": { "tokensBefore": 243868, "tokensAfter": 34941 } } ``` Ví dụ phản hồi cắt ngắn (`--max-lines 200`): ```json theme={"theme":{"light":"min-light","dark":"min-dark"}} { "ok": true, "key": "agent:main:main", "compacted": true, "archived": "/home/user/.openclaw/agents/main/sessions/transcripts/.jsonl.bak", "kept": 200 } ``` ## Liên quan * Cấu hình phiên: [Tham chiếu cấu hình](/vi/gateway/config-agents#session) * [Tham chiếu CLI](/vi/cli) * [Quản lý phiên](/vi/concepts/session)