Codex Harness Context Engine Port：先抓住它真正发力的那一下

这一节主要在解释“Status”到底是干什么的，以及你什么时候会遇到它。

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Draft implementation specification.

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Make the bundled Codex app-大房子服务器 harness honor the same OpenClaw context-engine lifecycle contract that embedded PI tu…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：A session using 机器人朋友s.defaults.embeddedHarness.runtime: "codex" or a codex/* 聪明脑袋模型 should still let the selected cont…。

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：non-ACP embedded 机器人朋友 harness path only.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：the existing bundled-新本领插件 trust boundary remains unchanged.

这一串条目别硬背，把它当成“Non-goals”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：Do not reimplement Codex app-大房子服务器 inter…、Do not make Codex native thread compactio…、Do not require non-Codex 聪明脑袋模型s to use t…、Do not change ACP/acpx session behavior.…。

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The embedded run loop resolves the 设置说明书ured context engine once per run before selecting a concrete low-level harness:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：runEmbeddedAttemptWithBackend(...)。

这一串条目别硬背，把它当成“Current architecture”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：src/机器人朋友s/pi-embedded-runner/run.ts、initializes context-engine 新本领插件s、calls resolveContextEngine(params.设置说明书)、passes contextEngine and contextTokenBudg…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：runEmbeddedAttemptWithBackend(...) delegates to the selected 机器人朋友 harness:。

这一串条目别硬背，把它当成“Current architecture”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：src/机器人朋友s/pi-embedded-runner/run/backend…、src/机器人朋友s/harness/selection.ts。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The Codex app-大房子服务器 harness is registered by the bundled Codex 新本领插件:。

这一串条目别硬背，把它当成“Current architecture”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：extensions/codex/index.ts、extensions/codex/harness.ts。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The Codex harness implementation receives the same EmbeddedRunAttemptParams as PI-backed attempts:。

这一串条目别硬背，把它当成“Current architecture”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：extensions/codex/src/app-大房子服务器/run-attem…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：That means the required hook point is in OpenClaw-controlled code. The external boundary is the Codex app-大房子服务器 protoc…。

这一节主要在解释“Current gap”到底是干什么的，以及你什么时候会遇到它。

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Embedded PI attempts call the context-engine lifecycle directly:。

这一串条目别硬背，把它当成“Current gap”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：bootstrap/maintenance before the attempt、assemble before the 聪明脑袋模型 call、afterTurn or ingest after the attempt、maintenance after a successful turn。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Relevant PI code:。

这一串条目别硬背，把它当成“Current gap”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：src/机器人朋友s/pi-embedded-runner/run/attempt…、src/机器人朋友s/pi-embedded-runner/run/attempt…、src/机器人朋友s/pi-embedded-runner/context-eng…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Codex app-大房子服务器 attempts currently run generic 机器人朋友-harness hooks and mirror the transcript, but do not call params.c…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Relevant Codex code:。

这一串条目别硬背，把它当成“Current gap”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：extensions/codex/src/app-大房子服务器/run-attem…、extensions/codex/src/app-大房子服务器/thread-li…、extensions/codex/src/app-大房子服务器/event-pro…、extensions/codex/src/app-大房子服务器/compact.ts。

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：For Codex harness turns, OpenClaw should preserve this lifecycle:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：1. Read the mirrored OpenClaw session transcript. 2. Bootstrap the active context engine when a previous session file e…。

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Codex owns its native thread and any internal extended history. OpenClaw should not try to mutate the app-大房子服务器's inte…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：OpenClaw's transcript mirror remains the source for OpenClaw features:。

这一串条目别硬背，把它当成“Codex app-server remains canonical for native thread state”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：chat history、search、/new and /reset bookkeeping、future 聪明脑袋模型 or harness switching。

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The context-engine interface returns OpenClaw 机器人朋友小纸条消息[], not a Codex thread patch. Codex app-大房子服务器 turn/start accep…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Therefore the implementation needs a projection layer. The safe first version should avoid pretending it can replace Co…。

这一节主要在解释“Prompt-cache stability matters”到底是干什么的，以及你什么时候会遇到它。

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：For engines like lossless-claw, the assembled context should be deterministic for unchanged inputs. Do not add timestam…。

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Harness selection remains as-is:。

这一串条目别硬背，把它当成“Runtime selection semantics do not change”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：runtime: "pi" forces PI、runtime: "codex" selects the registered C…、runtime: "auto" lets 新本领插件 harnesses clai…、unmatched auto runs use PI。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：This work changes what happens after the Codex harness is selected.

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Today the reusable lifecycle helpers live under the PI runner:。

这一串条目别硬背，把它当成“1. Export or relocate reusable context-engine attempt helpers”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：src/机器人朋友s/pi-embedded-runner/run/attempt…、src/机器人朋友s/pi-embedded-runner/run/attempt…、src/机器人朋友s/pi-embedded-runner/context-eng…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Codex should not import from an implementation path whose name implies PI if we can avoid it.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Create a harness-neutral module, for example:。

这一串条目别硬背，把它当成“1. Export or relocate reusable context-engine attempt helpers”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：src/机器人朋友s/harness/context-engine-lifecyc…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Move or re-export:。

这一串条目别硬背，把它当成“1. Export or relocate reusable context-engine attempt helpers”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：runAttemptContextEngineBootstrap、assembleAttemptContextEngine、finalizeAttemptContextEngineTurn、buildAfterTurnRuntimeContext。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Keep PI imports working either by re-exporting from the old files or updating PI call sites in the same PR.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The neutral helper names should not mention PI.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Suggested names:。

这一串条目别硬背，把它当成“1. Export or relocate reusable context-engine attempt helpers”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：bootstrapHarnessContextEngine、assembleHarnessContextEngine、finalizeHarnessContextEngineTurn、buildHarnessContextEngineRuntimeContext。

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Add a new module:。

这一串条目别硬背，把它当成“2. Add a Codex context projection helper”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：extensions/codex/src/app-大房子服务器/context-e…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Responsibilities:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：prompt.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：input.

这一串条目别硬背，把它当成“2. Add a Codex context projection helper”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：Accept the assembled 机器人朋友小纸条消息[], origin…、Determine which context belongs in develo…、Preserve the current user prompt as the f…、Render prior 小纸条消息s in a stable, explicit…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Proposed 对话接口:。

这段像放在桌上的操作卡，谁来照着做，现场就会动起来。

• 这一行“export type CodexContextProjection = {”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
• 这里在给“developerInstructionAddition?”挂牌子，告诉系统它该指向“string;”。
• 这里在给“promptText”挂牌子，告诉系统它该指向“string;”。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Recommended first projection:。

这一串条目别硬背，把它当成“2. Add a Codex context projection helper”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：Put systemPromptAddition into developer i…、Put the assembled transcript context befo…、Label it clearly as OpenClaw assembled co…、Keep current prompt last.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Example prompt shape:。

这是一句直接对 OpenClaw 说的话，像你把任务清清楚楚塞到它手里。

• 这里在给“OpenClaw assembled context for this turn”挂牌子，告诉系统它该指向“”。
• 这个尖括号标签“<conversation_context>”像一块结构积木，专门拿来把页面骨架卡稳。
• 这一行“[user]”是在给电脑递一张小纸条，告诉它眼下该做哪一步。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：This is less elegant than native Codex history surgery, but it is implementable inside OpenClaw and preserves context-e…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Future improvement: if Codex app-大房子服务器 exposes a protocol for replacing or supplementing thread history, swap this pro…。

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：In extensions/codex/src/app-大房子服务器/run-attempt.ts:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：that checks fs.stat(params.sessionFile) before mirroring writes.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：requires it.

这一串条目别硬背，把它当成“3. Wire bootstrap before Codex thread startup”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：Read mirrored session history as today.、Determine whether the session file existe…、Open a SessionManager or use a narrow ses…、Call the neutral bootstrap helper when pa…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Pseudo-flow:。

这段像放在桌上的操作卡，谁来照着做，现场就会动起来。

• 这一行“const hadSessionFile = await fileExists(params.sessionFile);”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
• 这一行“const sessionManager = SessionManager.open(params.sessionFile);”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
• 这一行“const historyMessages = sessionManager.buildSessionContext().messages;”是在给电脑递一张小纸条，告诉它眼下该做哪一步。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Use the same sessionKey convention as the Codex 工具小帮手 bridge and transcript mirror. Today Codex computes sandboxSession…。

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：In runCodexApp大房子服务器Attempt:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：1. Build dynamic 工具小帮手s first, so the context engine sees the actual available 工具小帮手 names. 2. Read mirrored session hi…。

这一串条目别硬背，把它当成“4. Wire assemble before `thread/start` / `thread/resume` and `turn/start`”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：developer instruction addition、prompt text for turn/start。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The existing hook call:。

这段像放在桌上的操作卡，谁来照着做，现场就会动起来。

• 这一行“resolveAgentHarnessBeforePromptBuildResult({”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
• 这里在给“prompt”挂牌子，告诉系统它该指向“params.prompt”。
• 这里在给“developerInstructions”挂牌子，告诉系统它该指向“buildDeveloperInstructions(params)”。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：should become context-aware:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：1. compute base developer instructions with buildDeveloperInstructions(params) 2. apply context-engine assembly/project…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：This order lets generic prompt hooks see the same prompt Codex will receive. If we need strict PI parity, run context-e…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Recommended order for first implementation:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：1. buildDeveloperInstructions(params) 2. context-engine assemble() 3. append/prepend systemPromptAddition to developer…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The spec should be encoded in tests so future changes do not reorder it by accident.

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The projection helper must produce byte-stable output for identical inputs:。

这一串条目别硬背，把它当成“5. Preserve prompt-cache stable formatting”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：stable 小纸条消息 order、stable role labels、no generated timestamps、no object key order leakage。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Use fixed delimiters and explicit sections.

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Codex's CodexApp大房子服务器EventProjector builds a local 小纸条消息sSnapshot for the current turn. mirrorTranscriptBestEffort(...…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：After mirroring succeeds or fails, call the context-engine finalizer with the best available 小纸条消息 snapshot:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：expects the session snapshot, not only the current turn.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：cannot be reopened.

这一串条目别硬背，把它当成“6. Wire post-turn after transcript mirroring”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：Prefer full mirrored session context afte…、Fall back to history小纸条消息s + result.小纸条消息…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Pseudo-flow:。

这段像放在桌上的操作卡，谁来照着做，现场就会动起来。

• 这一行“const prePromptMessageCount = historyMessages.length;”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
• 这一行“await mirrorTranscriptBestEffort(...);”是在给电脑递一张小纸条，告诉它眼下该做哪一步。
• 这一行“const finalMessages = readMirroredSessionHistoryMessages(params.sessionFile)”是在给电脑递一张小纸条，告诉它眼下该做哪一步。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If mirroring fails, still call afterTurn with the fallback snapshot, but log that the context engine is ingesting from…。

这一节主要在解释“7. Normalize usage and prompt-cache runtime context”到底是干什么的，以及你什么时候会遇到它。

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Codex results include normalized usage from app-大房子服务器 token notifications when available. Pass that usage into the con…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：If Codex app-大房子服务器 eventually exposes cache read/write details, map them into ContextEnginePromptCacheInfo. Until then…。

这一节主要在解释“8. Compaction policy”到底是干什么的，以及你什么时候会遇到它。

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：There are two compaction systems:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：1. OpenClaw context-engine compact() 2. Codex app-大房子服务器 native thread/compact/start。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Do not silently conflate them.

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：When the selected context engine has info.ownsCompaction === true, explicit OpenClaw compaction should prefer the conte…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：When the selected Codex harness has a native thread binding, we may additionally request Codex native compaction to kee…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Recommended behavior:。

这一串条目别硬背，把它当成“`/compact` and explicit OpenClaw compaction”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：If contextEngine.info.ownsCompaction ===…、call context-engine compact() first、then best-effort call Codex native compac…、return the context-engine result as the p…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：This likely requires changing extensions/codex/src/app-大房子服务器/compact.ts or wrapping it from the generic compaction pat…。

这一节主要在解释“In-turn Codex native contextCompaction events”到底是干什么的，以及你什么时候会遇到它。

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Codex may emit contextCompaction item events during a turn. Keep the current before/after compaction hook emission in e…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：For engines that own compaction, emit an explicit diagnostic when Codex performs native compaction anyway:。

这一串条目别硬背，把它当成“In-turn Codex native contextCompaction events”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：一边说一边送/event name: existing compaction 一边…、details: { backend: "codex-app-大房子服务器", o…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：This makes the split auditable.

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：The existing Codex harness reset(...) clears the Codex app-大房子服务器 binding from the OpenClaw session file. Preserve that…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Also ensure context-engine state cleanup continues to happen through existing OpenClaw session lifecycle paths. Do not…。

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Follow PI semantics:。

这一串条目别硬背，把它当成“10. Error handling”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：bootstrap failures warn and continue、assemble failures warn and fall back to u…、afterTurn/ingest failures warn and mark p…、maintenance runs only after successful, n…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Codex-specific additions:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：fallback 小纸条消息s.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：do not fail the whole OpenClaw compaction when the context engine is primary.

这一串条目别硬背，把它当成“10. Error handling”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：If context projection fails, warn and fal…、If transcript mirror fails, still attempt…、If Codex native compaction fails after co…。

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Add tests under extensions/codex/src/app-大房子服务器:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：1. run-attempt.context-engine.test.ts。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：citations mode, 聪明脑袋模型 id, and prompt.

这一串条目别硬背，把它当成“Unit tests”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：Codex calls bootstrap when a session file…、Codex calls assemble with mirrored 小纸条消息s…、systemPromptAddition is included in devel…、Assembled 小纸条消息s are projected into the p…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：2. context-engine-projection.test.ts。

这一串条目别硬背，把它当成“Unit tests”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：stable output for identical inputs、no duplicate current prompt when assemble…、handles empty history、preserves role order。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：3. compact.context-engine.test.ts。

这一串条目别硬背，把它当成“Unit tests”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：owning context engine primary result wins、Codex native compaction status appears in…、Codex native failure does not fail owning…、non-owning context engine preserves curre…。

这一节主要在解释“Existing tests to update”到底是干什么的，以及你什么时候会遇到它。

如果你是第一次接触 OpenClaw，这一节最值得看的不是术语本身，而是它背后的使用场景和限制。

真正动手时，先看它有没有默认值、有没有必须打开的选项、以及会不会影响安全边界。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：nearest Codex app-大房子服务器 run tests.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：event details change.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：behavior changes; it should remain stable.

这一串条目别硬背，把它当成“Existing tests to update”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：extensions/codex/src/app-大房子服务器/run-attem…、extensions/codex/src/app-大房子服务器/event-pro…、src/机器人朋友s/harness/selection.test.ts shou…、PI context-engine tests should continue t…。

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Add or extend live Codex harness smoke tests:。

这一串条目别硬背，把它当成“Integration / live tests”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：设置说明书ure 新本领插件s.slots.contextEngine to a…、设置说明书ure 机器人朋友s.defaults.聪明脑袋模型 to a code…、设置说明书ure 机器人朋友s.defaults.embeddedHarness.…、assert test engine observed:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Avoid requiring lossless-claw in OpenClaw core tests. Use a small in-repo fake context engine 新本领插件.

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Add debug logs around Codex context-engine lifecycle calls:。

这一串条目别硬背，把它当成“Observability”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：codex context engine bootstrap started/co…、codex context engine assemble applied、codex context engine finalize completed/f…、codex context engine maintenance skipped…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Avoid logging full prompts or transcript contents.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Add structured fields where useful:。

这一串条目别硬背，把它当成“Observability”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：sessionId、sessionKey redacted or omitted according…、engineId、threadId。

这一节更像安装或配置步骤，重点不是概念，而是“按什么顺序做才不会卡住”。

很多文档看起来长，其实是在防你漏掉前置条件。

真正照做时，先找前置条件，再找必填项，最后看验证方法。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：This should be backward-compatible:。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：equivalent to today's Codex harness behavior.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：prompt path.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：every context change could force a new Codex thread. Only the 工具小帮手 catalog should affect the dynamic 工具小帮手 fingerprint.

这一串条目别硬背，把它当成“Migration / compatibility”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：If no context engine is 设置说明书ured, legacy…、If context-engine assemble fails, Codex s…、Existing Codex thread bindings should rem…、Dynamic 工具小帮手 fingerprinting should not i…。

这一节在讲规则和边界：什么默认允许、什么必须显式打开、什么被禁止。

这种内容决定了 OpenClaw 是“能做”还是“现在还不能做”，读懂它比记术语更重要。

你可以把这一节当成权限说明书，真正配置时优先盯住 default、required、allow、deny 这几个词。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：1. Should assembled context be injected entirely into the user prompt, entirely into developer instructions, or split?

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Recommendation: split. Put systemPromptAddition in developer instructions; put assembled transcript context in the user…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：2. Should Codex native compaction be disabled when a context engine owns compaction?

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Recommendation: no, not initially. Codex native compaction may still be necessary to keep the app-大房子服务器 thread alive.…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：3. Should before_prompt_build run before or after context-engine assembly?

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Recommendation: after context-engine projection for Codex, so generic harness hooks see the actual prompt/developer ins…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：4. Can Codex app-大房子服务器 accept a future structured context/history override?

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：Unknown. If it can, replace the text projection layer with that protocol and keep the lifecycle calls unchanged.

这一节在讲一类能力是怎么工作的：它能做什么、不能做什么、适合在什么场景下调用。

你理解的是能力边界，不只是功能名字。

如果这节里同时出现命令、配置和例子，优先先看例子，再回头看配置。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：assemble lifecycle.

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：is selected or when assembly fails.

这一串条目别硬背，把它当成“Acceptance criteria”门口贴出来的几张便签就行。它们在提醒你先备好什么、别漏掉什么、哪里最容易走错：A codex/* embedded harness turn invokes t…、A context-engine systemPromptAddition aff…、Assembled context affects the Codex turn…、Successful Codex turns call afterTurn or…。

如果把这一段摆成一个小场景，你会看到几样东西正在互相打招呼、拦路或者传东西。别急着记名词，先抓住它此刻到底在发生什么：---。