Sessions and memory

Bộ nhớ Honcho

Honcho bổ sung bộ nhớ tích hợp AI cho OpenClaw thông qua một Plugin bên ngoài. Plugin này lưu giữ lâu dài các cuộc hội thoại trong một dịch vụ chuyên dụng và xây dựng mô hình người dùng cũng như tác nhân theo thời gian, cung cấp cho tác nhân ngữ cảnh xuyên phiên vượt ra ngoài các tệp Markdown trong không gian làm việc.

Các tính năng được cung cấp

  • Bộ nhớ xuyên phiên - các cuộc hội thoại được lưu giữ sau mỗi lượt, nhờ đó ngữ cảnh được duy trì qua các lần đặt lại phiên, Compaction và chuyển đổi kênh.
  • Mô hình hóa người dùng - Honcho duy trì một hồ sơ cho từng người dùng (tùy chọn, dữ kiện, phong cách giao tiếp) và cho tác nhân (tính cách, các hành vi đã học).
  • Tìm kiếm ngữ nghĩa - tìm kiếm trong các quan sát từ những cuộc hội thoại trước đây, không chỉ trong phiên hiện tại.
  • Nhận biết đa tác nhân - các tác nhân cha tự động theo dõi những tác nhân con được tạo, đồng thời tác nhân cha được thêm làm bên quan sát trong các phiên con.

Công cụ có sẵn

Honcho đăng ký các công cụ mà tác nhân có thể sử dụng trong cuộc hội thoại:

Truy xuất dữ liệu (nhanh, không gọi LLM):

Công cụ Chức năng
honcho_context Biểu diễn đầy đủ về người dùng trên nhiều phiên
honcho_search_conclusions Tìm kiếm ngữ nghĩa trong các kết luận đã lưu
honcho_search_messages Tìm tin nhắn trên nhiều phiên (lọc theo người gửi, ngày)
honcho_session Lịch sử và bản tóm tắt của phiên hiện tại

Hỏi đáp (do LLM hỗ trợ):

Công cụ Chức năng
honcho_ask Hỏi về người dùng. Dùng depth='quick' cho dữ kiện, 'thorough' để tổng hợp

Bắt đầu

Cài đặt Plugin và chạy thiết lập:

bash
openclaw plugins install @honcho-ai/openclaw-honchoopenclaw honcho setupopenclaw gateway --force

Lệnh thiết lập sẽ yêu cầu thông tin xác thực API của bạn, ghi cấu hình và tùy chọn di chuyển các tệp bộ nhớ hiện có trong không gian làm việc.

Cấu hình

Các thiết lập nằm trong plugins.entries["openclaw-honcho"].config:

json5
{  plugins: {    entries: {      "openclaw-honcho": {        config: {          apiKey: "your-api-key", // bỏ qua khi tự lưu trữ          workspaceId: "openclaw", // cô lập bộ nhớ          baseUrl: "https://api.honcho.dev",        },      },    },  },}

Đối với các phiên bản tự lưu trữ, hãy đặt baseUrl trỏ đến máy chủ cục bộ của bạn (ví dụ http://localhost:8000) và bỏ qua khóa API.

Di chuyển bộ nhớ hiện có

Nếu bạn có các tệp bộ nhớ hiện có trong không gian làm việc (USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/), openclaw honcho setup sẽ phát hiện và đề nghị di chuyển chúng.

Cách hoạt động

Sau mỗi lượt AI, cuộc hội thoại được lưu giữ lâu dài trong Honcho. Cả tin nhắn của người dùng và tác nhân đều được quan sát, cho phép Honcho xây dựng và tinh chỉnh các mô hình của mình theo thời gian.

Trong cuộc hội thoại, các công cụ Honcho truy vấn dịch vụ tại hook Plugin before_prompt_build của OpenClaw, chèn ngữ cảnh liên quan trước khi mô hình nhận được lời nhắc.

Honcho so với bộ nhớ tích hợp sẵn

Tích hợp sẵn / QMD Honcho
Lưu trữ Các tệp Markdown trong không gian làm việc Dịch vụ chuyên dụng (cục bộ hoặc được lưu trữ)
Xuyên phiên Thông qua các tệp bộ nhớ Tự động, tích hợp sẵn
Mô hình hóa người dùng Thủ công (ghi vào MEMORY.md) Hồ sơ tự động
Tìm kiếm Vectơ + từ khóa (kết hợp) Ngữ nghĩa trên các quan sát
Đa tác nhân Không được theo dõi Nhận biết quan hệ cha/con
Phụ thuộc Không có (tích hợp sẵn) hoặc tệp nhị phân QMD Cài đặt Plugin

Honcho và hệ thống bộ nhớ tích hợp sẵn có thể hoạt động cùng nhau. Khi QMD được cấu hình, các công cụ bổ sung sẽ khả dụng để tìm kiếm các tệp Markdown cục bộ cùng với bộ nhớ xuyên phiên của Honcho.

Các lệnh CLI

bash
openclaw honcho setup                        # Cấu hình khóa API và di chuyển tệpopenclaw honcho status                       # Kiểm tra trạng thái kết nốiopenclaw honcho ask <question>               # Truy vấn Honcho về người dùngopenclaw honcho search <query> [-k N] [-d D] # Tìm kiếm ngữ nghĩa trong bộ nhớ

Đọc thêm

Nội dung liên quan

Was this useful?
On this page

On this page