跳转至

回复和最终答案

最终助手文本如何到达源对话,以及当 Codex 回合在没有最终助手文本的情况下结束时会发生什么。本文是 Codex harness runtime 指南的一部分;各节移往何处 列出了每一节的位置。

可见回复与心跳

通过 Codex harness 进行的直接/源聊天回合,在内部 WebChat 界面上默认会自动投递最终助手文本,这与 Pi harness 契约一致:代理正常回复,OpenClaw 将最终文本发布到源对话。设置 messages.visibleReplies: "message_tool" 可让最终助手文本保持私有,除非代理调用 message(action="send")。

评论内容遵循对话的进度设置,可能被隐藏或是临时的。当工作仍在进行时收到问题,代理会被指示使用 message(action="send", final=false) 发送答案,并继续执行任务。最终回复涵盖尚未交付的答案和结果。这不会启用评论,也不会改变流式传输设置。

明确标记为异步投递的原生 Codex 消息使用独立的投递意图。它们与可选的进度信息以及最终的最终答案分开投递,即使在分块流式传输被禁用时也是如此。

默认情况下,Codex 心跳回合会在可搜索的 OpenClaw 工具目录中获得 heartbeat_respond,以便代理记录这次唤醒应保持安静还是发出通知。心跳回合与普通聊天回合使用相同的 Codex Default 协作模式。心跳监视器的 cron 暂存内容若存在,则会被附加到计划中的心跳用户消息之后。

远程工作区中的附件

使用 appServer.remoteWorkspaceRoot 时,最终回复和异步回复可以使用 MEDIA:./report.pdf 或远程工作区内的绝对路径。在释放 app-server 连接之前,Codex 插件通过有界的 command/exec 请求读取附件。主机的 reply-media capability 会应用读取策略,并暂存这些字节以供投递。原始回复仍保留在记录中;不会使用 Gateway 工作区副本作为回退。远程工作区之外的文件会产生一个已标记的附件失败。发送前请将它们复制到工作区内。HTTP 引用和受管理的 media:// 附件仍然可用。

工具工作结束后的最终答案

对于普通的、经过主机认证的 Codex 回合,如果在完成工具工作后没有可见答案,OpenClaw 可以在私有临时主目录中请求一次有界的最终回答回合。它使用已完成线程的模型选择,以及原始主机认证路由或解析后的配置文件,而不是从外部请求元数据中选择模型。现有的 environment、dynamic-tool、MCP 和 native-hook 限制仍然适用。已完成的操作是记录证据,而不是要重放的指令。保留原生模型本身并不会禁用主机认证的最终化。

当隐藏的后台任务完成消息属于模型上下文的一部分时,它们仍可参与这种恢复。主机会在已采纳的 prompt 上记录这些消息的原生回合标识,同时在聊天中保持隐藏。原生记录镜像会将该 prompt 作为证据复用;它无法重新创建已经消失的已采纳 prompt。被明确排除在模型上下文之外的消息仍不参与原生 prompt 标注。

恢复机制会为完整的当前回合预留其现有上限,然后保留能容纳得下的最近的完整较早交流。较旧的交流可能会被省略,包括一个过大的完整交流。在空间允许时,通知会指出缺失的历史;最终回答器始终被指示要对缺失的事实表达不确定性。当前证据超过限制、工具配对无效,或存在不支持的内容时,恢复仍然不可用。现有对话历史保持完整,已完成的操作绝不会重复。

通过 Codex Sessions 创建的 Chat 则不同:其私有监督连接持有原生认证。原版 Codex 不暴露通用的、无工具的摘要操作来保留该连接的账户。OpenClaw 会将该最终化上下文标记为不可用,而不是选择主机凭据、复制原生凭据或启动另一个原生回合。如果需要最终回复,主机会交付其现有的回退内容:

工具运行已完成,但没有生成最终摘要。我没有重复任何已完成的操作。

原始的已完成结果、原生绑定和工具回执保持完整。如果原生回合失败,且最终化无法生成答案,则回复会改为说明失败原因和下一步。例如,模型容量错误会提示等待并重试,或选择另一个模型。该回合在聊天和任务进度中仍保持失败;已完成的操作不会重复。显式 Stop 仍表示已取消的回合。

返回最终答案的原生回合会正常投递。普通的 homeScope: "user" 选择加入机制保留其文档所述的私有主机认证最终化;请参阅 认证与环境隔离。

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