跳转至

Codex harness 运行时

Codex harness 回合的运行时契约。有关设置和路由,参见 Codex harness。有关配置字段,参见 Codex harness reference。

概述

Codex 负责原生模型循环、原生线程恢复、原生工具接续和原生压缩。OpenClaw 负责频道路由、会话文件、可见消息投递、OpenClaw 动态工具、审批、媒体投递,以及围绕该边界的转录镜像。

成功的 /btw 侧边问题会将聚合用量上报给回复用量钩子;当诊断启用时,还会上报 model.usage 事件。总量包括缓存读取、缓存写入,以及侧边线程原生工具循环中每次已完成的模型调用;重放的响应 ID 只计一次。可见回复仍然只包含最后一个答案,主会话的用量和上下文快照保持不变。

对于原生已连接应用,Codex 还拥有最终的每线程应用和工具策略。OpenClaw 缓存一个以运行时和工作区为作用域的 plugin/installed 快照,读取确切配置的插件详情,临时只接纳明确允许且所有权已验证的应用,并创建一个默认拒绝的原生线程。一次 app/installed 请求即可验证实际线程 ID,而不会强制刷新清单。缺失、禁用或不可调用的应用会产生一条警告;会话会继续使用其余工具。Codex 仍会对实际线程强制执行应用和工具权限。

此项检查在 OpenClaw 注入历史、开始一个回合或提交线程绑定之前完成。如果快照请求失败,持久性暂定线程会被删除,临时线程会被取消订阅。当无法确认安全清理时,OpenClaw 会退役应用服务器连接。受监督的分支也会清理其临时检查,并在清理失败时保留恢复状态。

账户级应用访问不能覆盖显式禁用的已配置工作区插件。OpenClaw 使用其已安装快照,并且只读取该确切插件的详情来识别并拒绝其应用;它从不扫描无关的市场,也不会激活该插件。

提示词路由遵循所选运行时,而不仅仅是提供方字符串。原生 Codex 回合获得 Codex 应用服务器开发者指令;显式的 OpenClaw 兼容性路由会保留正常的 OpenClaw 系统提示,即使它使用 Codex 风格的 OpenAI 认证或传输方式。

OpenClaw 以禁用 Codex 内置人格的方式(personality: "none")启动和恢复原生 Codex 线程,从而使工作区人格文件和 OpenClaw 代理身份保持权威。除此之外,原生 Codex 保留 Codex 拥有的基础/模型指令和项目文档加载。普通的受策略限制回合没有原生文件系统环境,因此 OpenClaw 改为将有界工作区的 AGENTS.md 快照作为线程级开发者指令携带。轻量级、ring-zero、仅消息和禁用工具的内部回合会抑制项目文档加载以及上述回退载体。

OpenClaw 开发者指令涵盖 OpenClaw 运行时相关事项:源频道投递、OpenClaw 动态工具、ACP 委托、适配器上下文,以及当前代理工作区配置文件。对于由 OpenClaw 管理的直接 stdio 应用服务器(包括为 Computer Use 选择的 Desktop 可执行文件),技能目录、人格文件、内存提供方指令,以及工具路由的 MEMORY.md 指南会由私有推理中继追加到父模型请求指令中。原生基础指令和目录指令保持不变;此新上下文不会写入原生对话历史,也不会被原生子代理自动继承。没有该中继的连接改为在线程开发者指令中携带符合条件的技能、人格和内存,从而在模型拥有协作模式指令时保留投递能力。原生子代理可以继承该回退上下文;选定的个人 users/<profile-id>/USER.md 覆盖层被排除,并且需要受管理的仅父代理中继。有关回退刷新和继承语义,参见 工作区引导文件。处于激活状态的 BOOTSTRAP.md,以及在内存工具不可用时,有界的 MEMORY.md 内容会作为普通回合输入引用传递。它们会在新原生线程上、冷恢复或原生压缩之后,以及渲染内容发生变化时被引入。一旦完整块已提交,连续的热回合会省略未变化的引用。因提示词适配而被丢弃或截断的引用会在后续回合中重新引入。当 Gateway 重启时,进程本地跟踪会重置。

内存插件在准备其指令时会接收完整的可用工具集,包括延迟的插件工具。该策略不依赖于旧的内存工具名称或工作区文件路由。

自定义命令、Desktop 代理附件、外部 Unix/WebSocket 应用服务器连接、非 OpenAI 原生提供方、自定义上游端点、不受支持的原生账户、锁定上游,以及原生 features.respect_system_proxy 配置文件,都使用线程开发者载体。受管理的中继请求使用 Gateway 的 HTTP(S) 代理和 TLS 配置,而不会更改原生网络设置。OpenClaw 保持原生网络和账户配置不变。现有历史(包括任何较旧的嵌入人格或显式共享的任务文本)都会被保留;这不是一次追溯性历史清理。参见 工作区引导文件。

投递模式和当前消息目标要求会在每个用户回合之前以紧凑的应用上下文形式到达。它们显式取代先前的投递指引,同时保留权限和时间上下文。在可用工具相同的情况下,在自动回复和仅消息工具回复之间切换时,静态指令和消息工具定义保持不变。如果在仅消息工具的回合中消息工具不可用,最终文本仍对发起工作流私有;它不会被投递到源会话。

当 openclaw_direct.sessions_yield 可用时,这些说明还会告知原生 Codex 父级,当子级的结果应在后续回合到达时,结束当前回合。原生 wait_agent 仍用于有意在同一回合内等待的情况,即当立即的下一步被阻塞在子级上时;完成轮询循环不能替代它。

大多数 OpenClaw 动态工具使用可搜索的 openclaw 命名空间。标记为 catalogMode: "direct-only" 的工具使用 openclaw_direct,Codex 会将其作为 DirectModelOnly 直接对模型可见,而不是将其暴露给嵌套的 Code Mode 执行。

后台动态工具启动被视为潜在副作用,包括通常执行只读工作的工具发起的启动。回合恢复会保留该证据,以免重复已经接受的后台任务。

工具架构修复会保留字面属性和定义名称,包括 __proto__。向 Codex 发布的架构以及用于验证 OpenClaw 工具调用的架构保留相同的必填字段和约束。

对于受管的 GitHub 身份,gateway_exec 使用 OpenClaw 的私有本地进程启动凭据绑定。原生 Codex shell 则只接收非机密的 GH_CONFIG_DIR 和令牌清除覆盖层;缺失或无令牌的配置文件仍可能让 GitHub CLI 回退到 OS 密钥环。状态和 Gateway 拥有的发布保证不覆盖该原生 shell 路径。当需要与启动绑定的受管 GitHub 凭据时,请使用 gateway_exec。

媒体与投递

OpenClaw 继续负责媒体投递和媒体提供商选择。图像、视频、音乐、PDF、TTS 以及媒体理解使用相应的提供商/模型设置,例如 agents.defaults.mediaModels.image、agents.defaults.mediaModels.video、pdfModel 和 tts。

文本、图像、视频、音乐、TTS、审批以及消息工具输出继续通过正常的 OpenClaw 投递路径;媒体生成不需要旧版运行时。当 Codex 发出带有 savedPath 的原生图像生成项时,即使 Codex 回合没有助手文本,OpenClaw 也会通过正常的回复媒体路径转发该确切文件。

发送附件只会抑制同一目标上匹配的生成图像;其他生成图像仍可用。内部 UI 源回复会保留其已投递的附件,而不会添加第二份生成副本。部分投递回执不会抑制未确认投递的图像。

各章节迁移位置

单页版本的每个章节现在都位于此页面或下面九个子页面之一。单页版本中的锚点仍会在此处解析。

Codex 进程恢复

Codex 进程恢复 — 在 Gateway 强制停止后,检测并清理孤立的 Codex app-server 进程。

Codex 线程绑定与监督

Codex 线程绑定与监督 — OpenClaw 如何绑定原生 Codex 线程、更改模型并继续受监督的会话。

Codex 回复与最终答案

Codex 回复与最终答案 — 可见回复投递、心跳回合以及有界的最终答案恢复。

Codex 钩子边界

Codex 钩子边界 — 哪个钩子层拥有每个 Codex 回合事件,以及原生钩子中继可以做什么。

Codex 沙箱进程流

Codex 沙箱进程流 — 实验性原生沙箱执行流以及基于节点的远程 exec。

Codex 运行时 v1 支持契约

Codex 运行时 v1 支持契约 — Codex 运行时 v1 中支持和不支持的内容,以及每个边界的原因。

Codex 原生权限与征询

Codex 原生权限与征询 — 原生权限决策、已记住的审批以及 MCP 征询限制。

Codex 队列引导与反馈上传

Codex 队列引导与反馈上传 — Codex 回合上活动运行的队列引导以及 Codex 反馈上传路径。

Codex 压缩与转录镜像

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