codex 插件只负责准备 Codex app-server：
它会启用 Codex 插件支持，查找或安装已配置的 Computer Use
插件，检查 computer-use MCP 服务器是否可用，然后在 Codex 模式回合期间
让 Codex 自主管理原生 MCP 工具调用。
如果 OpenClaw 已经在使用原生 Codex harness，就使用本页。关于
运行时本身的设置，请参见 Codex harness。
这与 OpenClaw 内置的 基于 node 的 computer tool 不同。当同一个代理契约应控制一台配对的 Mac，而代理运行在 Gateway 或其他节点上时，请使用内置工具。当 Codex app-server 应当负责本地 MCP 安装、权限以及原生工具调用时，请使用 Codex Computer Use。
OpenClaw.app 与 Peekaboo
OpenClaw.app 的 Peekaboo 集成与 Codex Computer Use 是分开的。该 macOS 应用可以托管一个 PeekabooBridge 套接字，这样peekaboo CLI 就可以重用
应用的本地辅助功能和屏幕录制授权，用于 Peekaboo 自身的
自动化工具。该桥接不会安装或代理 Codex Computer Use，而且
Codex Computer Use 也不会通过 PeekabooBridge 套接字调用。
当你希望 OpenClaw.app 作为一个具备权限感知的主机来支持 Peekaboo CLI 自动化时，
请使用 Peekaboo bridge。当一个
Codex 模式的 OpenClaw 代理应在回合开始前就具备 Codex 原生的 computer-use
MCP 插件时，请使用本页。
iOS 应用
iOS 应用与 Codex Computer Use 是分开的。它不会安装或代理 Codexcomputer-use MCP 服务器，也不是桌面控制后端。
相反，iOS 应用会作为一个 OpenClaw 节点连接，并通过节点命令暴露移动
能力，例如 canvas.*、camera.*、screen.*、
location.* 和 talk.*。
当你希望代理通过网关驱动 iPhone 节点时，请使用 iOS。当你希望 Codex 模式代理通过 Codex 的原生 Computer Use 插件控制本地 macOS 桌面时，请使用此页面。
直接的 cua-driver MCP
Codex Computer Use 并不是暴露桌面控制的唯一方式。如果你希望 OpenClaw 管理的运行时直接调用 TryCua 的驱动程序，请使用上游的cua-driver mcp 服务器，通过 OpenClaw 的 MCP 注册表来使用，而不是
Codex 专用的 marketplace 流程。
安装 cua-driver 后，可以让它输出 OpenClaw 命令：
cua-driver、授予这些权限，也不会绕过上游驱动程序的安全模型。
快速设置
在 Codex 模式轮次开始前必须可用 Computer Use 时，请设置plugins.entries.codex.config.computerUse。autoInstall: true 会启用
Computer Use，并允许 OpenClaw 在回合开始前安装或重新启用它：
computer-use 目录中。
在 macOS 上，如果没有注册匹配的
市场且存在标准桌面应用程序包，OpenClaw 还会尝试从
/Applications/ChatGPT.app/Contents/Resources/plugins/openai-bundled 注册捆绑的 Codex 市场，同时保留
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled 作为旧版独立安装的回退路径。如果设置仍无法使 MCP 服务器可用，则该轮次会在会话开始前失败。
严格的就绪检查失败属于 harness 预检失败，因此模型回退不会为每个 Codex 候选项重复相同的本地就绪流程。
解析到其他 harness 的候选项仍然符合条件，并会通过其正常的策略检查进入该运行时。
在更改 Computer Use 配置后，如果现有 Codex 线程已经开始，请在受影响的聊天中使用 /new 或 /reset，然后再进行测试。
在 macOS 上，Computer Use 的受管理启动优先使用桌面应用二进制文件 /Applications/ChatGPT.app/Contents/Resources/codex，然后回退到 /Applications/Codex.app/Contents/Resources/codex，以兼容旧版独立安装。这也适用于启动自己客户端的一次性 Computer Use 状态和安装命令。这样可以将桌面控制保留在拥有本地 macOS 权限的应用包之下。如果未安装桌面应用，OpenClaw 会回退到安装在插件旁边的受管理 Codex 二进制文件。使用默认隔离 agent home 的普通受管理 Codex 轮次会优先使用该固定包，这样较旧的桌面应用就不会覆盖当前的模型支持。用户作用域的 homes 仍然优先使用桌面应用，因为它们可以加载原生 Computer Use 状态。其有效 Codex 配置启用了 Computer Use 的隔离 agent home 也仍然优先使用桌面应用。显式的 appServer.command 配置或 OPENCLAW_CODEX_APP_SERVER_BIN 仍然会覆盖此受管理选择。
OpenClaw 会在一个正在运行的 Gateway 中串行化原生 Codex 配置读取和 Computer Use 安装。单独的 Codex 进程或另一个 Gateway 不在该保护范围内。在 Gateway 之外更改原生 Codex 插件配置后，请重启 Gateway 并启动新的聊天，再依赖新的选择。
命令
在任何可用codex 插件命令界面的聊天界面中使用 /codex computer-use 命令。这些是 OpenClaw 聊天/运行时命令，而不是
openclaw codex ... CLI 子命令：
status 是默认操作，且为只读：它不会添加市场源、安装插件或启用 Codex 插件支持。若配置未将 Computer Use 纳入，即使执行过一次性安装命令，status 也可能报告为已禁用。
install 会启用 Codex app-server 插件支持，可选择性地添加已配置的市场源，通过 Codex app-server 安装或重新启用已配置的插件，重新加载 MCP 服务器，并验证 MCP 服务器是否暴露工具。由于安装会更改受信任的主机资源，只有所有者或 operator.admin Gateway 客户端才能运行 install。其他已授权的发送者仍可继续使用只读的 status 命令，包括带覆盖参数的情况。
较早版本支持一次性的 --plugin、--server 和 --mcp-server标识覆盖。请改为持久化配置
computerUse.pluginName 和computerUse.mcpServerName。当使用旧版标识标志时，命令会识别需要持久化的确切设置，并在迁移指导中重复所请求的操作以及任何受支持的市场参数。
Marketplace 选择
OpenClaw 使用与 Codex 本身公开的相同 app-server API。marketplace 字段 用于选择 Codex 应该在哪里查找computer-use。
新的 Codex 主目录可能需要片刻时间来填充其官方 marketplace。在安装期间，OpenClaw 会轮询
plugin/list，最长可达 marketplaceDiscoveryTimeoutMs 毫秒（默认 60 秒）。
如果多个已知 marketplace 包含 Computer Use，OpenClaw 会优先选择
openai-bundled，然后是 openai-curated，最后是 local。未知且有歧义的
匹配会直接失败，并要求你设置 marketplaceName 或
marketplacePath。
捆绑的 macOS 市场
当前 ChatGPT 桌面版构建会在此处捆绑 Computer Use；旧版独立Codex 桌面版构建在
Codex.app 下使用相同布局：
computerUse.autoInstall 为 true 且未注册包含computer-use 的市场时，OpenClaw 会尝试添加存在的第一个标准捆绑市场根目录：
/codex computer-use install --source <marketplace-root> 一次，或者将 computerUse.marketplacePath 设置为
本地市场文件路径。只有在你持有市场的 JSON 文件路径时才使用
--marketplace-path，不要使用捆绑的市场根目录。
共享插件缓存
默认的pluginCacheMode: "independent" 会让每个 Codex 主目录及其插件缓存处于未管理状态。将
pluginCacheMode 设置为 "shared"，可在应用服务器启动前将捆绑的 Computer Use 插件复制到当前 Codex 主目录可发现的插件缓存中。共享模式会保留较旧的缓存版本，因为正在运行的 Codex 客户端仍可能引用其带版本号的插件目录；如果替换复制失败，也会保留当前缓存。显式的marketplaceName 或 marketplacePath 配置会禁用此协调过程，因此 OpenClaw 不会覆盖该选择。
远程市场
远程市场支持在 Codex 0.146.1 中引入，并继续在 OpenClaw 固定使用的 Codex 0.147.0 中提供。OpenClaw 会将 Codex 返回的不透明远程插件 ID 传递给plugin/read 和 plugin/install；人类可读的插件名称不能替代该 ID。
/codex computer-use install 可以显式安装或重新启用已发现的远程插件。回合开始时的 autoInstall 也可以使用已发现的本地或远程市场。不带 autoInstall 的状态检查和回合不会安装插件或修改 Codex 配置。
配置参考
回合开始时的自动安装会有意拒绝已配置的
marketplaceSource
值。添加新源是一项显式设置操作，因此请使用
/codex computer-use install --source <marketplace-source> 执行一次，然后让
autoInstall 处理后续从已发现的本地或远程市场中重新启用插件的操作。
回合开始时的自动安装可以使用已配置的 marketplacePath，因为那已经是
主机上的本地路径。
每个字段也都支持环境变量覆盖，在对应配置键未设置时会进行检查：
OpenClaw 检查内容
OpenClaw 会在内部报告一个稳定的设置原因，并为聊天格式化 面向用户的状态：
聊天输出包含插件状态、MCP 服务器状态、市场、
可用时的工具，以及失败设置步骤的具体消息。
macOS 权限
这条由 Codex 管理的 Computer Use 路径运行在 macOS 上，MCP 服务器可能需要 本地操作系统权限，才能检查或控制应用。（如需在 Windows 和 Linux 节点主机上进行跨平台 桌面控制，请参阅 cua-computer fulfiller。） 如果 OpenClaw 显示 Computer Use 已安装，但 MCP 服务器不可用，请先确认 Codex 端的 Computer Use 设置：- Codex app-server 正在应当进行桌面控制的同一主机上运行。
- Computer Use 插件已在 Codex 配置中启用。
computer-useMCP 服务器出现在 Codex app-server 的 MCP 状态中。- macOS 已授予桌面控制应用所需的权限。
- 当前主机会话可以访问正在被控制的桌面。
computerUse.enabled 为 true 时，OpenClaw 会刻意采用失败关闭策略。
Codex 模式轮次不应在缺少配置所要求的原生桌面工具时静默继续。
故障排查
状态显示未安装。 运行/codex computer-use install。如果没有发现 marketplace，
请传入 --source 或 --marketplace-path。
状态显示已安装但已禁用。 再次运行 /codex computer-use install
。Codex app-server 安装会将插件配置重新写回为已启用。
发现的远程插件无法安装。 确认 Codex 报告了 marketplace 和插件的不透明远程 ID，然后运行 /codex computer-use install。只能通过显式安装添加新的 marketplaceSource；回合开始时的
autoInstall 会使用 Codex 已经发现的远程 marketplace。
状态显示 MCP 服务器不可用。 重新运行一次安装以便重新加载 MCP 服务器。
如果仍然不可用，请修复 Codex Computer Use 应用、Codex app-server 的 MCP 状态，
或 macOS 权限。
状态或探测在 computer-use.list_apps 上超时。 插件和
MCP 服务器都已存在，但本地 Computer Use bridge 没有响应。
退出或重启 Codex Computer Use，必要时重新启动 Codex Desktop，然后
在一个新的 OpenClaw 会话中重试。如果主机之前通过较旧的受管理 Codex app-server 运行过 Computer Use，
请从桌面捆绑的 marketplace 刷新已安装的插件（对于独立的 Codex desktop 安装，请使用
Codex.app 路径）：
Native hook relay unavailable。Codex 原生工具钩子无法通过本地桥或 Gateway 回退连接到活动的 OpenClaw relay。 使用
/new 或 /reset 开启新的 OpenClaw 会话。如果它第一次可用、随后在后续工具调用中再次失败，
则 /new 只是在清除当前尝试；请重启 Codex app-server 或
OpenClaw Gateway，以便清除旧线程和钩子注册，然后
在新的会话中重试。
回合开始时的自动安装拒绝某个源。 这是有意为之。首先使用显式的 /codex computer-use install --source <marketplace-source> 添加该源，之后回合开始时的自动安装就可以使用
已发现的本地或远程 marketplace。