OpenAdapt：可验证的计算机操作执行层

项目简介

OpenAdapt 是面向 computer-use agent 的开源、可验证执行层。计算机操作代理每次运行都要重新看屏幕、重新决定点哪里；OpenAdapt 让人或 agent 在一个 Web、Windows、macOS、Linux 或远程桌面应用里完成一次任务，把这次运行编译成一个程序，之后 agent 只需把这个程序当作一个工具调用。

程序运行时没有模型调用，也不发送任何截图。每次保存前它确认目标记录，保存后从系统记录里读回结果，并返回一个朴素的结果；一旦有不匹配，它停下来告诉 agent，而不是猜测。

主要功能

• 三种模式：Explore（人或 agent 做一次任务，过程中记录每个动作，编译前先读回保存结果）、Run（编译后的程序用新输入重复任务，0 次模型调用）、Repair（应用发生变化时在保存前停下，由 agent 给出修复方案，再由人批准）。
• 保存后读回校验：屏幕上的“已保存”提示不等于真的保存成功。OpenAdapt 通过独立读取系统记录来判定写入是否真的落地。
• 多后端：同一套记录、编译、运行、修复流程可用于 Web、Windows、macOS、Linux、RDP 与 Citrix；能拿到应用结构时用结构，远程桌面则基于像素工作。
• 作为工具供 agent 调用：每个编译好的工作流成为一个工具调用，agent 决定输入什么，OpenAdapt 负责录入、校验并返回结果。
• 判定与训练：openadapt flow verify-run 可用系统记录判定任意 agent 或脚本的写入；openadapt-flow serve-reward 把同样的检查转成训练或评测 computer-use agent 的奖励。
• 多次录制合并：同一任务的多次录制可以通过 openadapt flow induce 合并成一个带分支和循环的程序。

官方在 OpenEMR 与 openIMIS 测试副本上公布了基准：程序化执行 0 次模型调用、$0 模型成本，OpenEMR 上把 41 个屏幕步骤替换为一次表单提交的 API 步骤后约 3.3 秒完成一条转诊；openIMIS 上无模型调用录入 149 条合成理赔，148 条读回正确、无误写。

安装与使用

一条命令试用，无需账号或 API key：

uvx --python 3.12 openadapt quickstart --break-it

也可以用 pip：

python -m pip install --upgrade openadapt
openadapt quickstart --break-it

手动录制、编译与回放：

openadapt flow record --url https://staging.your-app.example --out rec
openadapt flow compile rec --out bundle --name my-first-workflow
openadapt flow replay bundle --url https://staging.your-app.example --run-dir run

把编译好的程序接入 agent：

claude mcp add openadapt -- uvx --python 3.12 openadapt-agent serve

无自带工作流时，服务会提供一个合成沙箱工作流。要提供自己的工作流，用 openadapt agent serve --mode production --bundles ./bundles；不带 --mode production 时 agent 只能列出而不能运行它们。

用代码编译 agent 的一次运行：

from openadapt_flow.jit import compile_agent

jit = compile_agent(my_agent, task=task, app=app, verifier=verifier,
                    policy="clinical-write", cache_dir="jit-cache", model_key=key)
jit.run(note="Follow up in two weeks")  # agent 执行，保存为 DRAFT
# 由人审阅、跑金丝雀并准入草稿
jit.run(note="Recheck knee in ten days")  # 程序执行：0 次模型调用

桌面应用录制需要额外安装录制器和对应系统的适配器，例如 python -m pip install "openadapt[capture,windows]"，或使用 OpenAdapt Desktop。

注意事项

• openadapt flow replay 会驱动应用执行所有录制的动作，包括不可撤销的保存，不会先询问，也不检查保存结果。请指向测试或预发布副本，绝不要指向生产数据。
• 写入真实系统的程序还需要记录校验、部署文件、认证、资格与准入，之后才由 openadapt flow run 运行；默认每次保存都要在 OpenAdapt Desktop 或配对的手机上由人批准。
• 基准数字均来自测试副本与合成数据；OpenAdapt 与 OpenEMR 项目没有关联。
• 最新版本 0.25.0 的原生安装包为候选版本：macOS 仅 ad-hoc 签名未公证，Windows 未签名，Linux 无包签名，可用 SHA256SUMS 与 GitHub attestation 校验下载。

---

本作品整理自 GitHub 开源项目 OpenAdaptAI/OpenAdapt，原作者 @OpenAdaptAI，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。