รันไทม์ของฮาร์เนส Codex

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

หน้านี้จัดทำเอกสารสัญญารันไทม์สำหรับเทิร์นของฮาร์เนส Codex สำหรับการตั้งค่าและ การกำหนดเส้นทาง ให้เริ่มที่ ฮาร์เนส Codex สำหรับฟิลด์การกำหนดค่า โปรดดู เอกสารอ้างอิงฮาร์เนส Codex

​

ภาพรวม

โหมด Codex ไม่ใช่ PI ที่มีการเรียกโมเดลคนละแบบอยู่ด้านล่าง Codex เป็นเจ้าของวงรอบ โมเดลแบบเนทีฟมากกว่า และ OpenClaw ปรับพื้นผิวของ Plugin, เครื่องมือ, เซสชัน และ การวินิจฉัยให้เข้ากับขอบเขตนั้น OpenClaw ยังคงเป็นเจ้าของการกำหนดเส้นทางช่องทาง, ไฟล์เซสชัน, การส่งข้อความที่มองเห็นได้, เครื่องมือไดนามิกของ OpenClaw, การอนุมัติ, การส่งสื่อ และสำเนาทรานสคริปต์ Codex เป็นเจ้าของเธรดเนทีฟตามมาตรฐาน, วงรอบโมเดลเนทีฟ, การดำเนินต่อของเครื่องมือเนทีฟ และ Compaction แบบเนทีฟ

​

การผูกเธรดและการเปลี่ยนโมเดล

เมื่อแนบเซสชัน OpenClaw เข้ากับเธรด Codex ที่มีอยู่ เทิร์นถัดไป จะส่งโมเดล OpenAI ที่เลือกอยู่ในปัจจุบัน, นโยบายการอนุมัติ, แซนด์บ็อกซ์ และระดับบริการ ไปยัง app-server อีกครั้ง การเปลี่ยนจาก openai/gpt-5.5 เป็น openai/gpt-5.2 จะคงการผูกเธรดไว้ แต่ขอให้ Codex ดำเนินต่อด้วย โมเดลที่เลือกใหม่

​

การตอบกลับที่มองเห็นได้และ Heartbeat

เมื่อเทิร์นแชทต้นทางทำงานผ่านฮาร์เนส Codex การตอบกลับที่มองเห็นได้จะมีค่าเริ่มต้น เป็นเครื่องมือ message ของ OpenClaw หากการติดตั้งใช้งานไม่ได้กำหนดค่า messages.visibleReplies ไว้อย่างชัดเจน เอเจนต์ยังคงจบเทิร์น Codex ของตนแบบส่วนตัวได้ โดยจะโพสต์ไปยังช่องทางก็ต่อเมื่อเรียก message(action="send") เท่านั้น ตั้งค่า messages.visibleReplies: "automatic" เพื่อคงการตอบกลับสุดท้ายของแชทโดยตรงไว้บน เส้นทางการส่งอัตโนมัติแบบเดิม เทิร์น Heartbeat ของ Codex ยังได้รับ heartbeat_respond ในแค็ตตาล็อกเครื่องมือ OpenClaw ที่ค้นหาได้ตามค่าเริ่มต้นด้วย เพื่อให้เอเจนต์บันทึกได้ว่าการปลุกควรเงียบต่อไป หรือแจ้งเตือน โดยไม่ต้องเข้ารหัสโฟลว์ควบคุมนั้นในข้อความสุดท้าย แนวทางริเริ่มเฉพาะ Heartbeat จะถูกส่งเป็นคำสั่งสำหรับนักพัฒนาของโหมดการทำงานร่วมกัน Codex บนเทิร์น Heartbeat นั้นเอง เทิร์นแชทปกติจะคืนค่าเป็นโหมด Codex Default แทนการพกปรัชญาของ Heartbeat ไว้ในพรอมป์รันไทม์ปกติ

​

ขอบเขตของฮุก

ฮาร์เนส Codex มีชั้นฮุกสามชั้น: OpenClaw ไม่ใช้ไฟล์ hooks.json ระดับโปรเจกต์หรือระดับโกลบอลของ Codex เพื่อกำหนดเส้นทาง พฤติกรรม Plugin ของ OpenClaw สำหรับเครื่องมือเนทีฟและบริดจ์สิทธิ์ที่รองรับ OpenClaw จะฉีดการกำหนดค่า Codex ต่อเธรดสำหรับ PreToolUse, PostToolUse, PermissionRequest และ Stop เมื่อเปิดใช้การอนุมัติของ app-server ใน Codex ซึ่งหมายความว่า approvalPolicy ไม่ใช่ "never" การกำหนดค่าฮุกเนทีฟที่ฉีดตามค่าเริ่มต้นจะละเว้น PermissionRequest เพื่อให้ ผู้ตรวจทาน app-server ของ Codex และบริดจ์การอนุมัติของ OpenClaw จัดการการยกระดับจริง หลังการตรวจทาน ผู้ปฏิบัติงานสามารถเพิ่ม permission_request ไปยัง nativeHookRelay.events ได้อย่างชัดเจนเมื่อจำเป็นต้องใช้รีเลย์ความเข้ากันได้ ฮุก Codex อื่น ๆ เช่น SessionStart และ UserPromptSubmit ยังคงเป็น ตัวควบคุมระดับ Codex ฮุกเหล่านี้ไม่ได้ถูกเปิดเผยเป็นฮุก Plugin ของ OpenClaw ในสัญญา v1 สำหรับเครื่องมือไดนามิกของ OpenClaw นั้น OpenClaw จะดำเนินการเครื่องมือหลังจาก Codex ขอ การเรียก ดังนั้น OpenClaw จึงยิงพฤติกรรม Plugin และมิดเดิลแวร์ที่ตนเป็นเจ้าของใน อะแดปเตอร์ฮาร์เนส สำหรับเครื่องมือเนทีฟของ Codex นั้น Codex เป็นเจ้าของระเบียนเครื่องมือ ตามมาตรฐาน OpenClaw สามารถมิเรอร์เหตุการณ์ที่เลือกได้ แต่ไม่สามารถเขียนเธรด Codex แบบเนทีฟใหม่ เว้นแต่ Codex จะเปิดเผยการดำเนินการนั้นผ่าน app-server หรือคอลแบ็กฮุกเนทีฟ การแจ้งเตือนรายการของ app-server ใน Codex ยังให้ข้อสังเกต after_tool_call แบบอะซิงโครนัสสำหรับการเสร็จสิ้นของเครื่องมือเนทีฟที่ยังไม่ได้ครอบคลุมโดยรีเลย์เนทีฟ PostToolUse ข้อสังเกตเหล่านี้มีไว้เพื่อเทเลเมทรีและความเข้ากันได้ของ Plugin เท่านั้น ไม่สามารถบล็อก หน่วงเวลา หรือแก้ไขการเรียกเครื่องมือเนทีฟได้ การฉายภาพ Compaction และวงจรชีวิต LLM มาจากการแจ้งเตือนของ app-server ใน Codex และสถานะอะแดปเตอร์ OpenClaw ไม่ใช่คำสั่งฮุกเนทีฟของ Codex เหตุการณ์ before_compaction, after_compaction, llm_input และ llm_output ของ OpenClaw เป็นข้อสังเกตระดับอะแดปเตอร์ ไม่ใช่การจับข้อมูลแบบไบต์ต่อไบต์ ของคำขอภายในหรือเพย์โหลด Compaction ของ Codex การแจ้งเตือน app-server แบบ hook/started และ hook/completed ของ Codex แบบเนทีฟ ถูกฉายเป็นเหตุการณ์เอเจนต์ codex_app_server.hook สำหรับทราเจกทอรีและการดีบัก การแจ้งเตือนเหล่านี้ไม่เรียกใช้ฮุก Plugin ของ OpenClaw

​

สัญญาการรองรับ V1

รองรับในรันไทม์ Codex v1: ไม่รองรับในรันไทม์ Codex v1:

​

สิทธิ์เนทีฟและการขอข้อมูลจาก MCP

สำหรับ PermissionRequest นั้น OpenClaw จะส่งคืนเฉพาะการตัดสินใจอนุญาตหรือปฏิเสธ อย่างชัดเจนเมื่อมีนโยบายตัดสิน ผลลัพธ์แบบไม่มีการตัดสินใจไม่ใช่การอนุญาต Codex ถือว่าเป็น ไม่มีการตัดสินใจจากฮุก และปล่อยให้ไหลต่อไปยังเส้นทางผู้คุ้มกันหรือการอนุมัติจากผู้ใช้ของตนเอง Codex app-server จะละเว้นโหมดการอนุมัติของฮุกเนทีฟนี้โดยค่าเริ่มต้น ลักษณะการทำงานนี้ มีผลเมื่อระบุ permission_request ไว้อย่างชัดเจนใน nativeHookRelay.events หรือเมื่อรันไทม์ความเข้ากันได้ติดตั้งไว้ เมื่อผู้ปฏิบัติงานเลือก allow-always สำหรับคำขอสิทธิ์เนทีฟของ Codex OpenClaw จะจดจำลายนิ้วมือของ provider/session/tool input/cwd ที่ตรงนั้นสำหรับ ช่วงเวลาของเซสชันที่จำกัด การตัดสินใจที่จดจำไว้นั้นตั้งใจให้เป็นแบบตรงกันทุกประการ เท่านั้น: คำสั่ง อาร์กิวเมนต์ เพย์โหลดของเครื่องมือ หรือ cwd ที่เปลี่ยนไปจะสร้าง การอนุมัติใหม่ การเรียกขออนุมัติของเครื่องมือ Codex MCP จะถูกส่งผ่านขั้นตอนการอนุมัติ Plugin ของ OpenClaw เมื่อ Codex ทำเครื่องหมาย _meta.codex_approval_kind เป็น "mcp_tool_call" พรอมป์ request_user_input ของ Codex จะถูกส่งกลับไปยัง แชตต้นทาง และข้อความติดตามผลที่อยู่ในคิวถัดไปจะตอบคำขอเซิร์ฟเวอร์เนทีฟนั้น แทนที่จะถูกกำกับเป็นบริบทเพิ่มเติม คำขอเรียกข้อมูล MCP อื่นๆ จะล้มเหลวแบบปิด

​

การกำกับคิว

การกำกับคิวระหว่างการรันที่แอ็กทีฟจะแมปกับ turn/steer ของ Codex app-server ด้วย ค่าเริ่มต้น messages.queue.mode: "steer" OpenClaw จะรวมข้อความแชตที่อยู่ในคิว สำหรับช่วงเงียบที่กำหนดค่าไว้ แล้วส่งเป็นคำขอ turn/steer เดียวตามลำดับที่มาถึง โหมด queue แบบเดิมจะส่งคำขอ turn/steer แยกกัน เทิร์นการรีวิวของ Codex และเทิร์น Compaction แบบกำหนดเองอาจปฏิเสธการกำกับ ในเทิร์นเดียวกันได้ ในกรณีนั้น OpenClaw จะใช้คิวติดตามผลเมื่อโหมดที่เลือกอนุญาต ให้ถอยกลับ ดู คิวการกำกับ

​

การอัปโหลดข้อเสนอแนะของ Codex

เมื่อ /diagnostics [note] ได้รับการอนุมัติสำหรับเซสชันที่ใช้ Codex harness แบบเนทีฟ OpenClaw จะเรียก Codex app-server feedback/upload สำหรับเธรด Codex ที่เกี่ยวข้องด้วย การอัปโหลดจะขอให้ app-server รวมล็อกสำหรับแต่ละเธรดที่ระบุไว้ และเธรดย่อยของ Codex ที่ถูกสร้างขึ้นเมื่อมีอยู่ การอัปโหลดจะผ่านเส้นทางข้อเสนอแนะปกติของ Codex ไปยังเซิร์ฟเวอร์ OpenAI หากปิด ข้อเสนอแนะของ Codex ใน app-server นั้น คำสั่งจะส่งคืนข้อผิดพลาดของ app-server การตอบกลับ diagnostics ที่เสร็จสมบูรณ์จะแสดงรายการช่องทาง, รหัสเซสชัน OpenClaw, รหัสเธรด Codex และคำสั่ง codex resume <thread-id> ในเครื่องสำหรับเธรดที่ถูกส่ง หากคุณปฏิเสธหรือเพิกเฉยต่อการอนุมัติ OpenClaw จะไม่พิมพ์รหัส Codex เหล่านั้นและ จะไม่ส่งข้อเสนอแนะของ Codex การอัปโหลดนี้ไม่ได้แทนที่การส่งออก diagnostics ของ Gateway ในเครื่อง ดู การส่งออก diagnostics สำหรับการอนุมัติ ความเป็นส่วนตัว บันเดิลในเครื่อง และลักษณะการทำงานของแชตกลุ่ม ใช้ /codex diagnostics [note] เฉพาะเมื่อคุณต้องการอัปโหลดข้อเสนอแนะของ Codex สำหรับเธรดที่แนบอยู่ในปัจจุบันโดยเฉพาะ โดยไม่ใช้บันเดิล diagnostics ของ Gateway แบบเต็ม

​

Compaction และมิเรอร์ทรานสคริปต์

เมื่อโมเดลที่เลือกใช้ Codex harness การทำ Compaction เธรดเนทีฟจะมอบหมายให้ Codex app-server OpenClaw จะเก็บมิเรอร์ทรานสคริปต์ไว้สำหรับประวัติช่องทาง การค้นหา /new, /reset และการสลับโมเดลหรือ harness ในอนาคต มิเรอร์จะรวมพรอมป์ของผู้ใช้ ข้อความสุดท้ายของผู้ช่วย และระเบียนการให้เหตุผลหรือ แผนของ Codex แบบเบาเมื่อ app-server ส่งออกมา ปัจจุบัน OpenClaw บันทึกเฉพาะ สัญญาณเริ่มต้นและเสร็จสิ้นของ Compaction แบบเนทีฟเท่านั้น ยังไม่ได้เปิดเผยสรุป Compaction ที่มนุษย์อ่านได้ หรือรายการที่ตรวจสอบได้ว่า Codex เก็บรายการใดไว้ หลัง Compaction เนื่องจาก Codex เป็นเจ้าของเธรดเนทีฟตามบัญญัติ tool_result_persist จึงยังไม่ เขียนระเบียนผลลัพธ์เครื่องมือแบบเนทีฟของ Codex ใหม่ในขณะนี้ โดยจะมีผลเฉพาะเมื่อ OpenClaw กำลังเขียนผลลัพธ์เครื่องมือในทรานสคริปต์เซสชันที่ OpenClaw เป็นเจ้าของ

​

สื่อและการนำส่ง

OpenClaw ยังคงเป็นเจ้าของการนำส่งสื่อและการเลือกผู้ให้บริการสื่อ รูปภาพ วิดีโอ เพลง PDF, TTS และการทำความเข้าใจสื่อจะใช้การตั้งค่า provider/model ที่ตรงกัน เช่น agents.defaults.imageGenerationModel, videoGenerationModel, pdfModel และ messages.tts ข้อความ รูปภาพ วิดีโอ เพลง TTS การอนุมัติ และเอาต์พุตของเครื่องมือส่งข้อความ ยังคงผ่านเส้นทางการนำส่งปกติของ OpenClaw การสร้างสื่อไม่จำเป็นต้องใช้ PI เมื่อ Codex ส่งรายการสร้างรูปภาพแบบเนทีฟที่มี savedPath OpenClaw จะส่งต่อไฟล์ นั้นตามจริงผ่านเส้นทางตอบกลับสื่อปกติ แม้ว่าเทิร์นของ Codex จะไม่มีข้อความผู้ช่วยก็ตาม

​

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

• Codex harness
• อ้างอิง Codex harness
• Plugin Codex แบบเนทีฟ
• ฮุก Plugin
• Plugin สำหรับ Agent harness
• การส่งออก diagnostics
• การส่งออก trajectory