原生 Codex 插件

​

要求

• 代理运行时必须是原生 Codex harness。
• plugins.entries.codex.enabled 必须为 true。
• plugins.entries.codex.config.codexPlugins.enabled 必须为 true。
• Codex app-server 必须准确报告稳定版本 0.147.0。官方插件附带 @openai/codex 0.147.0；自定义、远程和 macOS 桌面所有的二进制文件 必须使用完全相同的版本。
• 目标 Codex app-server 必须能够看到预期的市场、插件和 应用清单。
• 迁移仅支持在源 Codex home 中观察到的、从源安装的 openai-curated 插件。Codex 会以 openai-api-curated wire 名称向 API-key 和 Bedrock 账户提供相同的目录； OpenClaw 将这两个名称视为同一个精选目录，因此已配置的 openai-curated 插件可以从任一名称解析。
• 原生运行时还支持 Codex 已经可用的其他市场，例如 openai-bundled、openai-primary-runtime、 workspace-directory，以及当前仓库中的市场清单。 在所有者或 operator.admin 明确安装或启用其市场限定身份之前，插件仍然不可用。

​

快速开始

openclaw migrate codex --dry-run

openclaw migrate codex --dry-run --verify-plugin-apps

openclaw migrate apply codex --yes

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

/codex plugins available
/codex plugins install security-review@company-tools

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            plugins: {
              "security-review@company-tools": {
                enabled: true,
                marketplaceName: "company-tools",
                pluginName: "security-review",
              },
            },
          },
        },
      },
    },
  },
}

​

定时自动化

​

从聊天中管理插件

/codex plugins
/codex plugins list
/codex plugins available
/codex plugins install security-review@company-tools
/codex plugins disable google-calendar
/codex plugins enable google-calendar
/codex plugins disable security-review@company-tools

​

原生插件设置如何工作

• 在规划期间，OpenClaw 读取源 Codex 的 plugin/read 详情，并 检查源 Codex app-server 账户。codex_subscription_required 表示 account/read 已明确识别出 API 密钥或其他 非 ChatGPT 账户；账户缺失并不能证明没有订阅。
• 默认情况下，迁移会跳过源应用清单调用：通过账户门槛的、基于应用的源 插件会在不验证源应用可访问性的情况下完成规划。账户缺失或 account/read 失败时，迁移会以 codex_account_unavailable 跳过这些插件。
• 使用 --verify-plugin-apps 时，迁移会获取最新的源 app/installed 快照，通过 app/read 获取经过身份验证的元数据，并要求每个 所有者应用在源 Codex 账户中均已存在、启用且可访问，之后才会规划原生激活。 如果 account/read 缺失或失败，严格验证仍可通过源 app-server 配置的 bearer 或 header 身份验证来证明访问权限。已明确识别出的 非 ChatGPT 账户仍然不符合资格。

​

支持边界

• 只有已经安装在源 Codex app-server 应用清单中的 openai-curated 插件才符合迁移条件。
• 运行时支持来自 Codex 发现的官方、工作区、个人、共享和仓库本地市场中的明确批准插件。缺少 市场、插件、所有权详情或应用就绪证据时，不会公开任何插件应用。
• 被明确识别为非 ChatGPT 的源账户无法通过订阅门槛。默认情况下，缺失或无法读取的源账户不可用。 --verify-plugin-apps 则可以通过经过身份验证的源应用清单建立访问权限，包括使用 bearer 或 header 身份验证的 app-server。 无法访问、已禁用或缺失的源应用，以及应用清单刷新失败，仍会被跳过并列为手动处理项。无法读取的插件详情会在应用清单门槛之前被跳过。
• 迁移会写入明确的插件身份（marketplaceName 和 pluginName）；不会写入本地 marketplacePath 缓存路径。
• codexPlugins.enabled 是唯一的全局启用开关；不存在 plugins["*"] 通配符或授予任意安装权限的配置键。
• 迁移不会自动导入非精选市场、缓存的插件 bundle、hooks 或 Codex 配置文件。使用 /codex plugins available 和所有者发起的 /codex plugins install <plugin>@<marketplace> 命令， 选择加入其他已发现的插件。
• OpenClaw 不会在此流程中添加新的 Git 或本地市场来源。 其他来源必须已经在 Codex 中配置，或能够从绑定的仓库中发现。

​

应用清单与所有权

• 源迁移验证使用源 Codex home 和启动选项。它仅在使用 --verify-plugin-apps 时运行，并会为该规划运行强制刷新源运行时快照和元数据读取。
• 目标运行时设置在构建和验证线程应用配置时，使用目标代理的 Codex app-server 身份。 精选插件激活会使该目标缓存键失效，然后在 plugin/install 后强制刷新。显式市场安装会刷新相同的目标运行时状态， 之后后续对话才能使用该插件。

​

已连接的账户应用

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            allow_all_plugins: true,
            allow_destructive_actions: "auto",
          },
        },
      },
    },
  },
}

​

线程应用配置

​

破坏性操作策略

• 全局 allow_destructive_actions 默认值为 true。
• 每个插件的 allow_destructive_actions 会覆盖该插件的全局策略。
• false：OpenClaw 返回确定性的拒绝。
• true：OpenClaw 仅对其能映射为批准响应的安全 schema 自动接受，例如布尔类型的 approve 字段。
• "auto"：OpenClaw 将破坏性插件操作暴露给 Codex，然后在返回 Codex 批准响应之前，把可证明具有所有权的 MCP 批准请求转换为 OpenClaw 插件批准。
• "ask"：OpenClaw 使用与 "auto" 相同的 Codex 写入/破坏性操作门控，在线程开始前清除该应用的持久化 Codex 按工具批准覆盖，并且只提供一次性的批准或拒绝，因此持久化批准不会抑制后续的写操作提示。对于每个采用 "ask" 的已接入应用，OpenClaw 会为该应用选择 Codex 的 human approvals 审核者，从而让 Codex 将其批准请求发送给 OpenClaw；其他应用以及非应用线程批准则保留其已配置的审核者和策略。
• 缺少插件身份、所有权不明确、turn id 缺失或不匹配，或者不安全的 elicitation schema 都会直接拒绝，而不是提示用户。

​

故障排查

​

相关

• Codex harness
• Codex harness 参考
• Codex harness 运行时
• 配置参考
• 迁移 CLI