lobster

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

开源 🏷️定价信息待确认 ✅ 目前可打开 自动化工作流 🍴 复刻 289 🐛 待处理 9 👀 关注 18
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1282
维护状态 活跃
是否开源 开源
定价模式 🏷️定价信息待确认

项目预览

lobster 项目界面预览图
图片来源:项目官网

项目数据

分类自动化工作流
开发团队openclaw
定价模式🏷️定价信息待确认
价格说明定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议MIT
主要语言TypeScript
GitHub 星标★ 1282
上线时间2026-01-18 00:00:00
代码更新2026-11-17
仓库体积977 KB
本站数据更新2026-11-21
维护状态活跃
收录时间2026-10-07
浏览次数4

项目介绍

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

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-10-07 · 当前星标 ★ 1282

使用教程

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

环境要求

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

安装与启动步骤

  1. 1克隆仓库

    从 GitHub 拉取 lobster 源码到本地,README 的 quick start 均在该目录下执行。

    git clone https://github.com/openclaw/lobster.git && cd lobster
  2. 2安装依赖

    使用 pnpm 按锁文件精确安装依赖,不要用 npm/yarn,避免依赖版本不一致。

    pnpm install --frozen-lockfile
  3. 3构建项目

    编译 TypeScript 到 dist/,bin/lobster.js 执行的是编译后的入口,改源码后需重新构建。

    pnpm build
  4. 4运行自检

    先看帮助确认 CLI 可用,再跑 doctor 检查本机环境是否满足运行条件。

    node ./bin/lobster.js --help
    node ./bin/lobster.js doctor
  5. 5试跑示例管道

    执行一条内联管道:echo 出 JSON 数组,用 where 过滤,再以 json 输出,验证管道链路正常。

    node ./bin/lobster.js "exec --json --shell 'echo [1,2,3]' | where '0>=0' | json"
  6. 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. 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···

★ 695 2026-10-07
mcp 开源

让 AI 智能体直接操控真机 iPhone 和 Android

Connect AI agents to real iPhones and Androids

★ 828 2026-11-19
libretto 开源

用 AI 让浏览器自动化不再一改页面就崩

The AI toolkit for building reliable browser automations

★ 913 2026-09-18
agbrowse 开源

让 AI 用 JS 直接操控浏览器,省下大笔 token

Ultimate browser automation toolkit for AI agents. Zero MCP token tax, JS evaluate, ···

★ 237 2026-09-18
AIHawk 开源

让 AI 替你上网干活,从批量投简历到任意网页操作

invisible playwright mcp: Playwright MCP server undetected by anti-bots and captchas···

★ 868 2026-09-04
ChattyPlay-Agent 开源

一个工具搞定视频解析、AI 对话和效率黑科技

告别多个App!本项目主要基于Python+React+TypeScript+Hono+SQLite3+Redis,打造“All in ···

★ 1001 2026-08-09
self-hosted 开源

自托管搭内部工具,低代码配流程一键部署

Internal tools and workflow automations

★ 303 2026-11-04
Autofish 开源

一句话指挥 Android,AI 自动帮你点按滑动完成任务

An AI Agent tool to automate Android devices reliably

★ 112 2026-08-09
ai-website-cloner 开源

输入网址,AI 代理帮你克隆重建整个网站

AI website cloner for rebuilding live websites with AI coding agents

★ 155 2026-08-09