Codex harness | Fivey Can Read OpenClaw

先讲这一页到底在解决什么

Codex 接管底层 Agent 线程，OpenClaw 继续负责外层调度

启用内置 codex 插件后，OpenClaw 可以把 OpenAI agent turn 交给 Codex app-server 运行：原生线程恢复、工具续跑、原生压缩和 app-server 执行由 Codex 负责；聊天频道、会话文件、动态工具、审批、媒体和可见消息仍由 OpenClaw 负责。配置时用 openai/gpt-* 模型引用，别再新写 openai-codex/gpt-*。

原文共 17 节，先看 Start Here 路径：/plugins/codex-harness 查看官方原文

先分工

Codex 管原生线程，OpenClaw 管外面的世界

这页最容易理解错的地方，是把 Codex harness 当成“换一个 provider”。其实更像换了底层驾驶舱：模型调用和线程循环交给 Codex，外层产品能力还在 OpenClaw。

Codex owns

原生 thread、native model loop、tool continuation、native compaction。

OpenClaw owns

频道、session 文件、动态工具、审批、媒体和可见 transcript mirror。

模型写法

常规写 openai/gpt-5.5 这类 canonical OpenAI model ref，不要新写 openai-codex/gpt-*。

runtime 写法

codex 是 runtime。Telegram、Discord、Slack 等仍只是外面的聊天入口。

快速开始

登录、启插件、选模型，然后重启 Gateway

大多数用户走这条路：先用 Codex OAuth 登录，再启用 bundled codex 插件，把 agent model 设成 openai/gpt-*。

1

登录 Codex

openclaw models auth login --provider openai-codex 像给 Codex app-server 准备账号。

2

启用插件

在 plugins.entries.codex.enabled 里打开。如果用了 plugins.allow，也要把 codex 放进去。

3

选择模型

把默认模型设成 openai/gpt-5.5 或其他 openai/gpt-* agent model。

4

重启和新会话

改插件配置后重启 Gateway；已有聊天用 /new 或 /reset 测试新 runtime。

路由规则

别把 provider、model ref 和 runtime 混成一团

openai/gpt-* 是模型引用，codex 是运行时。API key fallback 也只是认证备选，不表示自动切回 PI 或普通 OpenAI Responses。

auth.order.openai

推荐把订阅登录和 API key 备选放在 OpenAI auth 顺序下。旧的 openai-codex 资料仍兼容，但新配置不要继续扩散旧 model ref。

agentRuntime.id

普通 OpenAI auto mode 不一定要写；想在 Codex 不可用时 fail closed，明确写 "codex" 更清楚。

agentRuntime.id: "pi"

表示故意走直接 PI 行为，不是 Codex harness。

ACP/acpx

这是另一条外部 harness 路。用户明确要 ACP、Claude Code、Copilot 或 Cursor 接入时，再看 ACP setup。

压缩和上下文

Codex 默认自己压缩，除非 OpenClaw 的 context engine 明确接管

不要在 Codex-backed agent 上随手设置 compaction.model 或 compaction.provider。没有 context engine 接管时，Codex 会通过 app-server native thread state 做自己的压缩。

Codex native compaction

像 Codex 自己整理工作笔记，OpenClaw 不再叠一层本地 summarizer。

Lossless context engine

如果用 lossless-claw，应通过 plugins.slots.contextEngine 和插件 config 配置。

ownsCompaction: true

当 context engine 说“压缩我来管”，OpenClaw 会让下一次 Codex turn 从 engine 管理的上下文重新开始。

doctor --fix

可以修复 legacy refs 和旧 compaction 配置形状，减少“看起来能跑、实际走错路”的配置。

怎么确认

先看 `/status`，再看 `/codex status`

在你期待走 Codex 的聊天里，/status 应该显示 Runtime: OpenAI Codex。然后用 /codex status 看 app-server 连接、账号、rate limit、MCP servers 和 skills。

/codex models

列出当前 harness 和账号能看到的 live Codex app-server 模型目录。

如果结果意外

检查插件是否启用、plugins.allow 是否挡住、旧 session 是否 pin 住旧 route、model ref 是否写错。

最后记住

Codex harness 的核心不是“换名字”，而是“谁掌握 agent loop”

选 openai/gpt-*，启 codex runtime，让 Codex 管原生线程；OpenClaw 继续管产品外壳、工具接线、审批、媒体和可见聊天。