概述
Codex Computer Use 是 Codex 原生的 MCP 插件，用于本地桌面控制（macOS 专属）。OpenClaw 不自行执行桌面操作，仅负责准备 Codex app-server：启用插件支持、查找或安装 Computer Use 插件、验证 computer-use MCP server 可用，然后让 Codex 在 Codex 模式轮次中拥有原生 MCP 工具调用。
与 PeekabooBridge（OpenClaw.app macOS 辅助功能集成）和 iOS app（移动节点能力）是独立的不同功能。
核心功能
- 自动安装：
computerUse.autoInstall: true在每次 Codex 模式轮次前检查并安装/重新启用插件 - Marketplace 选择：支持无字段（使用已知 marketplace）、
marketplaceSource、marketplacePath、marketplaceName四种方式 - macOS 捆绑 marketplace：
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled，autoInstall时自动尝试注册 - 状态检查：
/codex computer-use status报告插件状态、MCP server 状态、marketplace、可用工具 - Fail-closed：
computerUse.enabled: true时，若无法使 MCP server 可用则轮次失败，不静默继续 - 直接 cua-driver 替代：可通过
openclaw mcp set cua-driver直接注册 cua-driver MCP server，绕过 Codex marketplace 流程
配置/使用
最小配置：
{
plugins: {
entries: {
codex: {
enabled: true,
config: {
computerUse: { autoInstall: true }
}
}
}
},
agents: { defaults: { model: "openai/gpt-5.5" } }
}配置字段：
| 字段 | 默认值 | 说明 |
|---|---|---|
enabled | 推断 | 要求 Computer Use，设置其他字段时默认 true |
autoInstall | false | 轮次开始时自动安装/重新启用 |
marketplaceDiscoveryTimeoutMs | 60000 | 等待 marketplace 发现的超时 |
pluginName | computer-use | Codex marketplace 插件名 |
mcpServerName | computer-use | 插件暴露的 MCP server 名 |
状态原因码：disabled、marketplace_missing、plugin_not_installed、plugin_disabled、mcp_missing、ready、check_failed
相关页面
- concepts/plugin-codex-harness — Codex Harness 基础（Computer Use 的前提）
- concepts/plugin-codex-native-plugins — 原生 Codex 插件支持