跳转至

V1 支持契约

Codex 运行时 v1 支持与不支持的表面。本文是 Codex harness 运行时 指南的一部分;各章节迁移位置 列出了每个章节。

V1 支持契约

Codex 运行时 v1 中受支持的表面:

表面 支持情况 原因
通过 Codex 的 OpenAI 模型循环 支持 Codex app-server 负责 OpenAI 回合、原生线程恢复和原生工具延续。
OpenClaw 频道路由与投递 支持 Telegram、Discord、Slack、WhatsApp、iMessage 和其他频道保持在模型运行时之外。
OpenClaw 动态工具 支持 Codex 请求 OpenClaw 执行这些工具,因此 OpenClaw 保持在执行路径中。
Prompt 与上下文插件 支持 OpenClaw 将 OpenClaw 特有的 Prompt/上下文注入 Codex 回合,同时通常将 Codex 拥有的基础 Prompt、模型 Prompt 和已配置的项目文档 Prompt 保留在原生 Codex 通道中。对于没有原生文件系统环境的普通策略受限回合,OpenClaw 将有界工作区的 AGENTS.md 快照作为线程级开发者指令携带。Ring-zero 和其他上下文受限的内部模式会抑制这两条路径。OpenClaw 会为原生线程禁用 Codex 的内置人格,因此 Agent 工作区人格文件保持权威性。原生 Codex 开发者指令仅接受明确限定于 codex_app_server 的命令指导;遗留的全局命令提示保留用于非 Codex 的 Prompt 表面。
上下文引擎生命周期 支持 组装、摄取和回合后维护围绕 Codex 回合运行。上下文引擎不会取代原生 Codex 压缩。
动态工具钩子 受支持 before_tool_call、after_tool_call 及工具结果中间件围绕 OpenClaw 拥有的动态工具运行。
生命周期钩子 以适配器观测形式受支持 llm_input、llm_output、agent_end、before_compaction 与 after_compaction 会以真实的 Codex 模式负载触发。
最终答案修订门控 通过原生钩子中继受支持 Codex Stop 会被中继到 before_agent_finalize;revise 会在最终确定前请求 Codex 再执行一次模型推理。
原生 shell、补丁与 MCP 的阻止或观察 通过原生钩子中继受支持 Codex PreToolUse 与 PostToolUse 会被中继到已绑定的原生工具接口,包括固定 Codex 应用服务器上的 MCP 负载。支持阻止;不支持参数重写。
原生权限策略 通过 Codex 应用服务器审批及兼容性原生钩子中继受支持 Codex 应用服务器审批请求在 Codex 审查后通过 OpenClaw 路由。PermissionRequest 原生钩子中继在原生审批模式下为可选启用,因为 Codex 会在守护审查之前发出它。
app-server 轨迹捕获 支持 OpenClaw 会记录它发送给 app-server 的请求,以及它收到的 app-server 通知。

Codex 运行时 v1 中不支持:

方面 V1 边界 未来路径
原生工具参数修改 Codex 原生预工具钩子可以阻止,但 OpenClaw 不会重写 Codex 原生的工具参数。 需要 Codex 钩子/模式(schema)支持替代工具输入。
可编辑的 Codex 原生记录历史 Codex 拥有规范的原生线程历史。OpenClaw 拥有一份镜像,并且可以投射未来上下文,但不应修改不受支持的内部结构。 如果需要修改原生线程,请添加显式的 Codex app-server API。
用于 Codex 原生工具记录的 tool_result_persist 该钩子转换的是 OpenClaw 拥有的记录写入,而不是 Codex 原生的工具记录。 可以镜像转换后的记录,但规范重写需要 Codex 支持。
丰富的原生压缩元数据 OpenClaw 可以请求原生压缩,但不会收到稳定的保留/丢弃列表、token 增量、完成摘要或摘要负载。 需要更丰富的 Codex 压缩事件。
压缩干预 OpenClaw 不允许插件或上下文引擎否决、重写或替换原生的 Codex 压缩。 如果插件需要否决或重写原生压缩,请添加 Codex 压缩前/后钩子。
逐字节的模型 API 请求捕获 OpenClaw 可以捕获 app-server 的请求和通知,但最终的 OpenAI API 请求由 Codex 核心在内部构建。 需要 Codex 模型请求追踪事件或调试 API。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw