本页内容
本页内容
插件指南
Codex 插件配置字段
支持的 plugins.entries.codex.config 字段及其默认值。 Codex harness 指南的一部分； 每个部分移动的位置 列出每个部分。
配置字段
支持的顶层 Codex 插件字段：
| 字段 | 默认值 | 含义 |
|---|---|---|
codexDynamicToolsLoading |
"searchable" |
使用 "direct" 可将 OpenClaw 动态工具直接放入初始 Codex 工具上下文中。 |
codexDynamicToolsExclude |
[] |
从 Codex 应用程序服务器轮次中省略的其他 OpenClaw 动态工具名称。 |
codexPlugins |
已禁用 | 本机 Codex plugin/app 支持迁移的源安装的精选插件。 |
sessionCatalog |
已启用 | 用于在此 Gateway 和符合条件的配对节点上发现原生 Codex 会话的侧边栏功能。 |
supervision |
已禁用 | 面向代理的原生会话转录与写入控制策略。 |
支持的 appServer 字段：
| 字段 | 默认值 | 含义 |
|---|---|---|
transport |
"stdio" |
"stdio" 生成 Codex；显式 "unix" 连接到本地控制套接字； "websocket" 连接到 url。 |
homeScope |
"agent" |
"agent" 根据 OpenClaw 代理隔离普通harness状态。 "user" 是一个显式选择加入，它共享本机 $CODEX_HOME 或 ~/.codex、使用本机身份验证并启用仅限所有者的线程管理。用户范围支持本地 stdio 或 Unix 传输。对于单独的监控连接，未设置的值解析为 "user"（对于 stdio 或 Unix）和 "agent"（对于 WebSocket）。 |
command |
托管 Codex 二进制文件 | stdio 传输使用的可执行文件。留空以使用受管理的二进制文件；仅在需要显式覆盖时设置。 |
args |
["app-server", "--listen", "stdio://"] |
stdio 传输使用的参数。 |
url |
未设置 | WebSocket 应用服务器 URL 或 unix:// URL。空的显式 Unix 路径选择标准用户主控制套接字。 |
authToken |
未设置 | WebSocket 传输的不记名令牌。接受文字字符串或 SecretInput，例如 ${CODEX_APP_SERVER_TOKEN}。 |
headers |
{} |
额外的 WebSocket 标头。标头值接受文字字符串或 SecretInput 值，例如 x-codex-client-session-token: "${CODEX_CLIENT_SESSION_TOKEN}"。 |
clearEnv |
[] |
在 OpenClaw 构建继承的环境后，从生成的 stdio app-server 进程中移除的额外环境变量名称。对于本地启动，OpenClaw 会保留所选的 CODEX_HOME 和继承的 HOME。 |
codeModeOnly |
false |
选择加入 Codex 的仅代码模式工具面。普通 OpenClaw 动态工具仍可通过嵌套的 tools.* 调用使用；openclaw_direct 工具仍会直接对模型可见。 |
remoteWorkspaceRoot |
未设置 | 远程 Codex 应用程序服务器工作区根。 OpenClaw 将本地 cwd 映射到此根目录，并通过输出上限、无 shell command/exec 阅读器传输权威远程附件。转义工作区、符号链接、超大文件和无限制附件批次的路径将被拒绝；上传保留配置的通道标识和应用程序服务器请求超时。 |
requestTimeoutMs |
60000 |
app-server 控制平面调用的超时时间。 |
mode |
"yolo"，除非本地 Codex 要求不允许 YOLO |
YOLO 或受监管方审核执行的预设。本地 stdio 要求如果不包含 danger-full-access、never 审批或 user 审核者，则隐式默认值为 guardian。 |
approvalPolicy |
"never" 或允许的 guardian 审批策略 |
发送到线程 start/resume/turn. 的本机 Codex 批准策略在允许时默认首选 "on-request"。 |
sandbox |
"danger-full-access" 或允许的 guardian 沙箱 |
发送到线程 start/resume. 的本机 Codex 沙箱模式在允许的情况下监护人默认首选 "workspace-write"，否则为 "read-only"。当 OpenClaw 沙箱处于活动状态时，danger-full-access 会转而使用 Codex workspace-write 以及从 OpenClaw 沙箱出口设置派生的网络访问权限。 |
approvalsReviewer |
"user" 或允许的 guardian 审核者 |
在允许时，使用 "auto_review" 让 Codex 审核原生审批提示，否则使用 guardian_subagent 或 user。guardian_subagent 仍是旧版别名。 |
serviceTier |
未设置 | 当未提供共享快速模式控件时，本机应用程序服务器首选项。非空字符串通过；记录的值为 "priority" 和 "flex"。旧版 "fast" 标准化为 "priority"，并且 null 清除覆盖。本机 "ultrafast" 从 priority 开始，需要显式共享超快选择。共享快速发送 priority，关闭发送 null，自动根据呼叫决定。这不会配置直接嵌入的 OpenAI 请求。 |
enableUltrafast |
true |
仅允许 ultrafast 用于显式共享 "ultrafast" 选择和公布的本机模型。未设置或 true 允许该选择； false 在 Codex 选择器中隐藏 Ultrafast，发送普通 Fast （priority） 进行显式选择，并跳过 Ultrafast 目录检查。快速、自动和未指定的选择永远不会自动升级。不受支持的模型和不可用的目录保留基线层。 |
cyberFailover |
自动黎明蓝升级 | 控制 OpenAI 网络策略拒绝后的自动重试。 mode（默认"auto"，或"off"）启用它，model（默认"gpt-daybreak-blue-latest"）是升级目标，cooloffMs（默认600000）限制尝试后的会话窗口。升级重试一次被拒绝的回合，永远不会更改存储的模型选择，并将未经授权的目标视为不可用，而不是重试。请参见 运行时行为。 |
networkProxy |
已禁用 | 选择应用程序服务器命令的 Codex 权限配置文件网络。 OpenClaw 定义选定的 permissions.<profile>.network 配置，并使用 default_permissions 选择它，而不是发送 sandbox。 |
experimental.sandboxExecServer |
false |
预览选择加入，将 OpenClaw 沙箱支持的 Codex 环境注册到受支持的 Codex 应用程序服务器，以便本机 Codex 执行可以在活动的 OpenClaw 沙箱内运行。 |
appServer.networkProxy 是显式配置，因为它会改变 Codex 沙箱契约。启用后，OpenClaw 还会在 Codex 线程配置中设置 features.network_proxy.enabled 和 default_permissions，以便生成的权限配置文件可以启动 Codex 托管网络。默认情况下，OpenClaw 会根据配置文件主体生成一个抗冲突的 openclaw-network-<fingerprint> 配置文件名称；仅在需要稳定的本地名称时使用 profileName。
与enabled: true、domains使用Codex的本机主机匹配。除非配置的批准策略允许显式例外，否则有效本机允许列表中不存在的主机将被拒绝。如上所述设置 approvalPolicy: "never"，以防止基于批准的异常。本机系统要求可以贡献允许的域或选择托管白名单，因此此映射不会替换系统的网络策略。有效政策中的明确拒绝优先于重叠允许，不能获得批准。
对子域使用 *.example.com，对顶级域和子域使用 **.example.com。这些限制适用于通过 Codex 沙箱运行的命令。它们不限制网关流量、模型提供者请求或不相关的 MCP 进程。
对于 networkProxy.enabled: true，无效配置会失败并拒绝字段路径，且不会记录配置值。插件更新后，使用空白可选 networkProxy.profileName 或 remoteWorkspaceRoot 值保存的配置需要显式 openclaw doctor --fix 才能运行 Codex。 Doctor 会删除这些空白值，同时保留域策略。在重试之前手动修复其他无效字段。有效的配置无需修复。
如果正常的应用程序服务器运行时为 danger-full-access，则启用 networkProxy 会对生成的权限配置文件使用工作区样式的文件系统访问：Codex 托管网络实施是沙盒网络，因此完全访问配置文件不会保护出站流量。域条目使用 allow 或 deny。 Unix套接字条目使用allow或none； OpenClaw 将 none 转换为 Codex 的本机 deny 权限。