Bộ máy ngữ cảnh

​

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 (tùy chọn)

​

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

​

Công cụ legacy

• Nạp: không thao tác (trình quản lý phiên xử lý trực tiếp việc lưu thông điệp).
• Lắp ráp: chuyển tiếp (pipeline sanitize → validate → limit hiện có trong runtime xử lý 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 thông điệp cũ hơn và giữ nguyên các thông điệp gần đây.
• Sau lượt: không thao tác.

​

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

​

Cài đặt runtime

• schemaVersion: hiện là 1
• runtime: host OpenClaw, chế độ runtime (normal, fallback, hoặc degraded), và các id harness/runtime tùy chọn
• contextEngineSelection: id công cụ ngữ cảnh đã chọn và nguồn lựa chọn
• executionHost: id host và nhãn cho bề mặt gọi hook
• model: mô hình được yêu cầu, mô hình đã phân giải, provider, và họ mô hình tùy chọn
• limits: ngân sách token prompt và số token đầu ra tối đa khi biết
• diagnostics: các mã lý do fallback đóng và degraded khi biết

​

Yêu cầu host

info: {
  id: "my-context-engine",
  name: "My Context Engine",
  hostRequirements: {
    "agent-run": {
      requiredCapabilities: ["assemble-before-prompt"],
      unsupportedMessage:
        "Use the native Codex or OpenClaw embedded runtime, or select the legacy context engine.",
    },
  },
}

​

Cách ly lỗi

​

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 tiếp quản các lượt chạy trong tương lai.
• Lỗi công cụ được ghi nhật ký và công cụ Plugin đã chọn bị cách ly cho tiến trình Gateway hiện tại. OpenClaw quay về legacy cho các lượt của người dùng để phản hồi có thể tiếp tục, nhưng bạn vẫn nên sửa, cập nhật, vô hiệu hóa, hoặc gỡ cài đặt Plugin bị hỏng.
• Khi 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 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 lượt của tác tử
• Kiến trúc Plugin - đăng ký Plugin công cụ ngữ cảnh
• Manifest Plugin - các trường manifest của Plugin
• Plugins - tổng quan về Plugin