原生 Codex 插件

概述

原生 Codex 插件支持让 Codex 模式的 OpenClaw Agent 在同一 Codex 线程中使用 Codex app-server 自身的 app 和插件能力。OpenClaw 不将 Codex 插件转换为合成的 codex_plugin_* 动态工具——插件调用保留在原生 Codex 转录中，由 Codex app-server 拥有 app 支持的 MCP 执行。

核心功能

• V1 支持范围：仅支持迁移时在源 Codex home 中已 source-installed 的 openai-curated 插件
• 三态管理：已安装（Codex 有本地插件包）、已启用（OpenClaw 配置允许）、可访问（app-server 确认 app 条目可用）
• 迁移工具：openclaw migrate codex --dry-run 预览，openclaw migrate apply codex --yes 应用
• 线程 app 配置：OpenClaw 注入限制性 config.apps patch，_default 禁用，仅启用已迁移插件的 app
• 破坏性操作策略：全局 allow_destructive_actions 默认 true，可按插件覆盖；不安全 schema 和模糊所有权仍拒绝
• App 清单缓存：通过 app/list 读取，内存缓存 1 小时，异步刷新过期条目

配置/使用

典型迁移后配置：

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            allow_destructive_actions: true,
            plugins: {
              "google-calendar": {
                enabled: true,
                marketplaceName: "openai-curated",
                pluginName: "google-calendar"
              }
            }
          }
        }
      }
    }
  }
}

更改 codexPlugins 后需 /new、/reset 或重启 Gateway 使新 app 配置生效。

常见错误码：

• auth_required：插件 app 需要重新授权
• codex_subscription_required：需要 ChatGPT 订阅账号
• marketplace_missing：目标 app-server 找不到 openai-curated marketplace

相关页面

• concepts/plugin-codex-harness — Codex Harness 基础配置
• concepts/plugin-codex-harness-reference — 完整配置字段参考
• concepts/plugin-codex-harness-runtime — 运行时边界