跳转至

Codex harness 参考

本参考文档涵盖官方 codex 插件的详细配置。 对于设置和路由决策,请从 Codex harness 开始。

插件配置项

所有 Codex harness 设置都位于 plugins.entries.codex.config 下。

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: true,
            timeoutMs: 10000,
          },
          appServer: {
            mode: "guardian",
          },
        },
      },
    },
  },
}

顶层字段:

字段 默认值 含义
discovery enabled Codex app-server model/list 的模型发现设置。参见 Codex 模型发现。
appServer managed stdio app-server 传输、命令、认证、审批、沙箱和超时设置。常规 harness 默认使用 agent 作用域状态。参见 Codex app-server 传输。
codexDynamicToolsLoading "searchable" 使用 "direct" 可将 OpenClaw 动态工具直接放入初始 Codex 工具上下文。参见 Codex 动态工具。
codexDynamicToolsExclude [] 要从 Codex app-server 轮次中省略的额外 OpenClaw 动态工具名称。参见 Codex 动态工具。
codexPlugins disabled 原生 Codex 插件/应用支持,包括选择加入已连接账户应用的访问。参见 原生 Codex 插件。
computerUse disabled Codex Computer Use 设置。参见 Codex Computer Use。
sessionCatalog enabled 用于侧边栏的原生 Codex 会话发现。设置 enabled: false 可禁用它,或设置 homes 以包含额外的本地 Codex 存储。参见 Codex 会话目录与监督。
supervision disabled 面向 agent 的原生会话转录和写入控制策略。参见 Codex 监督。

各章节迁移位置

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

Codex 会话目录与监督

Codex 会话目录与监督 — 原生 Codex 会话发现和面向 agent 的监督设置。

Codex app-server 传输

Codex app-server 传输 — app-server 传输选择、appServer 字段表以及本地测试环境变量覆盖。

Codex 审批与沙箱模式

Codex 审批与沙箱模式 — YOLO 和 guardian 审批预设,以及沙箱化原生执行路径。

Codex 认证与环境隔离

Codex 认证与环境隔离 — Codex 认证选择顺序、凭据处理和环境隔离。

Codex 动态工具

Codex 动态工具 — OpenClaw 动态工具如何暴露给 Codex app-server 轮次。

Codex 超时与轮次结算

Codex 超时与轮次结算 — 动态工具超时顺序、轮次执行预算和本地结算。

Codex 模型发现

Codex 模型发现 — Codex app-server 模型发现、离线提示和目录规则。

Codex 受限轮次

Codex 受限轮次 — 当工具策略限制 Codex 原生界面时,零环会添加什么。

Codex 工作区引导文件

Codex 工作区引导文件 — 哪些工作区引导文件会到达 Codex 轮次,以及它们如何被传递。

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