
openwork
用代码把零散任务串成自动流水线,少写重复脚本
openwork 是一个用 TypeScript 编写的开源自动化工作流项目,目标是让开发者用代码定义、编排并执行跨系统的任务流程。它把常见的触发、条件判断、循环、HTTP 请求、数据转换等步骤抽象为可组合的节点,通过声明式配置或脚本把零散的手工操作串成可复用的流水线,从而减少重复劳动和人为失误。项目强调轻量与可嵌入,既可以作为独立服务运行,也能集成进现有 Node.js 应用,适合需要把内部工具、API 和定时任务连接起来的团队。它提供运行状态追踪与错误处理机制,便于排查失败环节,并支持自定义节点扩展,让使用者按自身业务补充能力。整体定位偏向开发者友好,用类型系统降低配置出错概率,在自动化工具链中扮演“胶水层”角色。
项目数据
使用教程
环境要求
- Node.js 18 或更高版本
- npm(随 Node.js 一起安装)
- 至少一个受支持模型的 API Key(Anthropic / OpenAI / Google)
- 一个你信任的本地工作区目录(openwork 会访问文件系统并执行 shell 命令)
安装与启动步骤
-
1用 npx 直接运行
不安装到全局,直接用 npx 拉取并启动 openwork,适合先试用。启动后会打开桌面界面。
npx openwork -
2或全局安装后启动
想反复使用可全局安装,安装后直接输入 openwork 命令启动。
npm install -g openwork openwork -
3从源码运行
需要改代码或调试时,克隆仓库后安装依赖并以开发模式启动。
git clone https://github.com/langchain-ai/openwork.git cd openwork npm install npm run dev -
4在设置面板配置模型
启动后在应用内的 settings panel(设置面板)中配置所选模型提供商与凭据,无需改命令行参数。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
模型提供商 | 是 | 在设置面板中选择 Anthropic、OpenAI 或 Google 中的一家 | Anthropic |
模型名称 | 是 | 选择该提供商下 README 列出的可用模型 | Claude Sonnet 4.5 |
API Key | 是 | 所选提供商的访问密钥,在应用内设置面板填写 | sk-xxxxxxxx |
如何确认成功
openwork 桌面界面正常打开,且设置面板中配置的模型可被选择并正常调用,即启动成功。
常见问题
Q:运行时报 Node 版本错误怎么办?
A:openwork 要求 Node.js 18+,请先升级 Node.js(如使用 nvm 切换版本)后重新执行 npx openwork 或 openwork。
Q:可以用哪些模型?
A:README 列出 Anthropic(Claude Opus/Sonnet/Haiku 等)、OpenAI(GPT-5.x、o3、o4 Mini、GPT-4.1、GPT-4o 等)和 Google(Gemini 3 / 2.5 系列)三家。
Q:没有全局安装也能用吗?
A:可以,使用 npx openwork 每次拉取运行,无需全局安装;需要频繁使用时再执行 npm install -g openwork。
Q:源码模式启动失败怎么办?
A:确认已进入 openwork 目录、Node.js 为 18+,并先执行 npm install 安装依赖,再运行 npm run dev。
注意事项
- openwork 会让 AI 代理直接访问你的文件系统并执行 shell 命令,请谨慎操作。
- 每次批准工具调用前先审查调用内容,不要盲目点同意。
- 只在你自己信任的工作区目录中运行,避免在含敏感数据的目录下使用。
- README 中未给出端口、配置文件路径等细节,相关配置以应用内设置面板为准。
核心亮点
- TypeScript 实现,类型提示完善,配置阶段即可发现拼写和结构错误
- 支持自定义节点扩展,能接入自有 API 和内部系统,不被内置能力限制
- 可独立运行也可嵌入现有 Node.js 应用,部署方式灵活
不足之处
- 生态和内置节点数量相比成熟工作流平台仍有限
- 社区规模较小,中文资料和现成案例偏少
适用场景
- 把多个内部 API 按顺序调用并做数据转换的日常运维任务
- 定时抓取数据、清洗后写入数据库或发送通知的流水线
- 将重复的手工发布、同步、对账步骤固化为可复用流程
替代项目
n8n、Activepieces、Windmill
项目介绍
上一篇:ai.robots.txt
下一篇:cli
同类项目推荐
n8n
开源
拖拽搭建自动化流程,轻松接入 AI 与 400+ 应用,搞定重复工作。
Fair-code workflow automation platform with native AI capabilities. Combine visual b···
robotcode
开源
让 Robot Framework 拥有现代 IDE 体验,调试、补全、运行一气呵成。
Open Source Toolkit for Robot Framework, providing Language Server Protocol support,···
puppeteer
开源
用 JavaScript 轻松操控无头浏览器,搞定自动化测试与网页抓取。
JavaScript API for Chrome and Firefox
customermates
开源
比 Pipedrive 直观 10 倍的现代开源 CRM,轻松管理客户与自动化流程。
Building a modern alternative to Pipedrive that is 10x more intuitive.