Chuyển đến nội dung chính

​
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 <n> để 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. 
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 <id>: một kho agent đã cấu hình
  • --all-agents: tổng hợp tất cả kho agent đã cấu hình
  • --store <path>: đường dẫn kho rõ ràng (không thể kết hợp với --agent hoặc --all-agents)
  • --limit <n|all>: 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: 
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 <count> 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 <session>.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: 
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: 
{
  "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): 
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 và được giải thích trong Bảo trì Cron.
  • 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-<uuid>. 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 <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 <id>: 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 <path>: 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 <path> để sửa chữa ngoại tuyến rõ ràng một tệp kho. 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
    }
  ]
}

​
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 <key> là trình bao bọc hạng nhất quanh RPC Gateway sessions.compact và yêu cầu Gateway đang chạy. 
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 <n>, 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 <id>: 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 <ms>: 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 '<json>' chấp nhận:
TrườngKiểuBắt buộcMô tả
keystringcóKhóa phiên cần Compaction (ví dụ agent:main:main).
agentIdstringkhôngID agent sở hữu phiên (cho các khóa global).
maxLinesinteger ≥ 1khôngCắ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: 
{
  "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): 
{
  "ok": true,
  "key": "agent:main:main",
  "compacted": true,
  "archived": "/home/user/.openclaw/agents/main/sessions/transcripts/<id>.jsonl.bak",
  "kept": 200
}

​
Liên quan