Session Memory Flush cho Openclaw

Một tiện ích chạy ngầm giúp ghi lại ngữ cảnh phiên có giá trị cao trước khi hết thời gian chờ và lưu trữ nó vào các tệp bộ nhớ không gian làm việc.

hasakyi
v1.0.0
May 8, 2026
0
780
0

Cài đặt & Tải xuống

1. ClawHub CLI

Cách nhanh nhất để cài đặt kỹ năng trực tiếp từ thư viện.

npx clawhub@latest install session-memory-flush

2. Cài đặt Thủ công

Sao chép thư mục kỹ năng vào một trong những vị trí sau

Toàn cục
~/.openclaw/skills/
Không gian làm việc
<project>/skills/

Ưu tiên: Không gian làm việc > Cục bộ > Gói sẵn

3. Cài đặt Prompt

Sao chép prompt này vào OpenClaw để tự động cài đặt.

Giúp tôi cài đặt session-memory-flush bằng Clawhub. Nếu Clawhub chưa

Bạn muốn tải xuống?

Nhận các tệp kỹ năng gốc dưới dạng lưu trữ ZIP.

Session Memory Flush là gì?

Session Memory Flush là một tiện ích chuyên dụng được thiết kế để lấp đầy khoảng cách ngữ cảnh trong quy trình làm việc của AI agent. Trước khi một phiên Openclaw được giải phóng do rảnh hoặc đặt lại thủ công, kỹ năng này sẽ quét bản ghi phiên đang hoạt động, chắt lọc các thông tin thiết yếu bằng nhà cung cấp LLM chính của bạn và ghi lại một bản tóm tắt có cấu trúc vào bộ nhớ không gian làm việc của bạn. Cách tiếp cận chủ động này đảm bảo rằng các phiên tiếp theo có thể kế thừa lịch sử dự án quan trọng, sở thích của người dùng và các tác vụ đang chờ xử lý.

Bằng cách tích hợp công cụ này với Openclaw Skills, các nhà phát triển có thể giảm đáng kể hiệu ứng mất trí nhớ xảy ra khi ngữ cảnh ngắn hạn của agent bị xóa. Nó cung cấp một cầu nối đáng tin cậy để các agent chính, subagent và các tác vụ cron tự động chia sẻ kiến thức thông qua hệ thống tệp bộ nhớ không gian làm việc, đảm bảo trải nghiệm người dùng liên tục và mạch lạc qua nhiều lần tương tác.

Trường hợp sử dụng Session Memory Flush

  • Ghi lại và duy trì ngữ cảnh từ các tin nhắn trực tiếp riêng tư hoặc trò chuyện nhóm trước khi chúng vượt quá ngưỡng rảnh.
  • Khôi phục các bản ghi có giá trị cao từ subagent gốc, công việc cron hoặc các phiên dreaming để lưu trữ lâu dài.
  • Buộc thực hiện xóa bộ nhớ thủ công cho các mã phiên cụ thể trong quá trình phát triển hoặc gỡ lỗi.
  • Duy trì một cơ sở kiến thức thống nhất giữa các agent khác nhau dùng chung một không gian làm việc.

Cách thức hoạt động của Session Memory Flush

  1. Tập lệnh watcher giám sát các phiên đang hoạt động bằng cách thực thi openclaw sessions --json với tần suất thăm dò được xác định.
  2. Nó tính toán thời gian rảnh cho mỗi phiên và so sánh với các ngưỡng cụ thể cho các tương tác trực tiếp và nhóm.
  3. Khi một phiên đạt đến cửa sổ quét, công cụ sẽ lấy toàn bộ bản ghi và xác định agentId cũng như cấu hình mô hình tương ứng.
  4. Nó gọi nhà cung cấp LLM chính để tạo bản tóm tắt có cấu trúc tập trung vào các mục tiêu, quyết định và các mục đang chờ xử lý.
  5. Bản tóm tắt được thêm vào một tệp Markdown có ghi ngày tháng (ví dụ: YYYY-MM-DD.md) trong thư mục bộ nhớ không gian làm việc.
  6. Công cụ cập nhật tệp trạng thái cục bộ để theo dõi các phiên đã được xóa, ngăn chặn việc xử lý trùng lặp trong chu kỳ tiếp theo.

Cài đặt Session Memory Flush

Để triển khai trình lắng nghe bộ nhớ liên tục cho Openclaw Skills của bạn, hãy chạy tập lệnh cài đặt được cung cấp:

bash install.sh

Bạn có thể ghi đè các hành vi mặc định bằng cách sử dụng các biến môi trường để kiểm soát tinh vi hơn:

SESSION_MEMORY_TIMER_MINUTES=1 \
SESSION_MEMORY_DM_IDLE_MINUTES=5 \
SESSION_MEMORY_OUTPUT_DIR="$HOME\/.openclaw\/workspace\/memory" \
bash install.sh

Để thực hiện chạy thử thủ công mà không ghi dữ liệu, hãy sử dụng lệnh sau:

python3 watcher.py --once --dry-run

Lược đồ dữ liệu & Hệ thống phân loại của Session Memory Flush

Kỹ năng này quản lý dữ liệu trên các tệp Markdown và sổ đăng ký trạng thái JSON để duy trì ngữ cảnh trong Openclaw Skills.

Danh mục Vị trí Định dạng / Chi tiết
Lưu trữ bộ nhớ ~\/.openclaw\/workspace\/memory\/YYYY-MM-DD.md Markdown có cấu trúc chứa các mục tiêu phiên, quyết định và đầu việc.
Trạng thái xử lý state\/flushed_sessions.json Đối tượng JSON ánh xạ agentId:sessionId để ngăn tóm tắt trùng lặp.
Cấu hình openclaw.json Hỗ trợ một khối sessionMemoryFlush cho các cài đặt bộ hẹn giờ và ngưỡng.
Đầu ra tóm tắt Markdown Headers Sử dụng các tiêu đề được tiêu chuẩn hóa như Nguồn, Mục tiêu, Quyết định và Rủi ro để dễ dàng truy xuất.

Tính năng Nâng cao của Session Memory Flush

  • Nhận biết đa Agent: Tự động phát hiện các agentId khác nhau để đảm bảo các bản ghi được tóm tắt bằng cách sử dụng mô hình và phạm vi ngữ cảnh chính xác.
  • Logic rảnh theo tầng: Các ngưỡng có thể cấu hình cho phép cửa sổ rảnh ngắn hơn cho tin nhắn trực tiếp và cửa sổ dài hơn cho các cuộc trò chuyện nhóm cộng tác.
  • Dự phòng cục bộ: Nếu nhà cung cấp LLM gặp sự cố, kỹ năng có thể hạ cấp xuống bản tóm tắt dựa trên quy tắc cục bộ để đảm bảo không mất dữ liệu.
  • Tích hợp không gian làm việc: Được thiết kế để hoạt động liền mạch với các đường dẫn tải bộ nhớ không gian làm việc của Openclaw Skills để kế thừa ngữ cảnh ngay lập tức.
  • Ưu tiên bảo mật: Khóa API và thông tin xác thực nhạy cảm không bao giờ được lưu trữ trong bản tóm tắt phiên hoặc tệp trạng thái cục bộ.

SKILL.md


Đang tải

Các kỹ năng Openclaw liên quan

METADATA

Github Stars: 0
forks: 0

Đặc sắc*