Lobster 工作流引擎

概述

Lobster 是 OpenClaw 的工作流 shell，让 Agent 将多步工具序列作为单个确定性操作运行，内置显式审批检查点和可恢复状态。嵌入式运行器在 Gateway 进程内执行，无需外部 CLI。

核心功能

• 确定性管道：JSON 管道规范，易于日志、diff、重放和审查
• 审批门控：副作用步骤（发送邮件、发布评论）暂停等待显式批准
• 可恢复：暂停时返回 resumeToken，批准后继续而无需重新运行已完成步骤
• 支持 .lobster 工作流文件（YAML/JSON，含 steps、condition、approval 字段）
• 与 llm-task 集成：在确定性管道中嵌入结构化 LLM 步骤

工具参数

run 动作：

{
  "action": "run",
  "pipeline": "exec --json --shell 'inbox list --json' | approve --preview-from-stdin",
  "timeoutMs": 30000,
  "maxStdoutBytes": 512000
}

resume 动作：

{
  "action": "resume",
  "token": "<resumeToken>",
  "approve": true
}

输出信封

• ok：成功完成
• needs_approval：暂停，requiresApproval.resumeToken 用于恢复
• cancelled：被拒绝或取消

配置/使用

启用工具（推荐 additive 方式）：

{
  "tools": {
    "alsoAllow": ["lobster"]
  }
}

注意事项

• 嵌入式 Lobster runner 中 openclaw.invoke --tool llm-task 模式不可靠
• 工作流在 Gateway 进程内执行，无网络调用
• 沙箱上下文中禁用
• 超时和输出上限由嵌入式运行器强制执行

相关页面

• concepts/tool-llm-task — LLM Task 工具（Lobster 中的 LLM 步骤）
• concepts/tool-subagents — Sub-agents（另一种任务委托机制）
• concepts/tool-exec — Exec 工具（Lobster 管道中的 shell 执行）