กลไกบริบท

กลไกบริบทควบคุมวิธีที่ 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 เรียกใช้พรอมต์ของโมเดล กลไกบริบทจะมีส่วนร่วมในวงจรชีวิต 4 จุด:

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

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

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

OpenClaw เรียกใช้ฮุกวงจรชีวิตของเอเจนต์ย่อยที่ไม่บังคับ 2 รายการ:

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

เมธอด 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,          agentId: resolveSessionAgentId({ config: ctx.config, sessionKey }),          agentSessionKey: sessionKey,        }),      };    },     async compact({ sessionId, force }) {      // สรุปบริบทเก่า      return { ok: true, compacted: true };    },  }));}

แฟกทอรี ctx มีค่า config, agentDir และ workspaceDir ซึ่งไม่บังคับ เพื่อให้ Plugin สามารถกำหนดค่าเริ่มต้นของสถานะต่อเอเจนต์หรือต่อพื้นที่ทำงานก่อนที่ ฮุกวงจรชีวิตแรกจะทำงาน

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

{  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) และ ID ของชุดทดสอบ/รันไทม์ที่ระบุหรือไม่ก็ได้
• contextEngineSelection: ID ของกลไกบริบทที่เลือกและแหล่งที่มาของการเลือก
• executionHost: ID และป้ายกำกับของโฮสต์สำหรับพื้นผิวที่เรียกใช้ฮุก
• 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"      // ตั้งค่าเป็น ID ของ 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