工作区引导文件

说明 AGENTS.md、人设、技能和记忆文件如何到达原生 Codex 轮次。属于 Codex harness 参考；每个章节的迁移位置 列出了每个章节。

工作区引导文件¶

完整的通用开发者策略（包括 before_prompt_build.systemPrompt 替换）仍然是压缩和原生子代继承的原生会话配置。普通的持久冷恢复或更改配置后的恢复需要不中断的 app-server 客户端和观察到的原生卸载，之后 OpenClaw 才会注入完整的当前策略。OpenClaw 必须是原生对话的唯一生命周期所有者，即使其 app-server 远程运行也是如此。在交接期间可以重新加载同一对话的独立客户端不在此契约范围内；观察到的卸载不会保留对话以对抗竞争性恢复。本地和远程传输在退订和恢复之间使用相同的对话 ID。仅仅在 thread/resume 上发送 developerInstructions 不会刷新原版 Codex 上模型可见的策略。显式发送 systemPrompt: "" 表示撤回，而不是回退到旧指令。

普通的隐身轮次可以重复使用未更改的通用策略，但如果策略已更改或被清空，则会被拒绝，而不会发送另一个原生轮次或丢弃实时对话。父级本地模型请求指令仍然是一个独立的层面。恢复方法参见 Hook 边界。

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

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

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

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

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

自定义命令、Desktop 代理附件、外部 Unix/WebSocket 连接、非 OpenAI 原生提供商、自定义上游端点、不支持的原生账户模式、锁定的上游配置以及原生的 features.respect_system_proxy 配置会保留用于人设和记忆指引的旧版协作载体，模型拥有的目录指令可以替换该载体。警告和未经验证的人设记录标识该变通方案未生效。OpenClaw 不会重新路由或关闭这些会话。先前嵌入的人设、对话文本和显式任务交接不会从现有历史记录或完整历史分支中移除。

无托管中继的技能目录¶

在没有托管推理中继的连接上，符合条件的 OpenClaw 技能目录使用线程开发者指令，而不是可替换的协作载体。原生子线程可以继承此回退目录。托管连接保留其现有的仅限父级的请求本地目录；技能变更不会恢复其线程，也不会写入目录历史。

对于回退，变更的目录会冷恢复同一持久线程。活动隐身线程通过注入的开发者消息接收完整的当前目录，而不改变其不可变的通用策略。自动压缩后，OpenClaw 会重新投递已编辑或已撤回的目录。即时续接仍可使用创建时的目录；恢复仅对后续请求有保证。独立压缩会使已记录的投递失效，因此下一轮会刷新它，包括在恢复失败之后。

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