古法编程

Appearance

OpenClaw 通过 Codex 插件启用原生桌面控制，不自行安装或执行桌面操作。配置 computerUse 字段后，OpenClaw 会在 Codex 模式回合前自动检查并安装/启用 Codex Computer Use 插件。如果启用 autoInstall: true，还会自动从已发现的市场安装；否则需要先通过 /codex computer-use install 命令显式安装。本页涵盖配置、命令、市场选择、状态解读以及 macOS 权限常见问题。

OpenClaw Codex Computer Use 配置与故障排查 ​

Computer Use 是 Codex 原生 MCP 插件，用于本地桌面控制。OpenClaw 不和桌面应用打包，不直接执行桌面操作，也不绕过 Codex 权限。codex 插件只负责准备 Codex app-server：启用 Codex 插件支持、查找或安装配置的 Codex Computer Use 插件、确认 computer-use MCP 服务器就绪，之后在 Codex 模式回合中交由 Codex 自己调用原生 MCP 工具。

使用本文档前，请确保 OpenClaw 已使用原生 Codex harness。运行时的设置请参阅 Codex harness。

与 PeekabooBridge 的区别 ​

OpenClaw.app 的 Peekaboo 集成独立于 Codex Computer Use。macOS 应用可以托管 PeekabooBridge socket，使 peekaboo CLI 复用应用的本地 Accessibility 和 Screen Recording 授权。该 bridge 不会安装或代理 Codex Computer Use，Codex Computer Use 也不会通过 PeekabooBridge socket 调用。

当你想让 OpenClaw.app 作为 Peekaboo CLI 自动化的权限感知宿主时，使用 Peekaboo bridge。当 Codex 模式的 OpenClaw 代理需要在回合开始前拥有 Codex 原生 computer-use MCP 插件时，使用本文档。

与 iOS 应用的区别 ​

iOS 应用独立于 Codex Computer Use。它不安装或代理 Codex computer-use MCP 服务器，也不是桌面控制后台。iOS 应用以 OpenClaw 节点接入，通过节点命令暴露移动端能力，如 canvas.*、camera.*、screen.*、location.*、talk.*。

当你想让代理通过网关驱动 iPhone 节点时，使用 iOS。当 Codex 模式代理需要控制本地 macOS 桌面时，使用本文档。

与直接 cua-driver MCP 的区别 ​

Codex Computer Use 不是暴露桌面控制的唯一方式。如果你想由 OpenClaw 管理的运行时直接调用 TryCua 的驱动，可以使用上游 cua-driver mcp 服务器，通过 OpenClaw 的 MCP 注册表，而非 Codex 特定的市场流程。

安装 cua-driver 后，可运行以下命令获取 OpenClaw 命令：

bash
cua-driver mcp-config --client openclaw

或自行注册 stdio 服务器：

bash
openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'

该方式保留上游 MCP 工具接口，包括驱动模式和结构化 MCP 响应。当你希望 CUA driver 作为普通 OpenClaw MCP 服务器可用时，使用此路径。当 Codex app-server 需要拥有插件安装、MCP 重载和 Codex 模式回合内原生工具调用时，使用本文档的 Codex Computer Use 设置。

CUA 驱动仅适用于 macOS，仍然需要其应用提示的本地 macOS 权限（如 Accessibility 和 Screen Recording）。OpenClaw 不会安装 cua-driver、授予这些权限或绕过上游驱动的安全模型。

快速配置步骤 ​

在 plugins.entries.codex.config 中设置 computerUse，使 Codex 模式回合在会话开始前拥有 Computer Use：

json5
{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          computerUse: {
            autoInstall: true,
          },
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

使用此配置后，OpenClaw 会在每次 Codex 模式回合开始前检查 Codex app-server。如果缺少 Computer Use 但 Codex app-server 已发现可安装的市场，OpenClaw 会请求 Codex app-server 安装或重新启用插件并重载 MCP 服务器。在 macOS 上，当未注册匹配市场且标准 Codex 应用包存在时，OpenClaw 还会尝试从 /Applications/Codex.app/Contents/Resources/plugins/openai-bundled 注册内置 Codex 市场，然后再失败。如果设置仍无法让 MCP 服务器就绪，回合将在线程开始前失败。

更改 Computer Use 配置后，在测试现有 Codex 线程之前，请在相关聊天中使用 /new 或 /reset。

命令参考 ​

从任何 codex 插件命令面可用的聊天界面运行以下命令。这是 OpenClaw 聊天/运行时命令，而非 openclaw codex ... CLI 子命令：

text
/codex computer-use status
/codex computer-use install
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>
/codex computer-use install --marketplace <name>

status 是只读的。它不会添加市场源、安装插件或启用 Codex 插件支持。

install 启用 Codex app-server 插件支持，可选添加配置的市场源，通过 Codex app-server 安装或重新启用配置的插件，重载 MCP 服务器，并验证 MCP 服务器暴露了工具。

市场选择方式 ​

OpenClaw 使用 Codex 自身暴露的相同 app-server API。市场字段选择 Codex 应从何处查找 computer-use。

字段使用场景安装支持
不设置市场字段希望 Codex app-server 使用已经知道的市场支持，当 app-server 返回本地市场时
marketplaceSource拥有 Codex 市场源，app-server 可以添加支持，适用于显式 /codex computer-use install
marketplacePath已知主机上的本地市场文件路径支持，适用于显式安装和回合启动时自动安装
marketplaceName按名称选择一个已注册的市场仅当选中的市场有本地路径时才支持

新安装的 Codex 主页可能需要短暂时间以种子官方市场。在安装期间，OpenClaw 会轮询 plugin/list，最长等待 marketplaceDiscoveryTimeoutMs 毫秒。默认值为 60000 毫秒（60 秒）。

如果多个已知市场包含 Computer Use，OpenClaw 优先选择 openai-bundled，然后是 openai-curated，然后是 local。未知的不明确匹配会失败关闭，并提示你设置 marketplaceName 或 marketplacePath。

macOS 内置市场 ​

最新 Codex 桌面版本将 Computer Use 打包在此路径：

text
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use

当 computerUse.autoInstall 为 true 且没有注册包含 computer-use 的市场时，OpenClaw 会自动尝试添加标准内置市场根目录：

text
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled

你也可以在 shell 中使用 Codex 显式注册：

bash
codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled

如果使用了非标准 Codex 应用路径，设置 computerUse.marketplacePath 为本地市场文件路径，或运行一次 /codex computer-use install --source &lt;marketplace-source&gt;。

远程市场限制 ​

Codex app-server 可以列出和读取仅远程的目录条目，但目前不支持远程 plugin/install。这意味着 marketplaceName 可以选择一个仅远程的市场进行状态检查，但安装和重新启用仍需要通过 marketplaceSource 或 marketplacePath 使用本地市场。

如果状态显示插件在远程 Codex 市场中可用，但远程安装不受支持，请使用本地源或路径运行安装：

text
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>

配置参考 ​

字段默认值含义
enabled推断是否需要 Computer Use。当设置了其他 Computer Use 字段时默认为 true。
autoInstallfalse在回合启动时从已发现的市场安装或重新启用。
marketplaceDiscoveryTimeoutMs60000安装等待 Codex app-server 市场发现的最长时间（毫秒）。
marketplaceSource未设置传递给 Codex app-server marketplace/add 的源字符串。
marketplacePath未设置包含插件的本地 Codex 市场文件路径。
marketplaceName未设置要选择的已注册 Codex 市场名称。
pluginNamecomputer-useCodex 市场中的插件名。
mcpServerNamecomputer-use安装的插件暴露的 MCP 服务器名。

回合启动时自动安装故意拒绝使用配置的 marketplaceSource 值。添加新源是显式设置操作，因此先用 /codex computer-use install --source &lt;marketplace-source&gt; 运行一次，然后让 autoInstall 处理后续从已发现本地市场的重新启用。回合启动的自动安装可以使用配置的 marketplacePath，因为它已经是主机上的本地路径。

OpenClaw 状态检查含义 ​

OpenClaw 内部报告稳定的设置原因，并以适合聊天的格式输出用户可见状态：

原因含义下一步
disabledcomputerUse.enabled 解析为 false设置 enabled 或其他 Computer Use 字段。
marketplace_missing没有可用的匹配市场配置源、路径或市场名称。
plugin_not_installed市场存在但插件未安装运行 install 或启用 autoInstall。
plugin_disabled插件已安装但在 Codex 配置中禁用运行 install 重新启用。
remote_install_unsupported选中的市场是仅远程的使用 marketplaceSource 或 marketplacePath。
mcp_missing插件已启用但 MCP 服务器不可用检查 Codex Computer Use 和操作系统权限。
ready插件和 MCP 工具可用开始 Codex 模式回合。
check_failed状态检查期间 Codex app-server 请求失败检查 app-server 连接和日志。
auto_install_blocked回合启动设置需要添加新源先运行显式安装。

聊天输出包括插件状态、MCP 服务器状态、市场、可用工具以及失败设置步骤的具体消息。

macOS 权限 ​

Computer Use 仅适用于 macOS。Codex 拥有的 MCP 服务器可能需要本地 OS 权限才能检查或控制应用。如果 OpenClaw 显示 Computer Use 已安装但 MCP 服务器不可用，请先验证 Codex 侧的 Computer Use 设置：

  • Codex app-server 正在同一主机上运行，桌面控制应在此主机上发生。
  • Computer Use 插件在 Codex 配置中已启用。
  • computer-use MCP 服务器出现在 Codex app-server MCP 状态中。
  • macOS 已授予桌面控制应用所需的权限。
  • 当前主机会话可以访问要控制的桌面。

当 computerUse.enabled 为 true 时，OpenClaw 故意失败关闭。如果配置要求使用原生桌面工具，Codex 模式回合不应在缺少该工具的情况下静默继续。

故障诊断 ​

状态显示未安装。 运行 /codex computer-use install。如果市场未发现，传递 --source 或 --marketplace-path。

状态显示已安装但已禁用。 再次运行 /codex computer-use install。Codex app-server 安装会将插件配置写回为启用状态。

状态显示远程安装不受支持。 使用本地市场源或路径。仅远程的目录条目可通过当前 app-server API 检查但不能安装。

状态显示 MCP 服务器不可用。 再次运行 install 以重载 MCP 服务器。如果仍然不可用，修复 Codex Computer Use 应用、Codex app-server MCP 状态或 macOS 权限。

状态或探测在 computer-use.list_apps 上超时。 插件和 MCP 服务器存在，但本地 Computer Use 桥没有响应。退出或重启 Codex Computer Use，必要时重新启动 Codex Desktop，然后在新的 OpenClaw 会话中重试。

Computer Use 工具显示 Native hook relay unavailable。 Codex 原生工具钩子无法通过本地桥或 Gateway 回退到达活动的 OpenClaw 中继。使用 /new 或 /reset 启动一个新的 OpenClaw 会话。如果问题持续，重启网关以使旧 app-server 线程和钩子注册失效，然后重试。

回合启动自动安装拒绝源。 这是故意的。先用显式 /codex computer-use install --source &lt;marketplace-source&gt; 添加源，然后未来的回合启动自动安装可以使用已发现的本地市场。

常见问题 ​

运行 /codex computer-use status 后显示 marketplace_missing 怎么办？ ​

检查是否已配置了正确的市场源。如果没有，设置 computerUse.marketplacePath 指向内置市场路径，或运行 /codex computer-use install --source <source> 添加一个源。确保 Codex app-server 正在运行且网络/本地路径可访问。

为什么我的回合启动时自动安装失败了，并显示 auto_install_blocked？ ​

回合启动自动安装不能使用 marketplaceSource 字段（因为添加源是显式操作）。你需要先用 /codex computer-use install --source <source> 手动安装一次，之后自动安装才能使用该源创建的本地市场。或者，设置 marketplacePath 直接指向本地市场文件路径。

/codex computer-use install 命令对远程市场不起作用，我该怎么做？ ​

Codex app-server 目前不支持远程安装插件。你需要使用本地市场源或路径。如果状态显示远程市场中有 computer-use，请改为配置 marketplaceSource（需显式安装）或 marketplacePath（本地路径），然后运行 /codex computer-use install。

相关文档 ​

友情链接： 能跑吗 · 打工算 · 车主算 · 开发工具 · 人工不智能

Copyright © 2026 古法编程 | 蜀ICP备2021007188号 | 关于本站 | 隐私政策