Công cụ ngữ cảnh

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Bắt đầu nhanh

openclaw doctor
# or inspect config directly:
cat ~/.openclaw/openclaw.json | jq '.plugins.slots.contextEngine'

openclaw plugins install @martian-engineering/lossless-claw

openclaw plugins install -l ./my-context-engine

// openclaw.json
{
  plugins: {
    slots: {
      contextEngine: "lossless-claw", // must match the plugin's registered engine id
    },
    entries: {
      "lossless-claw": {
        enabled: true,
        // Plugin-specific config goes here (see the plugin's docs)
      },
    },
  },
}

​

Cách hoạt động

​

Vòng đời subagent (không bắt buộc)

​

Phần bổ sung prompt hệ thống

​

Công cụ legacy

• Nạp: không làm gì (trình quản lý phiên trực tiếp xử lý việc lưu tin nhắn).
• Lắp ráp: truyền qua (pipeline sanitize → validate → limit hiện có trong runtime xử lý việc lắp ráp ngữ cảnh).
• Compact: ủy quyền cho compaction tóm tắt tích hợp sẵn, tạo một bản tóm tắt duy nhất của các tin nhắn cũ hơn và giữ nguyên các tin nhắn gần đây.
• Sau lượt: không làm gì.

​

Công cụ Plugin

import { buildMemorySystemPromptAddition } from "openclaw/plugin-sdk/core";

export default function register(api) {
  api.registerContextEngine("my-engine", (ctx) => ({
    info: {
      id: "my-engine",
      name: "My Context Engine",
      ownsCompaction: true,
    },

    async ingest({ sessionId, message, isHeartbeat }) {
      // Store the message in your data store
      return { ingested: true };
    },

    async assemble({ sessionId, messages, tokenBudget, availableTools, citationsMode }) {
      // Return messages that fit the budget
      return {
        messages: buildContext(messages, tokenBudget),
        estimatedTokens: countTokens(messages),
        systemPromptAddition: buildMemorySystemPromptAddition({
          availableTools: availableTools ?? new Set(),
          citationsMode,
        }),
      };
    },

    async compact({ sessionId, force }) {
      // Summarize older context
      return { ok: true, compacted: true };
    },
  }));
}

{
  plugins: {
    slots: {
      contextEngine: "my-engine",
    },
    entries: {
      "my-engine": {
        enabled: true,
      },
    },
  },
}

​

Giao diện ContextEngine

​

ownsCompaction

​

Tham chiếu cấu hình

{
  plugins: {
    slots: {
      // Select the active context engine. Default: "legacy".
      // Set to a plugin id to use a plugin engine.
      contextEngine: "legacy",
    },
  },
}

​

Quan hệ với compaction và bộ nhớ

​

Mẹo

• Dùng openclaw doctor để xác minh công cụ của bạn đang tải đúng cách.
• Nếu chuyển đổi công cụ, các phiên hiện có tiếp tục với lịch sử hiện tại của chúng. Công cụ mới sẽ tiếp quản cho các lần chạy trong tương lai.
• Lỗi công cụ được ghi nhật ký và hiển thị trong chẩn đoán. Nếu một công cụ Plugin không đăng ký được hoặc không thể phân giải id công cụ đã chọn, OpenClaw không tự động quay về dự phòng; các lần chạy sẽ thất bại cho đến khi bạn sửa Plugin hoặc chuyển plugins.slots.contextEngine về "legacy".
• Để phát triển, dùng openclaw plugins install -l ./my-engine để liên kết một thư mục Plugin cục bộ mà không cần sao chép.

​

Liên quan

• Compaction — tóm tắt các cuộc trò chuyện dài
• Ngữ cảnh — cách ngữ cảnh được xây dựng cho các lượt tác tử
• Kiến trúc Plugin — đăng ký các Plugin công cụ ngữ cảnh
• Tệp kê khai Plugin — các trường tệp kê khai Plugin
• Plugin — tổng quan về Plugin