配置字段

支持的 plugins.entries.codex.config 字段及其默认值。属于 Codex harness 指南的一部分；每个章节迁移到了哪里 列出了所有章节。

配置字段¶

支持的顶层 Codex 插件字段：

支持的 appServer 字段：

appServer.networkProxy 是显式的，因为它会更改 Codex 沙箱 契约。启用时，OpenClaw 还会在 Codex 线程配置中设置 features.network_proxy.enabled 和 default_permissions，以便生成的 权限配置文件可以启动 Codex 托管网络。默认情况下，OpenClaw 会根据配置文件主体生成一个抗冲突的 openclaw-network-<fingerprint> 配置文件 名称；仅在需要稳定的本地名称时使用 profileName。

{
  plugins: {
    entries: {
      codex: {
        config: {
          appServer: {
            approvalPolicy: "never",
            sandbox: "workspace-write",
            networkProxy: {
              enabled: true,
              domains: {
                "api.openai.com": "allow",
                "blocked.example.com": "deny",
              },
              unixSockets: {
                "/tmp/proxy.sock": "allow",
                "/tmp/blocked.sock": "none",
              },
              allowUpstreamProxy: true,
              proxyUrl: "http://127.0.0.1:3128",
            },
          },
        },
      },
    },
  },
}

当 enabled: true 时，domains 使用 Codex 的原生主机匹配。未出现在有效原生允许列表中的主机将被拒绝，除非已配置的审批策略允许显式例外。如上所述，设置 approvalPolicy: "never" 可防止基于审批的例外。原生系统要求可以提供允许的域名或选择受管理的允许列表，因此此映射不会替代系统的网络策略。有效策略中的显式拒绝优先于重叠的允许，并且不能被批准。

使用 *.example.com 表示子域名，或使用 **.example.com 表示主域名及其子域名。这些限制适用于通过 Codex 沙箱运行的命令。它们不会限制 Gateway 流量、模型提供商请求或无关的 MCP 进程。

当 networkProxy.enabled: true 时，无效配置会连同被拒绝的字段路径一起失败，且不会记录配置值。插件更新后，如果保存的配置中可选的 networkProxy.profileName 或 remoteWorkspaceRoot 值为空白，则需要在 Codex 运行之前显式执行 openclaw doctor --fix。Doctor 会移除这些空白值，同时保留域名策略。重试前请手动修复其他无效字段。有效配置无需修复。

如果常规 app-server 运行时将是 danger-full-access，启用 networkProxy 会为生成的权限配置文件使用工作区风格的文件系统访问：Codex 托管的网络执行是沙箱化网络，因此完全访问配置文件不会保护出站流量。域名条目使用 allow 或 deny。Unix socket 条目使用 allow 或 none；OpenClaw 会将 none 转换为 Codex 的原生 deny 权限。