概述
Codex Harness 运行时文档，描述 Codex 模式下的运行时契约：钩子层边界、工具支持范围、权限处理、队列转向、诊断上传和压缩机制。Codex 模式不是”换了个模型调用的 PI”——Codex 拥有更多原生模型循环控制权。
核心功能
- 三层钩子架构：OpenClaw 插件钩子（跨 PI/Codex 兼容）、Codex app-server 扩展中间件（per-turn 适配）、Codex 原生钩子（低级生命周期）
- V1 支持契约：支持 OpenAI 模型循环、OpenClaw 动态工具、提示/上下文插件、动态工具钩子、最终答案修订门、原生 shell/patch/MCP 阻断或观察
- V1 不支持：原生工具参数改写、可编辑 Codex 原生转录历史、
tool_result_persist用于 Codex 原生工具记录、丰富的原生压缩元数据 - 队列转向：活跃运行的队列转向映射到 Codex app-server
turn/steer，默认steer模式批量发送 - Codex 反馈上传：
/diagnostics批准后，调用feedback/upload将相关 Codex 线程日志发送到 OpenAI - 压缩与转录镜像：Codex 拥有原生线程压缩；OpenClaw 保留转录镜像用于 channel 历史、搜索、
/new、/reset
配置/使用
可见回复行为：
- Codex harness 轮次默认使用
message工具发送可见回复 - 设置
messages.visibleReplies: "automatic"可保持旧版自动投递路径
原生权限处理：
PermissionRequest：仅在策略决定时返回明确允许/拒绝，无决定则 Codex 自行处理allow-always决定仅在精确匹配（provider/session/tool input/cwd 指纹）时记忆，有效期为有界会话窗口
媒体投递：
- 图像、视频、音乐、PDF、TTS、媒体理解继续通过 OpenClaw provider/model 设置处理
- Codex 原生图像生成 item 的
savedPath通过正常回复媒体路径转发
相关页面
- concepts/plugin-codex-harness — Codex Harness 入门与路由
- concepts/plugin-codex-harness-reference — 完整配置字段参考
- concepts/plugin-hooks — 插件钩子系统
- queue-steering — 队列转向机制