OpenClaw自己的工作流引擎:Lobster


Lobster 是 OpenClaw 的*类型化工作流运行时(typed workflow runtime),用于将多步骤的工具调用组合成一个 单次、可控、可暂停的流程,中间带有 显式审批检查点。


核心价值

1. 多步工作流变成一条调用

传统上,复杂操作要 LLM 不断来回调用工具(每步都消耗 tokens),而 Lobster 只需一次调用 就能执行整个工作流程。
这让执行变得更高效、更节省令牌成本。

2. 内置审批才是真亮点

某些操作有副作用(例如发送邮件、发帖子、修改数据),Lobster 会在此类副作用前自动停下,并请求审批
用户批准后,工作流程再继续。这种模型让自动化更可审计、更安全。

3. 暂停/恢复执行

如果流程因为审批而停下,Lobster 会返回一个 resumeToken(恢复令牌)。
用户批准后,只需带着这个令牌重新发起请求即可继续,整个过程不会重复前面的步骤。
这类似 “状态机可恢复执行”,特别适合长流程或需人工干预的场景。



核心机制与特点

以 JSON 管道定义流程

Lobster 利用小型 CLI + JSON 数据管道来构建工作流,而不是直接编写大型脚本或程序。这带来:

* 确定性高:执行顺序清晰可预测(适合自动化与审计)
* 易于审计 & 复放:每个流程是数据(JSON 或 YAML),易于版本控制和审查
* 安全性更好:运行时强制策略(超时、输出上限、白名单等)由 Lobster 处理,而不是分散在多个脚本里



使用方式

1. 写 Lobster 管道

比如你要做邮件收件 + 分类 + 批准 + 发送操作,可以写 .lobster 文件或用 JSON 管道:

json
{
  "action": "run",
  "pipeline": "inbox-list | inbox-categorize | approve --prompt 'Apply changes?' | inbox-apply",
  "timeoutMs": 30000
}

每个步骤的输出会输送到下一个步骤的输入。([OpenClaw][1])



▶️ 2. 运行工作流

你用 OpenClaw 启动 Lobster CLI:

bash
{
  "action": "run",
  "pipeline": "email.triage --limit 20",
  "timeoutMs": 30000
}

如果流程需要人工审批,会返回如下 JSON:

json
{
  "status": "needs_approval",
  "requiresApproval": {
    "prompt": "Send 2 draft replies?",
    "resumeToken": "..."
  }
}

之后你用返回的 resumeToken 来继续审批!



与 OpenClaw 的协同

* Lobster 是 OpenClaw 的可选插件工具,不是默认启用,需要在配置里允许它出现(如 tools.alsoAllow: ["lobster"])。
* 它适合构建复杂、可审核的多步自动化流程,让 OpenClaw 的 AI 自动化能力更实用、更安全。



适合哪些场景

✅ 自动化邮件处理
✅ 多步骤任务自动操作(有审批惜步)
✅ CLI 工具链自动执行流程
✅ 有安全/审计要求的自动化任务