Giao thức duy trì tính liên tục của phiên (Bốn bước mở đầu) cho Openclaw

Một giao thức ưu tiên tệp, tải lại ngữ cảnh dự án và tài khoản đáng tin cậy khi bắt đầu mỗi phiên, giúp tác nhân AI tiếp tục công việc mà không phải hỏi lại hoặc làm mất các quyết định.

zhaoxinghua09-cell
v1.0.1
Oct 17, 2026
0
80
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-continuity-protocol

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-continuity-protocol 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.

Giao thức duy trì tính liên tục của phiên (Bốn bước mở đầu) là gì?

Giao thức duy trì tính liên tục của phiên là quy trình bộ nhớ dành cho tác nhân AI, giúp duy trì ngữ cảnh giữa các phiên, không gian làm việc, tài khoản và thiết bị. Giao thức bắt buộc thực hiện trình tự mở đầu gồm bốn bước: đọc chỉ mục dự án đang hoạt động, MEMORY.md cấp tài khoản, bộ nhớ ngữ nghĩa cục bộ làm phương án dự phòng và các bộ nhớ dự án mới được cập nhật trước khi bắt đầu công việc thực chất.

Là một giao thức Openclaw Skills, giao thức xem tệp là nguồn có thẩm quyền đối với các sự kiện đã chốt và chỉ dùng localmem làm phương tiện gợi nhớ thứ cấp. Cách tiếp cận này giúp tác nhân lưu giữ quy tắc thương hiệu, trạng thái dự án, hạn chế xuất bản, quy trình bàn giao và chi tiết chuyển tiếp, đồng thời giảm việc làm lại ngoài ý muốn và các câu hỏi lặp lại.

Trường hợp sử dụng Giao thức duy trì tính liên tục của phiên (Bốn bước mở đầu)

  • Bắt đầu phiên mới trước khi người dùng nêu một nhiệm vụ cụ thể.
  • Tiếp tục công việc chưa hoàn tất từ không gian làm việc, tài khoản, thiết bị hoặc cuộc trò chuyện trước đó.
  • Phản hồi khi người dùng nói tác nhân đã quên ngữ cảnh hoặc yêu cầu tiếp tục công việc hôm qua.
  • Chuẩn bị các nhiệm vụ cần duy trì tính liên tục, chẳng hạn như đăng bài trên tài khoản chính thức, sản xuất tài sản thương hiệu, xử lý trở ngại xuất bản, bàn giao khóa hoặc đánh giá trạng thái dự án.
  • Khôi phục danh sách dự án đang hoạt động, trách nhiệm RACI, điểm bàn giao, trở ngại dự án và quy tắc tài khoản đã chốt.
  • Kích hoạt quy trình bằng các thuật ngữ như continuity, memory, localmem, cross-session hoặc opening four steps.
  • Duy trì ngữ cảnh đáng tin cậy trong các triển khai Openclaw Skills mà không phụ thuộc vào dịch vụ bộ nhớ đám mây.

Cách thức hoạt động của Giao thức duy trì tính liên tục của phiên (Bốn bước mở đầu)

  1. Đọc chỉ mục dự án toàn cục. Tải <your-workspace-root>\/_ACTIVE_PROJECTS.md để xác định các dự án đang hoạt động, trách nhiệm RACI, trở ngại và điểm bàn giao mới nhất.
  2. Đọc nguồn dữ liệu chuẩn cấp tài khoản. Tải <memory-root>\/MEMORY.md để khôi phục các sự kiện đã chốt không nên hỏi lại, bao gồm danh tính tài khoản, mẫu, quy tắc nhận diện trực quan, cổng xuất bản, quy tắc bàn giao khóa và quy ước bản quyền.
  3. Thực hiện truy hồi ngữ nghĩa dự phòng. Khi cần thêm ngữ cảnh, sử dụng localmem MCP thông qua recall_memory hoặc search_memory. Giới hạn kết quả truy hồi ở khoảng 5–8 mục và xem localmem là phương án dự phòng, không phải nguồn có thẩm quyền.
  4. Quét các bộ nhớ dự án gần đây. Glob <your-workspace-root>\/*\/memory\/MEMORY.md và đọc các tệp cấp dự án được sửa đổi gần đây nhất, đặc biệt là bộ nhớ trong 14 ngày qua.
  5. Giải quyết xung đột theo thứ bậc. Ưu tiên lớp tệp — chỉ mục toàn cục, MEMORY.md cấp tài khoản và MEMORY.md cấp dự án — hơn các kết quả ngữ nghĩa từ localmem.
  6. Thực hiện nhiệm vụ được yêu cầu. Chỉ bắt đầu công việc thực chất sau khi hoàn tất bốn bước mở đầu và tải các sự kiện quan trọng đối với tính liên tục.
  7. Lưu giữ các sự kiện mới đã chốt. Trước tiên, ghi các quyết định đã thống nhất vào MEMORY.md thích hợp trong lớp tệp, sau đó lưu hạt giống ngữ nghĩa vào localmem và xác minh bằng recall_memory.
  8. Xác nhận hoàn tất. Xác nhận cả bốn bước đã chạy, không hỏi lại các sự kiện đã chốt và mọi sự kiện bền vững mới đều được lưu trong cả lớp tệp lẫn localmem.

Cài đặt Giao thức duy trì tính liên tục của phiên (Bốn bước mở đầu)

Kỹ năng này là giao thức dựa trên prompt, không cần runtime, cài đặt gói, thực thi tiến trình con hoặc kết nối mạng. Cài đặt hoặc cung cấp SKILL.md cho tác nhân AI chủ, sau đó cấp quyền truy cập vào không gian làm việc và các tệp bộ nhớ mà tác nhân cần đọc.

  1. Tạo hoặc xác định thư mục gốc của không gian làm việc toàn cục và thư mục gốc bộ nhớ tài khoản.
  2. Đảm bảo các tệp sau tồn tại và được tác nhân duy trì: _ACTIVE_PROJECTS.md, MEMORY.md cấp tài khoản và các tệp memory\/MEMORY.md cấp dự án.
  3. Nếu có localmem, hãy cấu hình một cơ sở dữ liệu SQLite dùng chung để truy hồi giữa các không gian làm việc và tài khoản:
export LOCALMEM_DB_PATH="<your-workspace-root>\/_localmem_memories.db"
  1. Bảo toàn và sao lưu bộ nhớ đệm embedding cục bộ tại <your-workspace-root>\/_localmem_models; các vector hiện có có thể vẫn tìm kiếm được khi ngoại tuyến, nhưng việc thêm hạt giống mới phụ thuộc vào bộ nhớ đệm.
  2. Yêu cầu tác nhân chạy bốn bước mở đầu trước mỗi phiên mới và trước công việc cần duy trì tính liên tục. Không cần gói Python; nếu môi trường chủ sử dụng Python, phiên bản tối thiểu được tài liệu hóa là Python 3.8.
  3. Không xem localmem là vật thay thế cho lớp tệp. Sự kiện mới đã chốt phải được ghi vào tệp MEMORY.md thích hợp trước khi được thêm làm hạt giống ngữ nghĩa.
  4. Đối với các hành động bên ngoài như push, xuất bản, gửi, phát hành hoặc triển khai, yêu cầu con người xem xét và phê duyệt theo hướng dẫn về rủi ro trung bình của kỹ năng.

Lược đồ dữ liệu & Hệ thống phân loại của Giao thức duy trì tính liên tục của phiên (Bốn bước mở đầu)

Giao thức tổ chức dữ liệu duy trì tính liên tục thành lớp tệp có thẩm quyền và lớp dự phòng ngữ nghĩa tùy chọn.

Lớp Vị trí hoặc giao diện Mục đích Tính thẩm quyền
Chỉ mục dự án toàn cục <workspace-root>\/_ACTIVE_PROJECTS.md Dự án đang hoạt động, RACI, trở ngại và điểm bàn giao Chính
Bộ nhớ tài khoản <memory-root>\/MEMORY.md Sự kiện tài khoản đã chốt, mẫu, quy tắc thương hiệu, cổng xuất bản, quy tắc bàn giao khóa và chữ ký Chính
Bộ nhớ dự án <workspace-root>\/*\/memory\/MEMORY.md Quyết định riêng cho không gian làm việc, quy tắc bất di bất dịch và ngữ cảnh dự án gần đây Chính
Cơ sở dữ liệu bộ nhớ ngữ nghĩa LOCALMEM_DB_PATH trỏ đến _localmem_memories.db Truy hồi kết hợp cosine và từ khóa giữa các không gian làm việc và tài khoản Phụ
Bộ nhớ đệm mô hình embedding <workspace-root>\/_localmem_models Tài nguyên mô hình ngoại tuyến cần thiết để thêm hoặc truy vấn hạt giống ngữ nghĩa Phụ thuộc vận hành

Phân loại hạt giống localmem có thể bao gồm mã định danh và thẻ như continuity, publish, SynomosAI, con trỏ dự án, thương hiệu và nhận diện trực quan, cổng xuất bản, bàn giao khóa, sự cố xem trước và SOP vận hành. Bộ nhớ hiện có được truy hồi bằng recall_memory hoặc search_memory; sự kiện bền vững mới chỉ được ghi bằng store_memory sau khi đã được ghi vào lớp tệp.

Kỹ năng không tạo tệp đầu ra riêng hoặc mã thoát tiến trình. Kết quả là phản hồi giao thức có cấu trúc, bàn giao nhiệm vụ hoặc danh sách kiểm tra đánh giá do tác nhân chủ tạo ra. Tiêu chí hoàn tất yêu cầu đủ bốn bước mở đầu, không hỏi lại các sự kiện đã chốt và lưu giữ các sự kiện mới được chốt trong cả lớp tệp lẫn localmem.

Tính năng Nâng cao của Giao thức duy trì tính liên tục của phiên (Bốn bước mở đầu)

  • Khởi động bắt buộc theo đúng thứ tự: Bắt buộc hoàn tất cả bốn bước tải ngữ cảnh trước khi làm việc thực chất, giúp giảm tình trạng quên thông tin khi bắt đầu phiên.
  • Thứ bậc nguồn ưu tiên tệp: Giải quyết xung đột theo cách xác định bằng việc ưu tiên _ACTIVE_PROJECTS.md và các tệp MEMORY.md hơn truy hồi ngữ nghĩa.
  • Bộ nhớ xuyên không gian làm việc: Hỗ trợ cơ sở dữ liệu SQLite dùng chung thông qua LOCALMEM_DB_PATH để truy hồi giữa các không gian làm việc và tài khoản.
  • Truy xuất thân thiện với môi trường ngoại tuyến: Sử dụng SQLite, FTS5, embedding cục bộ, độ tương đồng cosine và đối sánh từ khóa mà không cần LLM hoặc API bên ngoài.
  • Tìm kiếm ngữ nghĩa dự phòng: Hỗ trợ recall_memory và search_memory, với giới hạn truy hồi được kiểm soát ở khoảng 5–8 kết quả.
  • Quy trình ghi dữ liệu bền vững: Yêu cầu lưu sự kiện mới đã chốt trong lớp tệp có thẩm quyền, sau đó tạo hạt giống trong localmem và xác minh.
  • Quét ngữ cảnh gần đây: Tự động ưu tiên các tệp MEMORY.md cấp dự án được sửa đổi gần đây, bao gồm hoạt động dự án trong 14 ngày gần nhất.
  • Biện pháp bảo vệ vận hành: Nhắc sao lưu _localmem_models, bảo vệ việc xử lý khóa ở dạng văn bản thuần bằng quy tắc bàn giao được ghi lại và tách việc chuẩn bị bộ nhớ khỏi các hành động gây ảnh hưởng bên ngoài.
  • Danh sách kiểm tra tiêu chí hoàn tất: Xác minh không bỏ qua bước khởi động nào, không hỏi lại các sự kiện đã chốt và các quyết định mới đã được lưu đúng cách.
  • Thiết kế Openclaw Skills ít phụ thuộc: Sử dụng giao diện prompt không phụ thuộc runtime, mạng, tiến trình con hoặc gói Python.

SKILL.md


Đang tải

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

METADATA

Github Stars: 0
forks: 0

Đặc sắc*