openai-cua-sample-app

环境要求

• Node.js 22.20.0
• 可通过 Corepack 启用的 pnpm 10.26.0（仓库已锁定版本）
• 可用的 OpenAI API Key，且有权访问所配置的模型
• 运行 Python 版需要 Python 3.10+（仓库锁定 3.12）与 uv

安装与启动步骤

1. 1克隆仓库

   把示例应用下载到本地，后续所有命令都在仓库根目录执行。

   git clone https://github.com/openai/openai-cua-sample-app.git
   cd openai-cua-sample-app

   复制

2. 2启用 Corepack 装依赖

   用 Corepack 启用仓库锁定的 pnpm 版本，并按 lockfile 安装依赖。

   corepack enable
   pnpm install --frozen-lockfile

   复制

3. 3配置环境变量

   复制示例配置，并把 API Key 写入 .env 或导出为环境变量；shell 变量优先级更高。

   cp .env.example .env
   export OPENAI_API_KEY="sk-xxxxxxxx"

   复制

4. 4启动 JS 版智能体

   先安装 Playwright 浏览器依赖，再启动 TypeScript 服务与智能体循环。

   pnpm playwright:install
   pnpm dev:js

   复制

5. 5在控制台发起运行

   打开本地控制台，选择场景、编辑提示词，点击 Start Run 开始执行任务。

6. 6可选启动 Python 版

   需要操作桌面时改用 Python 版：安装依赖、检查桌面权限后启动另一个入口。

   pnpm python:install
   pnpm python:playwright:install
   uv run --project python-app python -m app.desktop.worker --check
   pnpm dev:python

   复制

关键配置

如何确认成功

终端出现服务启动信息后，浏览器打开 http://127.0.0.1:3000 能看到控制台并成功发起一次运行。

常见问题

注意事项

• 运行会发起真实的 API 调用，可能产生费用，测试时注意控制任务规模。
• 示例用于演示 CUA 的接入方式，README 明确说明它不是生产级运行时，OpenAI 自家产品另有运行时与额外控制。
• 命令均在仓库根目录执行，切换 JS 与 Python 应用前先停止当前服务。