项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-07 · 当前星标 ★ 1282
使用教程
环境要求
- 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
同类项目推荐
simprint
开源
开源指纹浏览器,多开隔离防关联
[指纹浏览器] Simprint is an open-source fingerprint browser and programmable browser···
mcp
开源
让 AI 智能体直接操控真机 iPhone 和 Android
Connect AI agents to real iPhones and Androids
libretto
开源
用 AI 让浏览器自动化不再一改页面就崩
The AI toolkit for building reliable browser automations
agbrowse
开源
让 AI 用 JS 直接操控浏览器,省下大笔 token
Ultimate browser automation toolkit for AI agents. Zero MCP token tax, JS evaluate, ···
AIHawk
开源
让 AI 替你上网干活,从批量投简历到任意网页操作
invisible playwright mcp: Playwright MCP server undetected by anti-bots and captchas···
ChattyPlay-Agent
开源
一个工具搞定视频解析、AI 对话和效率黑科技
告别多个App!本项目主要基于Python+React+TypeScript+Hono+SQLite3+Redis,打造“All in ···
self-hosted
开源
自托管搭内部工具,低代码配流程一键部署
Internal tools and workflow automations
Autofish
开源
一句话指挥 Android,AI 自动帮你点按滑动完成任务
An AI Agent tool to automate Android devices reliably
ai-website-cloner
开源
输入网址,AI 代理帮你克隆重建整个网站
AI website cloner for rebuilding live websites with AI coding agents
