跳转至

工作区引导文件

AGENTS.md、persona、技能与记忆文件如何到达原生 Codex 轮次。本文属于 Codex harness 参考 的一部分;各章节去向 列出了每一节。

工作区引导文件

完整的通用开发者策略(包括 before_prompt_build.systemPrompt 替换)仍然是用于压缩和原生子代继承的原生会话配置。普通的持久化冷恢复或配置更改后的恢复,要求 OpenClaw 在注入完整当前策略之前,拥有不间断的应用服务器客户端并观察到原生卸载。OpenClaw 必须是原生对话的唯一生命周期所有者,即使其应用服务器在远程运行也是如此。在交接期间能够重新加载同一对话的独立客户端不在本契约范围内;观察到的卸载并不能针对竞争性恢复保留该对话。本地和远程传输通过退订和恢复使用相同的对话 ID。仅向 thread/resume 发送 developerInstructions 并不会刷新标准 Codex 上模型可见的策略。显式的 systemPrompt: "" 发送的是撤回,而不是回退到旧指令。

普通的隐身轮次可以复用未更改的通用策略,但更改或清空的策略会被拒绝,而不会发送另一个原生轮次或丢弃活动对话。父级本地的模型请求指令仍然是一个独立的层面。恢复操作请参阅 Hook 边界。

Codex 通常通过原生项目文档发现机制自行处理 AGENTS.md。OpenClaw 不会编写合成的 Codex 项目文档文件,也不会依赖 Codex 的备用文件名来处理 persona 文件,因为 Codex 的备用规则仅在 AGENTS.md 缺失时生效。普通的受策略限制的轮次没有原生文件系统环境,因此 OpenClaw 改为将有界的工作区 AGENTS.md 快照作为线程级开发者指令发送。Ring-zero、轻量级、仅消息以及禁用工具的内部轮次会抑制该载体。

为了实现 OpenClaw 工作区的一致性,本地工具说明位于 AGENTS.md 的 ## Tools 部分,通常随 Codex 的原生项目文档发现机制一起加载。Codex harness 将其他引导文件作为开发者指令转发:

  • 在受管理的直接 stdio 应用服务器上(包括 OpenClaw 为 Computer Use 启动的 Desktop 可执行文件),SOUL.md、IDENTITY.md 和 USER.md 会被添加到仅父级模型请求指令中。私有中继会保持原生基础/目录指令和历史记录不变,因此新交付的 persona 和用户配置文件上下文不会被原生 Codex 子代理自动继承。
  • 紧凑加载的 OpenClaw 技能列表使用相同的父级本地层。
  • 所选记忆插件的提示构建器会收到完整的可用工具集,包括延迟的插件工具。其指导使用相同的父级本地层,独立于 MEMORY.md 文件路由。
  • 心跳轮次通过协作模式接收通用主动性指导。监控 cron 草稿内容会附加到心跳提示中,而不是作为工作区上下文注入。
  • 当该工作区有可用的记忆工具时,来自已配置代理工作区的 MEMORY.md 内容不会被粘贴到原生 Codex 轮次输入中;当它存在时,harness 会在父级本地指令层添加一个简短的工作区记忆指针,Codex 应在持久记忆相关时使用 memory_search 或 memory_get。如果工具被禁用、记忆搜索不可用,或活动工作区与代理记忆工作区不同,则 MEMORY.md 改用有界轮次输入引用路径。
  • 当存在 BOOTSTRAP.md 时,它使用相同的轮次输入引用路径。这些引用会在新原生线程的第一轮、冷恢复(包括 Gateway 重启)之后、原生压缩之后,或当其渲染内容发生变化时引入。一旦完整的引用块已提交,后续热轮次中未更改的引用将被省略。如果提示适配丢弃或截断了该块,后续轮次会再次引入它。追踪是进程本地的;引用内容在原生历史中仍然是普通的用户输入。

受管理的中继支持标准 OpenAI 端点上的原生 API-key 和 ChatGPT 账户,也适用于 Gateway 拥有的推理以及 remote-exec。其 HTTP 和 WebSocket 跳点遵循 Gateway 的 HTTP(S) 代理和 TLS 配置。原生登录、令牌刷新、后端路由和审批审查检查仍由原生侧拥有。它会拒绝过大的已准备上下文而不是截断它(最大 256 KiB);模型请求体和 WebSocket 帧上限为 32 MiB。超过这些限制时,请减少引导/技能预算或附加上下文。中继在转发前会验证每个原生请求及其当前父级注册。不需要父级本地指令的请求会保留其原生 JSON 字节,包括 HTTP 上现有的 zstd 压缩。带有父级本地指令的请求仍会收到相同的受限指令注入。

Desktop 可执行文件的选择和 Computer Use 权限保持不变。中继属于 OpenClaw 启动的直接 stdio 进程,而不是 Desktop 应用程序的其他对话。

自定义命令、Desktop 代理附件、外部 Unix/WebSocket 连接、非 OpenAI 原生提供商、自定义上游端点、不受支持的原生账户模式、锁定的上游配置以及原生 features.respect_system_proxy 配置使用下面的线程开发者载体。OpenClaw 不会重新路由它们的推理,也不会更改它们的原生账户配置。先前嵌入的 persona、对话文本和显式任务交接不会被从现有历史或全历史分叉中移除。

无受管理中继时的技能、persona 与记忆

在没有托管推理中继的连接上,符合条件的技能、共享角色(SOUL.md、IDENTITY.md、工作区根目录中的 USER.md)以及记忆指引共享一个可刷新的线程开发者部分。模型自有的协作指令不能替换此部分。原生子线程可以继承此回退上下文。托管连接保持其现有的仅限父级的请求本地投递。

选定的个人 users/<profile-id>/USER.md 覆盖层被排除在回退部分之外。线程配置和历史均可被原生子线程继承,因此两者都不是仅限父级的载体。这些连接目前仅使用共享用户偏好,当个人覆盖层被省略时记录警告,并报告其注入字符数为零。外部连接上的个人配置投递被推迟,直到有仅限父级的载体可用。托管中继连接继续向父级投递选定的个人覆盖层。

更改或移除的部分会以完整的当前开发者指令冷恢复同一个普通持久线程。该当前配置也能在原生压缩中保留。活动隐身线程无法冷恢复:它通过注入的开发者消息接收完整的当前部分,而不改变其不可变的创建配置。缺失的部分会被明确撤回。

隐身模式有两个限制:自动压缩可能在 OpenClaw 重新投递当前部分之前,为即时继续恢复创建时的指令;恢复适用于下一个请求。没有继承历史的新的原生子线程也可能收到创建时的指令,而不是后续注入的编辑。具有完整历史的子线程可以继承后续交接。独立压缩会使已记录的投递失效,因此下一轮会刷新它,包括在恢复失败之后。这些刷新不会从历史中擦除较早的指令。

轻量级 cron 轮次省略技能。在与普通轮次共享线程的回退连接上,该省略会撤回线程级目录,直到下一个普通轮次。在托管连接上,它仅省略当前请求的目录;不会改变原生线程状态。

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