监督

用于侧边栏的原生会话发现与面向代理的监督策略。属于 Codex harness 参考；每个章节移到了哪里列出了每个章节。

监督¶

默认情况下，原生会话发现会从 Gateway 计算机和已选择加入的配对节点列出未归档的 Codex 会话。仅禁用该目录：

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          sessionCatalog: {
            enabled: false,
          },
        },
      },
    },
  },
}

发现功能自动覆盖 Gateway 进程的 Codex 主目录（CODEX_HOME 或 ~/.codex）以及每个已配置的 OpenClaw 代理的 Codex 主目录。仅当会话位于 OpenClaw 尚不了解的主目录中时，才注册额外的本地 Codex 存储，例如，使用 OpenClaw 之外的自定义 CODEX_HOME 创建的存储：

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          sessionCatalog: {
            homes: [
              "/path/to/additional-codex-home",
              { path: "/path/to/review-codex-home", label: "Review sessions" },
            ],
          },
        },
      },
    },
  },
}

配置的存储会与自动发现的存储一起出现在侧边栏中，标记为 Local Codex · <label>，并按每个会话的工作目录分组。字符串条目和没有 label 的对象使用规范化主目录的基名；显式的 label 会覆盖该默认值。这些存储中的会话支持相同的查看、继续和归档操作，并且所选 OpenClaw 代理仍拥有生成的连接；homes 仅添加目录源。

发现功能会分别针对每个代理和 Codex 主目录缓存原生页面 32 秒，因此列出一个存储不会淘汰另一个存储的页面。过期的页面在后台刷新期间仍保持可见。

新建的原生终端会话使用主要本地配置文件，显示为 Local Codex，或使用符合资格的配对节点。额外的本地主目录是会话发现和恢复来源，不是单独的全新启动目标。所选工作目录控制 Codex 的项目配置，而不会更改其主目录或登录信息。请参阅原生 CLI 启动。

仅包含已存在的目录。等效路径会针对自动主目录进行规范化和去重，并且在 100 个来源的目录上限下，自动主目录保持优先级。配置更改会在默认的混合重载模式下刷新目录主目录；无需重启 Gateway。sessionCatalog.homes 需要默认的受管 stdio app-server 传输；Unix 和 WebSocket 传输会以可见错误拒绝它，因为它们无法为每个主目录启动来源绑定的 app-server。

supervision 单独控制面向代理的工具：

字段	默认值	含义
`enabled`	`false`	启用面向代理的 Codex 监督工具。这不控制已认证的操作员会话目录。
`endpoints`	内置本地端点	为保留的 Codex 监督代理和独立 MCP 工具提供的兼容性和高级端点目标。人工目录和分支流程会忽略这些目标，并使用从 `appServer` 解析出的监督 App Server。
`allowRawTranscripts`	`false`	启用监督后，允许自主代理或独立 MCP 读取转录文本以及读取派生自转录文本的列表字段。`codex_threads` 的仅元数据读取仍然可用。不控制已认证的 Control UI 继续操作。
`allowWriteControls`	`false`	启用监督后，允许自主 `codex_threads` 分叉、重命名、归档和取消归档变更，以及独立 MCP 的发送、引导和中断操作。不会绕过其他绑定、主机、状态或确认检查。

端点条目接受以下字段：

字段	适用范围	含义
`id`	全部	稳定的端点 ID。
`label`	全部	可选的显示标签。
`transport`	全部	`"stdio-proxy"` 或 `"websocket"`。
`command`	`stdio-proxy`	可选的 App Server 命令。
`args`	`stdio-proxy`	可选的命令参数。
`cwd`	`stdio-proxy`	可选的子进程工作目录。
`url`	`websocket`	必需的 WebSocket 或受支持的本地 socket URL。
`authTokenEnv`	`websocket`	可选的环境变量，其值用于对端点进行认证。

Codex Sessions 页面使用插件的监督 App Server，并且只显示未归档的会话。在没有显式 appServer 连接设置的情况下，该连接是受管的用户主目录 stdio 连接。已存储或空闲的本地行可以创建模型锁定的 Chat，其中包含截至最后一个由终端持久化的来源轮次的受限用户和助手历史。其私有绑定保留快照分叉、规范的 appServer 来源分支、历史注入以及该连接上的后续轮次。首次规范启动使用分叉返回的配对。后续恢复会省略 OpenClaw 模型和提供程序覆盖，以便 Codex 恢复规范线程的持久化配对；单独的原生更改可以更新该配对，但外部模型和回退链永远不会替换它。已存储和空闲的行可以在确认没有其他运行者之后归档，除非另一个活动的 OpenClaw 绑定拥有确切目标或其未归档的派生后代之一。OpenClaw 遵循 Codex 的后代分页，并在枚举错误、循环或安全限制耗尽时安全失败。确认仍然涵盖未知的原生客户端和状态到归档的竞态条件。受监督的模型锁定 Chat 在保护原生绑定期间不能被删除。活动来源不能创建分支，也不能被归档，但现有的受监督 Chat 仍然可以打开。配对节点继续需要 operator.admin、一个已存储或空闲的交互式线程，以及一个已连接且通告并允许目录列表、转录文本读取和 codex.cli.session.resume 命令的节点。它将 Chat 绑定到该节点上的原生 CLI 恢复，而不是本地分支流程或流式 App Server 封装。其他配对节点行保持可读，并且配对节点归档不可用。请参阅配对节点限制。

仅设置 appServer.homeScope: "user" 会改变受管 harness 进程使用的 Codex 主目录；它不会发布 fleet catalog。启用 supervision 不会改变 harness 默认值。相反，当不存在显式 appServer 连接设置时，独立的 supervision 连接默认使用受管用户主目录 stdio。对于该连接，显式设置会被遵循。待处理和已提交的受管绑定在每一轮中都会保留该连接；禁用 supervision 或连接/生命周期漂移会失败关闭，而不是回退到 agent-home harness。默认连接与原生 Codex 客户端共享已存储的会话，而不是它们进程本地的活动状态。

旧版 plugins.entries.codex-supervisor 设置已弃用。运行 openclaw doctor --fix 可将旧条目、端点定义、策略标志以及插件允许/拒绝引用迁移到此块中。显式规范的 codex.config.supervision 值在冲突中优先。

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