lobster

把多个工具串成一条流水线，Openclaw 一步调用

Lobster 是一个面向 Openclaw 生态的原生工作流 shell，定位为带类型的、本地优先的宏引擎。它把各类技能和工具封装成可组合的流水线，让原本分散的调用步骤收敛成一条可复用、可审计的自动化链路。核心解决的问题是：在 Openclaw 中调用多个工具时，往往需要手写多步编排逻辑，既重复又容易出错；Lobster 用类型化的工作流描述把这些步骤抽象成管道，并强调本地优先执行，减少对外部服务的依赖。它支持把工作流作为单一步骤被 Openclaw 直接调用，从而把复杂自动化封装成简单接口。对需要频繁组合技能、构建安全自动化流程的开发者来说，Lobster 提供了更接近 shell 的直觉体验，同时保留类型约束带来的可靠性。

开源 unknown 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1269

维护状态活跃

是否开源是

定价模式 unknown

项目预览

项目数据

分类自动化工作流

开发团队openclaw

所属国家

官网地址https://docs.openclaw.ai/tools/lobster

GitHubhttps://github.com/openclaw/lobster

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型

GitHub 星标★ 1269

30天Star增速

HF 下载量

上线时间2026-01-18 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-07

浏览次数0

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

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

环境要求

Node.js 22 或更高版本
pnpm，版本需与 package.json 中 pin 的版本一致
本地需先构建生成 dist/（bin/lobster.js 运行的是编译产物）
若工作流中用到 gh 等外部命令，需自行在系统中安装

安装与启动步骤

1克隆仓库

从 GitHub 拉取 lobster 源码到本地，README 的 quick start 均在该目录下执行。
```
git clone https://github.com/openclaw/lobster.git && cd lobster
```
2安装依赖

使用 pnpm 按锁文件精确安装依赖，不要用 npm/yarn，避免依赖版本不一致。
```
pnpm install --frozen-lockfile
```
3构建项目

编译 TypeScript 到 dist/，bin/lobster.js 执行的是编译后的入口，改源码后需重新构建。
```
pnpm build
```
4运行自检

先看帮助确认 CLI 可用，再跑 doctor 检查本机环境是否满足运行条件。
```
node ./bin/lobster.js --help
node ./bin/lobster.js doctor
```
5试跑示例管道

执行一条内联管道：echo 出 JSON 数组，用 where 过滤，再以 json 输出，验证管道链路正常。
```
node ./bin/lobster.js "exec --json --shell 'echo [1,2,3]' | where '0>=0' | json"
```

6运行命名工作流

调用内置的 github.pr.monitor.notify 工作流，参数用 --args-json 传入仓库与 PR 号。

node bin/lobster.js run --mode tool "workflows.run --name github.pr.monitor.notify --args-json '{"repo":"openclaw/lobster","pr":167}'"

7测试与检查

可选：pnpm test 会先跑 tsc 再对 dist/ 执行测试，pnpm lint 做代码检查。
```
pnpm test
pnpm lint
```

关键配置

配置项	必填	说明	示例
`steps[].id`	是	工作流中每一步的唯一标识，供后续步骤引用其输出。	`make_words`
`steps[].run`	否	仅用于 shell 中的真实可执行程序，如 openclaw.invoke、echo。	`run: echo "One two three four five six"`
`steps[].pipeline`	否	用于 Lobster 管道阶段（LLM 类），如 openclaw.agent、llm.invoke、llm_task.invoke。	`pipeline: llm_task.invoke --prompt "How many words have been`
`steps[].stdin`	否	把前一步的输出作为输入/artifacts 传给当前步骤。	`stdin: $make_words.stdout`

如何确认成功

node ./bin/lobster.js doctor 正常返回，且示例管道能输出过滤后的 JSON 结果即启动成功。

常见问题

Q：运行时报 Node 版本错误怎么办？

A：Lobster 要求 Node.js 22 或更高版本，请升级 Node 后重新执行 pnpm install 与 pnpm build。

Q：调用 LLM 为什么用 run: 会失败？

A：openclaw.agent、llm.invoke、llm_task.invoke 属于 Lobster 管道阶段，必须用 pipeline:；run: 只接受 shell 中的真实二进制。

Q：执行 bin/lobster.js 报找不到模块？

A：它运行的是 dist/ 下的编译产物，先执行 pnpm build；修改过源码后也要重新构建。

Q：工作流文件路径写错会怎样？

A：会作为输入错误返回退出码 2；在 --mode tool 下使用与其他错误相同的 JSON 错误信封。

注意事项

Lobster 不持有 OAuth/token，不新增鉴权面，凭据仍由外部工具管理。
执行本地优先，尽量减少对外部服务的依赖。
支持把整条工作流作为单一步骤被 OpenClaw 调用，用于节省 token。
pnpm 版本以 package.json 中 pin 的为准，不要随意升级。

核心亮点

类型化工作流定义，组合技能时能提前发现接口不匹配
本地优先执行，敏感自动化不必依赖外部编排服务
与 Openclaw 原生集成，工作流可被当作单一步骤调用

不足之处

强绑定 Openclaw 生态，脱离该环境后价值大幅下降
项目处于成长阶段，文档与社区案例可能还不够丰富

适用场景

把多个 Openclaw 技能串成一条可复用自动化流水线
为重复性多步操作封装成单个工作流接口供团队调用
在本地构建带类型约束的安全自动化脚本

替代项目

n8n、Activepieces

项目介绍

lobster 是自动化工作流领域的开源项目，由 openclaw 开发，是 2026 年新上线的项目。

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

项目目前处于活跃维护状态，最近一次代码更新于 2026-10-02。

它主要面向的使用场景是：把多个Openclaw技能串成一条可复用自动化流水线。同类可对比的替代方案包括 n8n、Activepieces。

上一篇：workflowbuilder

下一篇：Go-High-Level-MCP-2026-Complete