เอนจินบริบท

เอนจินบริบท ควบคุมวิธีที่ OpenClaw สร้างบริบทโมเดลสำหรับแต่ละการรัน: จะรวมข้อความใด วิธีสรุปประวัติเก่ากว่า และวิธีจัดการบริบทข้ามขอบเขต subagent

OpenClaw มาพร้อมเอนจิน legacy ในตัวและใช้เป็นค่าเริ่มต้น - ผู้ใช้ส่วนใหญ่ไม่จำเป็นต้องเปลี่ยนค่านี้ ติดตั้งและเลือกเอนจิน Plugin เฉพาะเมื่อคุณต้องการพฤติกรรมการประกอบบริบท, Compaction หรือการเรียกคืนข้ามเซสชันที่แตกต่างออกไป

เริ่มต้นอย่างรวดเร็ว

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)      },    },  },}

วิธีการทำงาน

ทุกครั้งที่ OpenClaw รันพรอมป์โมเดล เอนจินบริบทจะเข้าร่วมในสี่จุดของวงจรชีวิต:

สำหรับฮาร์เนส Codex แบบ non-ACP ที่รวมมาในชุด OpenClaw ใช้วงจรชีวิตเดียวกันโดยฉายบริบทที่ประกอบแล้วลงในคำสั่งสำหรับนักพัฒนาของ Codex และพรอมป์ของเทิร์นปัจจุบัน Codex ยังคงเป็นเจ้าของประวัติ thread ดั้งเดิมและ compactor ดั้งเดิมของตัวเอง

วงจรชีวิต Subagent (ไม่บังคับ)

OpenClaw เรียก hook วงจรชีวิต subagent ที่ไม่บังคับสองรายการ:

ส่วนเพิ่มเติมของพรอมป์ระบบ

เมธอด assemble สามารถส่งคืนสตริง systemPromptAddition ได้ OpenClaw จะเติมค่านี้ไว้หน้าพรอมป์ระบบสำหรับการรัน ซึ่งช่วยให้เอนจินฉีดคำแนะนำการเรียกคืนแบบไดนามิก, คำสั่ง retrieval หรือคำใบ้ที่รับรู้บริบทได้โดยไม่ต้องใช้ไฟล์ workspace แบบคงที่

เอนจิน legacy

เอนจิน legacy ในตัวจะรักษาพฤติกรรมดั้งเดิมของ OpenClaw:

• Ingest: ไม่ทำอะไร (ตัวจัดการเซสชันจัดการการคงอยู่ของข้อความโดยตรง)
• Assemble: ส่งผ่าน (ไปป์ไลน์ sanitize → validate → limit ที่มีอยู่ใน runtime จัดการการประกอบบริบท)
• Compact: มอบหมายให้ Compaction การสรุปในตัว ซึ่งสร้างสรุปเดียวของข้อความเก่ากว่าและคงข้อความล่าสุดไว้เหมือนเดิม
• After turn: ไม่ทำอะไร

เอนจิน legacy ไม่ลงทะเบียนเครื่องมือหรือให้ systemPromptAddition

เมื่อไม่ได้ตั้งค่า plugins.slots.contextEngine (หรือตั้งเป็น "legacy") เอนจินนี้จะถูกใช้โดยอัตโนมัติ

เอนจิน Plugin

Plugin สามารถลงทะเบียนเอนจินบริบทโดยใช้ API ของ Plugin:

 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 };    },  }));}

factory ctx มีค่า config, agentDir และ workspaceDir ที่ไม่บังคับ เพื่อให้ Plugin สามารถเริ่มต้นสถานะต่อ agent หรือต่อ workspace ก่อนที่ hook วงจรชีวิตแรกจะรัน

จากนั้นเปิดใช้งานใน config:

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

อินเทอร์เฟซ ContextEngine

สมาชิกที่จำเป็น:

assemble ส่งคืน AssembleResult พร้อม:

compact ส่งคืน CompactResult เมื่อ Compaction หมุนเวียน transcript ที่ใช้งานอยู่ result.sessionId และ result.sessionFile จะระบุเซสชันตัวสืบทอด ที่การลองใหม่หรือเทิร์นถัดไปต้องใช้

สมาชิกที่ไม่บังคับ:

การตั้งค่า Runtime

hook วงจรชีวิตที่รันภายใน OpenClaw จะได้รับอ็อบเจ็กต์ runtimeSettings ที่ไม่บังคับ นี่เป็นพื้นผิว API ภายในแบบ producer/consumer ที่มีเวอร์ชันและอ่านอย่างเดียว: OpenClaw สร้างขึ้นสำหรับเอนจินบริบทที่เลือก และเอนจินบริบทใช้ภายใน hook วงจรชีวิต ค่านี้ไม่ถูกเรนเดอร์ ไปยังผู้ใช้โดยตรง และไม่สร้างพื้นผิวการรายงานเฉพาะ

• schemaVersion: ปัจจุบันคือ 1
• runtime: โฮสต์ OpenClaw, โหมด runtime (normal, fallback หรือ degraded) และ id ของ harness/runtime ที่ไม่บังคับ
• contextEngineSelection: id เอนจินบริบทที่เลือกและแหล่งที่มาของการเลือก
• executionHost: id และป้ายชื่อโฮสต์สำหรับพื้นผิวที่เรียก hook
• model: โมเดลที่ร้องขอ, โมเดลที่ resolve แล้ว, provider และ family ของโมเดลที่ไม่บังคับ
• limits: งบประมาณโทเคนพรอมป์และจำนวนโทเคนเอาต์พุตสูงสุดเมื่อทราบ
• diagnostics: โค้ดเหตุผลแบบปิดสำหรับ fallback และ degraded เมื่อทราบ

ฟิลด์ที่อาจไม่ทราบจะแสดงเป็น null; ฟิลด์ discriminator เช่น โหมด runtime และแหล่งที่มาของการเลือกยังคงเป็น non-nullable เอนจินเก่ายังคง เข้ากันได้: หากเอนจิน legacy แบบ strict ปฏิเสธ runtimeSettings ว่าเป็น คุณสมบัติที่ไม่รู้จัก OpenClaw จะลองเรียกวงจรชีวิตอีกครั้งโดยไม่มีค่านั้นแทนการกักกัน เอนจิน

ข้อกำหนดของโฮสต์

เอนจินบริบทสามารถประกาศข้อกำหนดความสามารถของโฮสต์บน info.hostRequirements OpenClaw ตรวจสอบข้อกำหนดเหล่านี้ก่อนเริ่มปฏิบัติการ และ fail closed พร้อมข้อผิดพลาดที่อธิบายชัดเจนเมื่อ runtime ที่เลือกไม่สามารถตอบสนองได้

สำหรับการรัน agent ให้ประกาศ assemble-before-prompt เมื่อเอนจินต้องควบคุม พรอมป์โมเดลจริงผ่าน assemble():

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.",    },  },}

การรัน agent ด้วย Codex ดั้งเดิมและ OpenClaw embedded ตอบสนอง assemble-before-prompt แบ็กเอนด์ CLI ทั่วไปไม่รองรับ ดังนั้นเอนจินที่ต้องใช้ความสามารถนี้จะถูกปฏิเสธก่อนที่ กระบวนการ CLI จะเริ่ม

การแยกความล้มเหลว

OpenClaw แยกเอนจิน Plugin ที่เลือกออกจากเส้นทางการตอบกลับหลัก หาก เอนจินที่ไม่ใช่ legacy หายไป, ตรวจสอบสัญญาไม่ผ่าน, throw ระหว่างการสร้าง factory หรือ throw จากเมธอดวงจรชีวิต OpenClaw จะกักกันเอนจินนั้น สำหรับกระบวนการ Gateway ปัจจุบัน และลดระดับงานเอนจินบริบทไปใช้ เอนจิน legacy ในตัว ข้อผิดพลาดจะถูกบันทึกพร้อมปฏิบัติการที่ล้มเหลว เพื่อให้ operator สามารถซ่อมแซม, อัปเดต หรือปิดใช้งาน Plugin ได้โดยที่ agent ไม่ เงียบไป

ความล้มเหลวของข้อกำหนดโฮสต์แตกต่างออกไป: เมื่อ engine ประกาศว่า runtime ขาด capability ที่จำเป็น OpenClaw จะ fail closed ก่อนเริ่ม run การทำเช่นนี้ ปกป้อง engine ที่อาจทำให้ state เสียหายหากทำงานใน host ที่ไม่รองรับ

ownsCompaction

ownsCompaction ควบคุมว่า auto-compaction ในระหว่าง attempt ที่มีมาให้ใน OpenClaw runtime จะยังเปิดใช้งานสำหรับ run นั้นหรือไม่:

นั่นหมายความว่ามีรูปแบบ Plugin ที่ถูกต้องอยู่สองแบบ:

compact() แบบ no-op ไม่ปลอดภัยสำหรับ active non-owning engine เพราะจะปิดเส้นทาง compaction ปกติของ /compact และ overflow-recovery สำหรับ engine slot นั้น

ข้อมูลอ้างอิงการกำหนดค่า

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

ความสัมพันธ์กับ compaction และ memory

เคล็ดลับ

• ใช้ openclaw doctor เพื่อตรวจสอบว่า engine ของคุณโหลดได้อย่างถูกต้อง
• หากสลับ engine session ที่มีอยู่จะดำเนินต่อไปด้วย history ปัจจุบันของตน engine ใหม่จะเข้ารับช่วงสำหรับ run ในอนาคต
• ข้อผิดพลาดของ engine จะถูก log และ plugin engine ที่เลือกจะถูก quarantine สำหรับ Gateway process ปัจจุบัน OpenClaw จะ fallback ไปยัง legacy สำหรับ user turns เพื่อให้ยังตอบกลับต่อได้ แต่คุณยังควรซ่อมแซม อัปเดต ปิดใช้งาน หรือ uninstall Plugin ที่เสียอยู่
• สำหรับการพัฒนา ใช้ openclaw plugins install -l ./my-engine เพื่อ link local plugin directory โดยไม่ต้อง copy

ที่เกี่ยวข้อง

• Compaction - การสรุปบทสนทนายาว
• Context - วิธีสร้าง context สำหรับ agent turns
• Plugin Architecture - การลงทะเบียน context engine plugins
• Plugin manifest - ฟิลด์ใน plugin manifest
• Plugins - ภาพรวม Plugin