Hương dẫn xóa và lưu trữ session bằng lệnh Openclaw CLI

Khi làm việc lâu dài với trợ lý AI qua OpenClaw, danh sách các cuộc hội thoại (session) sẽ tăng lên theo thời gian, chiếm dung lượng lưu trữ và gây rối cho giao diện quản lý. Nhưng hãy yên tâm, OpenClaw hiện cung cấp các lệnh CLI riêng để lưu trữ hoặc xóa session ngay trên VPS. Cùng Tino tìm hiểu cách xóa và lưu trữ session bằng lệnh Openclaw CLI qua bài viết dưới đây nhé!

Session trong OpenClaw là gì?

Session có thể hiểu đơn giản là một phiên trò chuyện hoặc phiên làm việc riêng giữa người dùng và AI Agent.

Mỗi session lưu những thông tin liên quan đến cuộc trao đổi, chẳng hạn như lịch sử hội thoại, trạng thái phiên làm việc và một số dữ liệu phục vụ quá trình tiếp tục cuộc trò chuyện sau này.

Theo kiến trúc OpenClaw hiện tại, session và transcript được lưu trong cơ sở dữ liệu của từng Agent. Đường dẫn mặc định thường nằm trong khu vực: ~/.openclaw/agents/<agentId>/

Các phiên đã archive vẫn được OpenClaw giữ lại thay vì xóa ngay khỏi hệ thống.

Ví dụ, bạn có thể có các session như:

agent:main:main

agent:main:scratch-1

agent:main:scratch-2

agent:work:research

Trong đó, mỗi chuỗi phía trên được gọi là Session Key.

Session Key chính là thông tin bạn cần khi muốn archive hoặc xóa một phiên cụ thể.

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

Đây là điểm quan trọng nhất cần hiểu trước khi chạy bất kỳ lệnh nào.

Tóm lại, khi chạy:

openclaw sessions archive

OpenClaw đánh dấu session là archived, giữ transcript và loại phiên đó khỏi danh sách session hoạt động mặc định.

Ngược lại, với lệnh:

openclaw sessions delete

OpenClaw thực hiện quá trình xóa mạnh hơn, bao gồm session đang lưu, trạng thái runtime và nhiều dữ liệu vòng đời liên quan. Đây là thao tác cần cẩn thận hơn.

Khuyến nghị: Nếu chỉ muốn danh sách OpenClaw gọn hơn, hãy ưu tiên Archive trước.

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

Các lệnh archive và delete session hoạt động thông qua Gateway đang chạy. Vì vậy, OpenClaw Gateway cần hoạt động bình thường trước khi thực hiện thao tác.

Nếu đang sử dụng OpenClaw trên VPS, bạn có thể SSH vào VPS bằng Xshell, Terminal hoặc công cụ SSH quen thuộc.

Sau đó thực hiện toàn bộ câu lệnh trực tiếp trong Terminal của VPS.

Bạn cũng nên kiểm tra phiên bản OpenClaw:

openclaw --version

Nếu phiên bản quá cũ và không nhận diện được sessions archive, hãy cân nhắc nâng cấp OpenClaw trước bằng lênh:

openclaw update

Hương dẫn xóa và lưu trữ session bằng lệnh Openclaw CLI

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

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

Chạy:

openclaw sessions list

Nếu muốn xem thông tin chính xác hơn, đặc biệt khi Session Key dài, nên sử dụng:

openclaw sessions --json

Định dạng JSON giúp bạn lấy đầy đủ Session Key, tránh sao chép nhầm khi Terminal rút gọn phần hiển thị.

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 chính là Session Key cần sử dụng trong lệnh archive.

Bạn nên kiểm tra kỹ trước khi tiếp tục, đặc biệt khi VPS đang có nhiều Agent hoặc nhiều session có tên gần giống nhau.

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

Trước khi archive thật, nên sử dụng:

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

–dry-run cho phép OpenClaw kiểm tra Session Key và mô phỏng thao tác nhưng không thay đổi trạng thái session. Đây là bước rất nên thực hiện khi bạn mới làm quen với OpenClaw CLI.

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

Bước 4: Archive Session

Chạy:

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

Nếu thành công, OpenClaw sẽ đánh dấu session là archived. Transcript vẫn được giữ lại nhưng session sẽ không còn xuất hiện trong danh sách Active mặc định.

Nếu muốn nhận kết quả dưới dạng JSON, sử dụng:

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

Kết quả thành công thường thể hiện trạng thái tương tự:

{

  "ok": true,

  "operation": "archive"

}

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

Bạn có thể mở OpenClaw Control UI và xem khu vực Archived hoặc sử dụng bộ lọc session để tìm lại cuộc trò chuyện đã lưu trữ. OpenClaw Control UI hiện hỗ trợ mở lịch sử của session archived và thực hiện Unarchive khi muốn tiếp tục cuộc trò chuyện.

Cách Archive nhiều Session OpenClaw cùng lúc

OpenClaw cho phép truyền nhiều Session Key vào cùng một câu lệnh.

Ví dụ:

openclaw sessions archive \

"agent:main:xxx" \

"agent:main:xxx"

Bạn cũng nên kiểm tra trước:

openclaw sessions archive \

"agent:main:xxx" \

"agent:main:xxx" \

--dry-run

OpenClaw sẽ xử lý từng Session Key và trả kết quả riêng cho từng phiên. Nếu một Session Key không hợp lệ, các key hợp lệ còn lại vẫn có thể được xử lý.

Cách xóa Session OpenClaw bằng CLI

Nếu chắc chắn không còn cần session, OpenClaw cung cấp lệnh:

openclaw sessions delete

Ví dụ:

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

Trong Terminal tương tác, OpenClaw sẽ yêu cầu xác nhận trước khi xóa.

Nếu muốn bỏ qua bước xác nhận, sử dụng lệnh:

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

Nếu kết hợp với JSON:

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

OpenClaw yêu cầu –yes đối với thao tác delete chạy theo chế độ không tương tác hoặc kết hợp –json.

Sau khi xóa, chạy:

openclaw sessions

Session vừa xóa sẽ không còn xuất hiện trong danh sách hoạt động mặc định.

Xóa Session có xóa toàn bộ Memory không?

Không nhất thiết. Đây là một điểm dễ gây hiểu nhầm.

Khi xóa một session thông thường, OpenClaw có thể vẫn giữ transcript dưới dạng archive có hậu tố tương tự:

.jsonl.deleted.<timestamp>

Ngoài ra, dữ liệu từ session đã được lập chỉ mục vào Memory vẫn có thể tiếp tục xuất hiện trong kết quả tìm kiếm Memory.

Nếu mục tiêu là xóa cả dữ liệu Memory liên quan đến session, OpenClaw cung cấp:

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

Ví dụ:

openclaw memory forget \

--agent main \

--session "agent:main:scratch-1"

Đây là thao tác riêng với việc xóa session.

Vì vậy có thể hiểu đơn giản:

Archive

↓

Ẩn khỏi danh sách hoạt động

↓

Giữ lịch sử

Trong khi:

Delete

↓

Xóa session và dữ liệu vòng đời liên quan

↓

Memory đã lập chỉ mục có thể cần xử lý riêng

Cách khôi phục Session đã Archive

Nếu archive nhầm, bạn không cần quá lo lắng vì transcript vẫn được lưu. Trên OpenClaw Control UI, hãy mở khu vực Sessions, chuyển sang danh sách Archived hoặc All, sau đó tìm session cần khôi phục.

Sau khi khôi phục, session sẽ trở lại danh sách hoạt động và bạn có thể tiếp tục cuộc trò chuyện cũ. Control UI hiện cũng hỗ trợ Undo ngay sau thao tác Archive.

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

Có nên thường xuyên xóa Session OpenClaw?

Không nhất thiết phải xóa thường xuyên. Nếu mục tiêu chỉ là làm danh sách session gọn hơn, Archive phù hợp hơn Delete.

OpenClaw cũng có cơ chế maintenance tự động cho session. Cấu hình mặc định hiện tại bao gồm các giới hạn và chính sách như archiveDashboardAfter, pruneAfter và maxEntries. 

Ví dụ, maxEntries mặc định là 5.000 session chưa archive.

Khi muốn kiểm tra hoạt động cleanup trước:

openclaw sessions cleanup --dry-run

Nếu chắc chắn muốn áp dụng maintenance ngay:

openclaw sessions cleanup --enforce

Tuy nhiên, với người mới, archive từng session không còn sử dụng vẫn là cách dễ kiểm soát và an toàn hơn.

Kết luận

Quản lý session hợp lý giúp OpenClaw dễ sử dụng hơn, đặc biệt khi AI Agent hoạt động lâu dài trên VPS và phát sinh nhiều phiên trò chuyện. Thay vì xóa ngay các session cũ, bạn có thể sử dụng openclaw sessions archive để đưa chúng ra khỏi danh sách hoạt động nhưng vẫn giữ lịch sử để tra cứu hoặc khôi phục sau này.

Trước mỗi thao tác, hãy ưu tiên sử dụng –dry-run, kiểm tra chính xác Session Key và phân biệt rõ giữa Archive với Delete. Với quy trình này, ngay cả người mới sử dụng OpenClaw CLI cũng có thể quản lý session trên VPS một cách đơn giản và hạn chế tối đa nguy cơ thao tác nhầm.

Các bài viết liên quan:

• Hướng dẫn cài đặt và sử dụng ClawHub CLI trên OpenClaw
• Hướng dẫn cài đặt OpenClaw Skills trên ClawHub không cần code
• Hướng dẫn cách lấy API Token Slack để kết nối với OpenClaw
• Hướng dẫn sửa lỗi Tool Loop trong OpenClaw
• Hướng dẫn cách lấy API Token Telegram để kết nối với OpenClaw
• Hướng dẫn nâng cấp OpenClaw trên Docker và VPS an toàn
• Hướng dẫn kết nối Zalo với OpenClaw
• Hướng dẫn chuyển từ Cron cũ sang Automations trong OpenClaw cho người mới
• Hướng dẫn tạo Custom Skills cho OpenClaw
• Hướng dẫn kết nối Codex (ChatGPT OAuth) với OpenClaw
• Hướng dẫn kết nối Discord với OpenClaw

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