กลไกบริบท

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

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

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

openclaw doctor# หรือตรวจสอบการกำหนดค่าโดยตรง: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", // ต้องตรงกับรหัสกลไกที่ Plugin ลงทะเบียนไว้    },    entries: {      "lossless-claw": {        enabled: true,        // ใส่การกำหนดค่าเฉพาะของ Plugin ที่นี่ (ดูเอกสารของ Plugin)      },    },  },}

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

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

กลไกยังสามารถนำเมธอด maintain() ซึ่งเป็นตัวเลือกไปใช้สำหรับการบำรุงรักษาทรานสคริปต์ (การเขียนใหม่อย่างปลอดภัยผ่าน runtimeContext.rewriteTranscriptEntries()) หลังการบูตสแตรป รอบที่สำเร็จ หรือการทำ Compaction ได้ ตั้งค่า info.turnMaintenanceMode: "background" เพื่อเรียกใช้เป็นงานที่เลื่อนออกไปแทนการบล็อกการตอบกลับ

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

วงจรชีวิตของเอเจนต์ย่อย (ไม่บังคับ)

OpenClaw เรียกฮุกวงจรชีวิตของเอเจนต์ย่อยสองรายการที่เป็นตัวเลือก:

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

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

กลไกเดิม

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

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

กลไกเดิมไม่ลงทะเบียนเครื่องมือหรือจัดเตรียม 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 }) {      // จัดเก็บข้อความในที่เก็บข้อมูลของคุณ      return { ingested: true };    },     async assemble({      sessionId,      sessionKey,      messages,      tokenBudget,      availableTools,      citationsMode,    }) {      // ส่งคืนข้อความที่อยู่ภายในงบประมาณ      return {        messages: buildContext(messages, tokenBudget),        estimatedTokens: countTokens(messages),        systemPromptAddition: buildMemorySystemPromptAddition({          availableTools: availableTools ?? new Set(),          citationsMode,          agentSessionKey: sessionKey,        }),      };    },     async compact({ sessionId, force }) {      // สรุปบริบทเก่า      return { ok: true, compacted: true };    },  }));}

แฟกทอรี ctx มีค่า config, agentDir และ workspaceDir ที่เป็นตัวเลือก เพื่อให้ Plugin สามารถเตรียมใช้งานสถานะต่อเอเจนต์หรือต่อพื้นที่ทำงานก่อน การเรียกวงจรชีวิตครั้งแรก ก่อนการเรียก assemble() ที่ไม่ใช่กลไกเดิม โฮสต์จะดำเนินการ เตรียมพรอมต์หน่วยความจำแบบอะซิงโครนัสที่ลงทะเบียนไว้จนเสร็จสมบูรณ์ ตัวช่วยแบบซิงโครนัส buildMemorySystemPromptAddition(...) จะอ่านสแนปช็อตการทำงานที่เปลี่ยนแปลงไม่ได้ดังกล่าว โดยส่งต่อบริบทของเครื่องมือ การอ้างอิง เอเจนต์ และเซสชันที่ให้มาโดยไม่เปลี่ยนแปลง

จากนั้นเปิดใช้งานในการกำหนดค่า:

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

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

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

assemble ส่งคืน AssembleResult ซึ่งประกอบด้วย:

compact ส่งคืน CompactResult เมื่อการทำ Compaction เปลี่ยนข้อมูลประจำตัวของเซสชันที่ใช้งานอยู่ result.sessionTarget (ContextEngineSessionTarget แบบมีชนิดซึ่งมี ข้อมูลประจำตัวของเซสชันและขอบเขตที่เก็บข้อมูล) จะระบุเซสชันผู้สืบทอดที่ การลองใหม่หรือรอบถัดไปต้องใช้ ส่วน result.sessionId สะท้อนรหัสของผู้สืบทอด

สมาชิกที่เป็นตัวเลือก:

การตั้งค่ารันไทม์

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

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

ฟิลด์ที่อาจไม่ทราบจะแสดงเป็น null; ฟิลด์ตัวจำแนก เช่น โหมดรันไทม์และแหล่งที่มาของการเลือกจะยังคงไม่อนุญาตให้เป็น null กลไกรุ่นเก่ายังคง ใช้งานร่วมกันได้: หากกลไกรุ่นเก่าที่เข้มงวดปฏิเสธ runtimeSettings เนื่องจากเป็น พร็อพเพอร์ตีที่ไม่รู้จัก OpenClaw จะลองเรียกวงจรชีวิตอีกครั้งโดยไม่มีพร็อพเพอร์ตีนี้ แทนที่จะกักกัน กลไกดังกล่าว

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

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

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

info: {  id: "my-context-engine",  name: "My Context Engine",  hostRequirements: {    "agent-run": {      requiredCapabilities: ["assemble-before-prompt"],      unsupportedMessage:        "ใช้รันไทม์ Codex แบบเนทีฟหรือรันไทม์ฝังตัวของ OpenClaw หรือเลือกกลไกบริบทรุ่นเก่า",    },  },}

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

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

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

ความล้มเหลวของข้อกำหนดโฮสต์จะแตกต่างออกไป: เมื่อกลไกประกาศว่ารันไทม์ ขาดความสามารถที่จำเป็น OpenClaw จะปฏิเสธการทำงานก่อนเริ่มการรัน การทำเช่นนี้ ช่วยปกป้องกลไกที่อาจทำให้สถานะเสียหายหากทำงานบนโฮสต์ที่ไม่รองรับ

ownsCompaction

ownsCompaction ควบคุมว่าจะเปิดใช้การทำ Compaction อัตโนมัติระหว่างความพยายามในตัวของรันไทม์ OpenClaw สำหรับการรันนั้นหรือไม่:

ดังนั้นจึงมีรูปแบบ Plugin ที่ถูกต้องสองรูปแบบ:

compact() ที่ไม่ดำเนินการใดๆ ไม่ปลอดภัยสำหรับกลไกที่ใช้งานอยู่และไม่ได้ควบคุมเอง เพราะจะปิดใช้เส้นทาง Compaction ปกติสำหรับ /compact และการกู้คืนจากโอเวอร์โฟลว์ในสล็อตกลไกนั้น

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

{  plugins: {    slots: {      // เลือกกลไกบริบทที่ใช้งานอยู่ ค่าเริ่มต้น: "legacy"      // ตั้งเป็นรหัส Plugin เพื่อใช้กลไก Plugin      contextEngine: "legacy",    },  },}

ความสัมพันธ์กับ Compaction และหน่วยความจำ

เคล็ดลับ

• ใช้ openclaw doctor เพื่อตรวจสอบว่ากลไกของคุณโหลดอย่างถูกต้อง
• เมื่อสลับกลไก เซสชันที่มีอยู่จะดำเนินต่อด้วยประวัติปัจจุบัน กลไกใหม่จะเข้าควบคุมการรันในอนาคต
• ระบบจะบันทึกข้อผิดพลาดของกลไกและกักกันกลไก Plugin ที่เลือกสำหรับกระบวนการ Gateway ปัจจุบัน OpenClaw จะถอยกลับไปใช้ legacy สำหรับรอบสนทนาของผู้ใช้เพื่อให้ตอบกลับต่อไปได้ แต่ยังคงควรซ่อมแซม อัปเดต ปิดใช้งาน หรือถอนการติดตั้ง Plugin ที่เสียหาย
• สำหรับการพัฒนา ให้ใช้ openclaw plugins install -l ./my-engine เพื่อเชื่อมโยงไดเรกทอรี Plugin ในเครื่องโดยไม่ต้องคัดลอก

เนื้อหาที่เกี่ยวข้อง

• Compaction - การสรุปบทสนทนาที่ยาว
• บริบท - วิธีสร้างบริบทสำหรับรอบการทำงานของเอเจนต์
• สถาปัตยกรรม Plugin - การลงทะเบียน Plugin กลไกบริบท
• ไฟล์มานิเฟสต์ของ Plugin - ฟิลด์ในไฟล์มานิเฟสต์ของ Plugin
• Plugin - ภาพรวม Plugin