OpenClaw 使用 Codex Computer Use 完整教程

这份教程解决什么问题

这篇教程把 在 macOS 上让 OpenClaw 接入 Codex Computer Use，从安装 Codex 桌面应用、配置系统权限，到完成 MCP server 集成、能让 agent 直接操控电脑的完整流程 整理了一遍。读完之后，你的 OpenClaw 应该可以通过 /codex 直接调用 GUI 控制能力。

重要前提：Computer Use 功能 只支持 macOS。Windows 和 Linux 暂时无法使用，原因在最后一节会解释。

一、什么是 Computer Use

Computer Use 是 OpenAI Codex 的 GUI 控制能力，允许 AI agent 直接操控你的 Mac 电脑：点击按钮、输入文字、打开应用、执行操作，就像一个真实的用户在使用你的电脑一样。

整个调用链路是这样的：

Codex App (桌面应用 / app-server)
    ↓
Computer Use MCP server
    ↓
OpenClaw /codex 插件

注意：Computer Use 不是 CLI 功能。

它依赖 /Applications/Codex.app 作为本地 app-server 在后台运行，通过 MCP 协议向外暴露控制能力，再由 OpenClaw 的 /codex 插件调用。npm install -g @openai/codex 装的是命令行工具，跟 Computer Use 是两回事，不要混淆。

二、系统要求

如果你这几项不全，先把它们补齐再开始下面的步骤。

三、安装 Codex 桌面应用

从 OpenAI 官方渠道下载并安装 Codex.app，安装完成后确认应用位于：

/Applications/Codex.app

如果你装在了非默认路径（比如某个开发目录），需要手动向 Marketplace 注册一下：

codex plugin marketplace add /path/to/Codex.app

安装完启动一下 Codex，确保它的 app-server 在后台正常运行。这个 app-server 是后续所有功能的基础，它必须始终保持运行，否则 OpenClaw 调不到任何 Computer Use 能力。

四、macOS 权限配置

Computer Use 需要两个系统权限，缺一不可。这两步是最容易卡住人的地方，请按顺序仔细做。

1. 开启辅助功能权限

1. 打开 系统设置 → 隐私与安全性 → 辅助功能
2. 在列表里找到 Codex
3. 打开右边那个开关，允许访问

2. 开启屏幕录制权限

1. 打开 系统设置 → 隐私与安全性 → 屏幕录制和系统录音
2. 在列表里找到 Codex
3. 打开右边那个开关，允许访问

提示：权限改完之后，如果发现没生效，完全退出 Codex.app（不是关闭窗口，是 Cmd+Q 退出整个进程）后重新启动。macOS 的权限刷新偶尔需要重启进程才能生效。

权限要授权给 Codex 这个应用本身，不是 Terminal、不是 iTerm、不是其他壳。如果你给错应用授权了，Codex 还是会因为没权限报错。

五、安装 Computer Use 组件

权限配置好之后，回到 OpenClaw，运行：

/codex computer-use install

这条命令会自动下载并安装 Computer Use MCP server，然后把它注册到 OpenClaw 插件系统里。

验证安装状态

安装完成后，运行：

/codex computer-use status

正常的话，输出大概是这样：

✓ Codex app-server: running
✓ Computer Use MCP server: online
✓ OpenClaw plugin binding: active

三项都是 ✓ 就说明安装成功了。如果有任何一项不正常，先回到第四节检查权限，或者跳到第九节看常见错误排查。

六、OpenClaw 集成配置

安装完之后，需要在 OpenClaw 的 settings.json 里加两段配置，才能让 Codex Computer Use 真正接管 agent runtime。

1. 配置 Computer Use 自动安装

{
  "plugins": {
    "entries": {
      "codex": {
        "config": {
          "computerUse": {
            "autoInstall": true
          }
        }
      }
    }
  }
}

autoInstall: true 的作用是：以后 OpenClaw 启动时，如果发现 Computer Use MCP server 没在跑，会自动重新安装一次，不需要你手动重跑命令。

2. 配置 Agent Runtime

{
  "agentRuntime": {
    "id": "codex",
    "fallback": "none"
  }
}

fallback: "none" 这条很关键：如果 Codex app-server 不可用，OpenClaw 不会 静默降级到其他 runtime，而是直接报错。这样能让你第一时间发现问题，避免你以为在用 Codex、实际上跑的是别的模型。

这两段配置都写进同一个 settings.json 文件里就行，不需要分开放。

七、验证 MCP Server 状态

集成配置完之后，再做最后一步检查。

运行：

/codex mcp

在输出列表里找到 computer-use，确认它的状态是 online：

NAME            TYPE    STATUS
computer-use    stdio   online
github          stdio   online

如果 computer-use 没出现在列表里，或者状态显示 offline，重新跑一次：

/codex computer-use install

到这一步如果一切正常，恭喜，你已经可以开始用 Codex Computer Use 了。下一步可以试试让 agent 帮你打开一个应用、操作一下界面，看看效果。

八、常用命令参考

下面这些命令是日常使用 Codex 时最常用的，建议记一下：

九、常见错误排查

1. plugin_not_installed

原因：OpenClaw 找不到 Computer Use 插件的绑定。

解决：

1. 运行 /codex computer-use install
2. 确认 settings.json 里 computerUse.autoInstall: true 已经配置好
3. 重启 OpenClaw

2. mcp_missing

原因：Computer Use MCP server 没启动，或者没在 MCP 列表里注册。

解决：

1. 确认 Codex.app 正在运行（app-server 需要保持后台运行，关掉应用 MCP 就断了）
2. 运行 /codex mcp 查看 server 列表
3. 如果 computer-use 不在列表里，运行 /codex computer-use install 重新装一次

3. remote_install_unsupported

原因：试图在远程环境（云服务器、SSH 远程登录、非本地 macOS）里安装 Computer Use。

解决：Computer Use 只支持本地 macOS 环境，没法在远程服务器上跑，也没法通过 SSH 在另一台 Mac 上运行。必须在 Mac 本机的终端里操作。

4. /codex computer-use install 报权限错误

回到第四节，确认 macOS 系统设置里下面两项权限是给 Codex 这个应用 开的（不是 Terminal、不是 iTerm）：

• 辅助功能
• 屏幕录制和系统录音

授权对象搞错是这个错误最常见的原因。

5. Windows / Linux 能用 Computer Use 吗？

不能。

Computer Use 依赖 macOS 的 Accessibility API（辅助功能 API）来读取屏幕信息、模拟点击和键盘输入。这套 API 是 Apple 操作系统专属的，Windows 和 Linux 没有等价能力，所以目前 Computer Use 只能在 macOS 上跑。

如果你只有 Windows 或 Linux 机器，可以考虑：

• 用其他 OpenClaw skill（比如 browser、tmux 之类）替代 GUI 操作
• 或者准备一台 Mac 专门用于 Computer Use 任务

写在最后

Codex Computer Use 是目前 OpenClaw 里最接近"真正让 agent 替你用电脑"的能力。它的安装步骤其实不复杂，最容易踩坑的是 macOS 权限授权对象搞错 和 Codex.app 没保持运行 这两个点。如果你卡住了，先回头检查这两件事，再去看 MCP 状态，多数问题都能定位到。

跑通之后，你可以开始尝试让 agent 帮你做一些固定流程的桌面操作，比如打开某个应用、填表单、整理文件夹之类。这是一种和 CLI 完全不同的交互方式，值得花一晚上熟悉一下。