OpenAdapt

录一遍 GUI 操作，生成可靠本地自动化程序

OpenAdapt 是一个将 GUI 操作演示编译为确定性本地程序的智能体工具。它通过记录用户的操作流程，将其转化为可重复执行的自动化脚本，解决传统 RPA 脚本脆弱、难以维护的问题。核心能力包括：零模型调用的健康运行、受控修复机制、以及遇到不确定情况时主动暂停而非猜测。它支持桌面应用、浏览器及 Citrix 等虚拟环境，并提供 OpenAdapt-flow 启动器，便于集成。该项目旨在降低自动化门槛，提高流程执行的可靠性和可解释性，适合需要稳定 GUI 自动化的场景。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1738

维护状态较活跃

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队OpenAdaptAI

所属国家

官网地址https://openadapt.ai

GitHubhttps://github.com/OpenAdaptAI/OpenAdapt

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型automation-from-demonstration,browser-automation,citrix,demonstration-compiler,desktop-automation,deterministic-replay,effect-verification,gui-automation,healthcare-automation,local-first,process-automation,python,rdp,rpa,ui-automation,workflow-automation,workflow-compiler

GitHub 星标★ 1738

30天Star增速

HF 下载量

上线时间2023-04-12 00:00:00

最近更新2026-09-23 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数1

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Python 3.10 至 3.12
首次浏览器操作需要网络访问，用于让 Playwright 下载匹配的 Chromium
基础安装已自带 Playwright 与 openadapt-agent，无需额外装运行时
最小化 Linux 主机需能安装 Chromium 共享库（可能要求管理员权限）

安装与启动步骤

1安装 OpenAdapt

用 pip 安装并升级 openadapt，基础包已包含 Playwright 与 openadapt-agent。
```
python -m pip install --upgrade openadapt
```
2运行环境自检

doctor 会在浏览器下载前列出缺失的 Chromium 共享库，先看结果再继续。
```
openadapt doctor --backend web
```
3补装浏览器依赖

仅当 doctor 报缺库时执行；装完再跑一次 doctor 确认通过。
```
python -m playwright install-deps chromium
openadapt doctor --backend web
```
4跑本地教程

在合成 MockMed 上录制、编译、认证并执行，无需账号或 API key，最后给出 VERIFIED 收据。
```
openadapt flow tutorial
```
5验证拒绝误报

界面已显示成功但后端拒绝写入，独立读取记录存储后运行仍会 halt。
```
openadapt quickstart --break-it
```
6启动运行服务

常驻服务，调用方智能体调用 run_local_quickstart 拿收据，看不到任何画面帧。
```
openadapt-agent serve --allow-run
```

7查看编译产物

可视化编译出的 bundle 并做 lint，检查这份流程编译了什么、漏了什么。

openadapt flow visualize tutorials/tutorial-20260828T041000Z/bundle --out graph.html
openadapt flow lint tutorials/tutorial-20260828T041000Z/bundle

关键配置

配置项	必填	说明	示例
`--backend`	否	doctor 自检时指定的后端类型，浏览器场景填 web	`web`
`--allow-run`	否	允许 openadapt-agent 服务接受本地运行请求	`--allow-run`
`--break-it`	否	quickstart 的故障注入开关，用于验证独立读取会阻止误报成功	`--break-it`
`--out`	否	flow visualize 输出的可视化文件路径	`graph.html`

如何确认成功

终端打印 VERIFIED: /run/REPORT.md，并显示 profile standard、model calls 0、effects 2/2 confirmed。

常见问题

Q：需要账号或 API key 吗？

A：不需要。本地教程无需账号或 API key，且运行控制回路中不调用生成式模型 API。

Q：报缺少 Chromium 共享库怎么办？

A：先执行 python -m playwright install-deps chromium 补装依赖，再重新运行 openadapt doctor --backend web；包管理器需要时会请求管理员权限。

Q：首次浏览器操作很慢或失败？

A：首次浏览器动作时 OpenAdapt 会让 Playwright 下载匹配的 Chromium 构建，这一步需要可用的网络访问。

Q：教程里的 VERIFIED 代表生产可用吗？

A：不代表。教程 VERIFIED 只是合成 MockMed 上的本地收据，不是生产 Seal；未签名的生产成功应视为失败。

Q：--break-it 为什么是失败结果？

A：这是刻意设计的：后端在应用已画出成功横幅后拒绝写入，屏幕检查全部通过，但独立读取记录存储不一致，因此运行 halt。

注意事项

本仓库只是安装器和 openadapt 命令，编译器与运行时在 openadapt-flow 中，此仓库不重新实现。
教程的录制、编译产物和运行收据默认写在 tutorials/tutorial- 目录下。
只有 VERIFIED 是生产成功；HALTED_BEFORE_EFFECT、RECONCILIATION_REQUIRED、COMPLETED_UNVERIFIED 等结果互不等价，也绝不能把 halt 当成成功。
修复属于版本化变更，需要评审、按资质契约测试、提升，出错则回滚，而不是允许即兴改动。

核心亮点

确定性执行：健康运行时零模型调用，避免 LLM 幻觉导致的不稳定
受控修复：仅在必要时调用模型，并遵循修复策略，降低出错风险
主动暂停：不确定时停止而非猜测，保障操作安全

不足之处

项目相对年轻，生态和文档有待完善
复杂 GUI 流程的录制和编译可能需较多人工干预

适用场景

企业级桌面应用自动化，如 ERP 数据录入
Citrix 虚拟桌面中的重复性操作自动化
浏览器端跨系统流程的自动化执行

替代项目

UiPath、SikuliX、AutoHotkey

项目介绍

OpenAdapt 是自动化工作流领域的开源项目，由 OpenAdaptAI 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,738）位列前 30%，在自动化工作流分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,676 增加到 1,738，净增 62。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：企业级桌面应用自动化，如ERP数据录入。同类可对比的替代方案包括 UiPath、SikuliX、AutoHotkey。

上一篇：kane-cli

下一篇：comanda