Hướng dẫn xoá và lưu trữ session bằng lệnh OpenClaw CLI

Để dọn session trong OpenClaw, dùng openclaw sessions archive "<session-key>" để cất session khỏi danh sách nhưng giữ lịch sử, hoặc openclaw sessions delete "<session-key>" để xoá hẳn. Lấy session key bằng openclaw sessions --json và luôn chạy thử với --dry-run trước.

Bài này thuộc nhóm cài đặt và vận hành OpenClaw trên VPS; nếu chưa rõ OpenClaw là gì, đọc OpenClaw là gì. Khi agent chạy lâu trên VPS, danh sách session tăng dần, làm giao diện rối và tốn chỗ lưu trữ; các lệnh CLI dưới đây xử lý ngay trên VPS.

Cập nhật 24/10/2026 theo tài liệu OpenClaw 2026.10.x. Ảnh chụp trên OpenClaw 2026.9.6; cú pháp lệnh không đổi.

Session trong OpenClaw là gì?

Session trong OpenClaw là một luồng hội thoại có khoá riêng giữa người dùng và một agent, lưu lịch sử trò chuyện (transcript) và trạng thái để tiếp tục về sau. Khái niệm session nói chung có ở bài session là gì.

Từ bản 2026.8.1, session và transcript lưu trong cơ sở dữ liệu SQLite của từng agent, mặc định tại:

~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite

Vì vậy không sửa tay tệp session như các bản cũ; hãy thao tác qua lệnh openclaw sessions hoặc Control UI. Ví dụ các session key:

agent:main:main
agent:main:scratch-1
agent:main:telegram:direct:123
agent:work:research

Mỗi chuỗi trên là một session key, thông tin bạn cần khi muốn archive hoặc xoá một phiên cụ thể.

Archive và Delete session OpenClaw khác nhau thế nào?

Archive cất session khỏi danh sách đang hoạt động nhưng giữ transcript; Delete xoá session khỏi Gateway cùng trạng thái liên quan. Hiểu khác biệt này trước khi chạy lệnh:

openclaw sessions archive đánh dấu session là archived, giữ transcript và đưa session ra khỏi danh sách mặc định. openclaw sessions delete xoá dòng session, các thế hệ transcript, trạng thái runtime, binding và dữ liệu vòng đời liên quan.

Khuyến nghị: nếu chỉ muốn danh sách gọn hơn, dùng Archive trước.

Cần chuẩn bị gì trước khi lưu trữ session OpenClaw?

Lệnh archive và delete session chạy thông qua Gateway, nên OpenClaw Gateway phải đang hoạt động. Nếu OpenClaw chạy trên VPS, SSH vào VPS bằng Xshell, Terminal hay công cụ quen thuộc rồi chạy lệnh trong terminal của VPS (xem SSH là gì).

Kiểm tra phiên bản OpenClaw:

openclaw --version

Nếu phiên bản quá cũ và không nhận lệnh sessions archive, nâng cấp trước bằng openclaw update; các bước an toàn có ở bài hướng dẫn nâng cấp OpenClaw.

Cách lưu trữ session bằng openclaw sessions archive

Bước 1: Xem danh sách session hiện có

openclaw sessions list

Bảng rút gọn session key dài. Để lấy key đầy đủ, tránh chép nhầm, dùng định dạng JSON:

openclaw sessions --json

Mặc định lệnh trả 100 session gần đây; thêm --limit all nếu cần toàn bộ.

Bước 2: Xác định session cần archive

Giả sử danh sách có session:

agent:main:cron:47154e4d-3bc3-49f7-864d-59eefdf5d1d1

Đây là session key dùng trong lệnh archive. Kiểm tra kỹ trước khi tiếp tục, đặc biệt khi VPS có nhiều agent hoặc nhiều session tên gần giống nhau.

Bước 3: Kiểm tra trước bằng –dry-run

openclaw sessions archive "agent:main:cron:47154e4d-3bc3-49f7-864d-59eefdf5d1d1" --dry-run

--dry-run kiểm session key và xem trước kết quả mà không đổi trạng thái session. Nên luôn làm bước này khi mới dùng OpenClaw CLI.

Nếu kết quả không báo lỗi, chuyển sang bước tiếp theo.

Bước 4: Archive session

openclaw sessions archive "agent:main:cron:47154e4d-3bc3-49f7-864d-59eefdf5d1d1"

Thành công, OpenClaw đánh dấu session là archived. Transcript vẫn giữ, nhưng session không còn trong danh sách Active mặc định.

Muốn nhận kết quả dạng JSON (cho script):

openclaw sessions archive "agent:main:scratch-1" --json

Kết quả thành công có dạng:

{ "ok": true, "operation": "archive", "dryRun": false, "results": [ { "key": "agent:main:scratch-1", "ok": true, "status": "archived" } ] }

Bước 5: Kiểm tra lại danh sách session

Mở OpenClaw Control UI, vào khu vực Sessions và chọn bộ lọc Archived để thấy phiên đã lưu trữ. Control UI cho xem lịch sử session archived và Unarchive khi muốn tiếp tục.

Cách archive nhiều session OpenClaw cùng lúc

OpenClaw nhận nhiều session key trong một lệnh:

openclaw sessions archive \
  "agent:main:scratch-1" \
  "agent:main:scratch-2"

Kiểm tra trước:

openclaw sessions archive \
  "agent:main:scratch-1" \
  "agent:main:scratch-2" \
  --dry-run

OpenClaw xử lý từng key và trả kết quả riêng cho từng phiên. Key không hợp lệ làm lệnh trả mã lỗi, nhưng các key hợp lệ còn lại vẫn được xử lý; key lặp chỉ xử lý một lần.

Cách xoá session OpenClaw bằng CLI

Khi chắc chắn không cần session nữa, dùng openclaw sessions delete. Ví dụ:

openclaw sessions delete "agent:main:cron:47154e4d-3bc3-49f7-864d-59eefdf5d1d1"

Trong terminal tương tác, OpenClaw hỏi xác nhận một lần trước khi xoá.

Bỏ qua bước xác nhận:

openclaw sessions delete "agent:main:scratch-1" --yes

Kết hợp JSON:

openclaw sessions delete "agent:main:scratch-1" --yes --json

Theo tài liệu, xoá ở chế độ không tương tác hoặc kèm --json bắt buộc có --yes; khi viết script xoá hàng loạt, chạy --dry-run trước (OpenClaw CLI: sessions). Sau khi xoá, kiểm tra lại:

openclaw sessions

Session vừa xoá không còn trong danh sách mặc định.

Xoá session có xoá toàn bộ memory không?

Không. Khi xoá một session thường, OpenClaw vẫn giữ transcript dưới dạng bản lưu có đuôi như sau, và bản lưu này có thể vẫn được tìm thấy qua memory search:

.jsonl.deleted.<timestamp>

Muốn gỡ cả phần memory đã lập chỉ mục từ session, chạy riêng lệnh memory forget trên máy chủ chạy Gateway:

openclaw memory forget --agent <agent-id> --session <id-or-key>

Ví dụ:

openclaw memory forget \
  --agent main \
  --session "agent:main:scratch-1"

Chọn đúng agent từng sở hữu session. Lệnh chạy cục bộ: xoá session qua --url tới Gateway từ xa không tự xoá memory bên đó (OpenClaw CLI: memory). Cách OpenClaw lưu trí nhớ có ở bài memory plugin OpenClaw. Tóm tắt:

Archive → ẩn khỏi danh sách hoạt động → giữ lịch sử
Delete  → xoá session và dữ liệu vòng đời → memory đã index cần xoá riêng

Cách khôi phục session đã archive

Archive nhầm thì không mất dữ liệu, vì transcript vẫn còn. Trên OpenClaw Control UI, mở khu vực Sessions, chuyển bộ lọc sang Archived hoặc All rồi tìm session cần khôi phục. Sau khi Unarchive, session trở lại danh sách hoạt động và bạn tiếp tục cuộc trò chuyện cũ. Control UI cũng có Undo ngay sau thao tác archive.

Với người mới, Control UI là cách đơn giản để khôi phục session đã archive.

Có nên thường xuyên xoá session OpenClaw?

Không cần xoá thường xuyên. Nếu chỉ muốn danh sách gọn, Archive hợp hơn Delete, và OpenClaw đã có cơ chế bảo trì session tự động theo cấu hình session.maintenance (pruneAfter, maxEntries…). Mặc định maxEntries là 5.000 session chưa archive; session đã archive không tính vào giới hạn này.

Xem trước việc dọn dẹp:

openclaw sessions cleanup --dry-run

Áp dụng ngay:

openclaw sessions cleanup --enforce

Với người mới, archive từng session không còn dùng vẫn dễ kiểm soát hơn. Trước khi dọn mạnh tay, nên sao lưu thư mục ~/.openclaw; cách tự động có ở bài tự động backup n8n và OpenClaw lên Google Drive.

Kết luận

Quản lý session giúp OpenClaw dễ dùng hơn khi agent chạy lâu trên VPS. Thay vì xoá ngay, dùng openclaw sessions archive để cất session cũ mà vẫn giữ lịch sử. Trước mỗi thao tác, chạy --dry-run, kiểm đúng session key và phân biệt Archive với Delete; khi cần gỡ cả trí nhớ, dùng thêm openclaw memory forget.

Muốn chạy OpenClaw 24/7 mà không tự cài? VPS OpenClaw của Tino cài sẵn OpenClaw trên VPS NVMe đặt tại Việt Nam; bạn vẫn có quyền root để cấu hình. Xem cấu hình và giá trên trang sản phẩm.

Bài viết liên quan:

• Hướng dẫn sửa lỗi Tool Loop trong OpenClaw
• Khái niệm cốt lõi trong OpenClaw
• Chuyển từ Cron cũ sang Automations trong OpenClaw
• Context window 1M cho Claude trên OpenClaw UI
• Lấy API Token Telegram để kết nối OpenClaw

Những câu hỏi thường gặp