Context Window & Compaction

Mỗi model đều có một context window (số token tối đa mà nó có thể xem). Các cuộc chat chạy lâu sẽ tích lũy messages và tool results; khi window gần đầy, OpenClaw sẽ compact lịch sử cũ để giữ trong giới hạn.

Compaction là gì

Compaction tóm tắt các đoạn hội thoại cũ thành một entry tóm tắt ngắn gọn và giữ nguyên các messages gần đây. Bản tóm tắt được lưu trong lịch sử session, nên các request sau sẽ dùng:

  • Bản tóm tắt compaction
  • Các messages gần đây sau điểm compaction

Compaction được lưu vĩnh viễn trong lịch sử JSONL của session.

Cấu hình

Xem Compaction config & modes để biết các cài đặt agents.defaults.compaction.

Auto-compaction (mặc định bật)

Khi một session gần chạm hoặc vượt quá context window của model, OpenClaw sẽ kích hoạt auto-compaction và có thể retry request ban đầu với context đã được compact.

Các bạn sẽ thấy:

  • 🧹 Auto-compaction complete trong verbose mode
  • /status hiển thị 🧹 Compactions: <count>

Trước khi compaction, OpenClaw có thể chạy một turn silent memory flush để lưu các ghi chú lâu dài vào disk. Xem Memory để biết chi tiết và cấu hình.

Manual compaction

Dùng /compact (có thể kèm instructions) để bắt buộc chạy compaction:

/compact Focus on decisions and open questions

Context window source

Context window phụ thuộc vào từng model. OpenClaw dùng định nghĩa model từ provider catalog đã cấu hình để xác định giới hạn.

Compaction vs pruning

  • Compaction: tóm tắt và lưu vĩnh viễn trong JSONL.
  • Session pruning: chỉ cắt bớt tool results cũ, trong memory, theo từng request.

Xem /concepts/session-pruning để biết chi tiết về pruning.

Tips

  • Dùng /compact khi sessions cảm giác cũ hoặc context bị phình to.
  • Các tool outputs lớn đã được cắt ngắn tự động; pruning có thể giảm thêm sự tích lũy tool-result.
  • Nếu các bạn muốn bắt đầu lại từ đầu, dùng /new hoặc /reset để tạo session id mới.