เอนจินบริบท

เอนจินบริบท ควบคุมวิธีที่ 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 รันพรอมป์โมเดล เอนจินบริบทจะเข้าร่วมที่จุด lifecycle สี่จุด:

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

Lifecycle ของ subagent (ไม่บังคับ)

OpenClaw เรียก hook lifecycle ของ subagent ที่ไม่บังคับสองรายการ:

การเพิ่ม system prompt

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

เอนจิน legacy

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

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

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

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

เอนจิน Plugin

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

 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 สามารถ initialize สถานะต่อ agent หรือ ต่อ workspace ก่อนที่ hook lifecycle แรกจะรัน

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

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

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

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

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

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

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

การตั้งค่า Runtime

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

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

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

ข้อกำหนดของ Host

เอนจินบริบทสามารถประกาศข้อกำหนด capability ของ host ได้ที่ info.hostRequirements OpenClaw ตรวจสอบข้อกำหนดเหล่านี้ก่อนเริ่ม operation และ 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 แบบ Native Codex และ OpenClaw embedded รองรับ assemble-before-prompt backend CLI แบบ generic ไม่รองรับ ดังนั้นเอนจินที่ต้องใช้ capability นี้จะถูกปฏิเสธก่อน กระบวนการ CLI เริ่มต้น

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

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

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

ownsCompaction

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

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

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

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

{  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 เพื่อตรวจสอบว่าเอนจินของคุณโหลดอย่างถูกต้อง
• หากสลับเอนจิน session ที่มีอยู่จะดำเนินต่อไปพร้อม history ปัจจุบัน เอนจินใหม่จะรับช่วงสำหรับ run ในอนาคต
• ข้อผิดพลาดของเอนจินจะถูกบันทึก และเอนจิน Plugin ที่เลือกไว้จะถูกกักกันสำหรับกระบวนการ Gateway ปัจจุบัน OpenClaw จะ fallback ไปที่ legacy สำหรับ turn ของผู้ใช้เพื่อให้การตอบกลับดำเนินต่อไปได้ แต่คุณยังควรซ่อมแซม อัปเดต ปิดใช้งาน หรือถอนการติดตั้ง Plugin ที่เสีย
• สำหรับการพัฒนา ใช้ openclaw plugins install -l ./my-engine เพื่อ link ไดเรกทอรี Plugin ภายในเครื่องโดยไม่ต้องคัดลอก

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

• Compaction - การสรุปบทสนทนายาวๆ
• Context - วิธีสร้าง context สำหรับ turn ของ agent
• สถาปัตยกรรม Plugin - การลงทะเบียน Plugin context engine
• manifest ของ Plugin - ฟิลด์ manifest ของ Plugin
• Plugins - ภาพรวม Plugin