OpenClaw从入门到应用——工具(Tools):Lobster
通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》Lobster 是一个工作流 Shell它让 OpenClaw 将多步工具序列作为单一的、确定性的操作来运行并带有明确的审批检查点。引子你的助手可以构建管理自身的工具。只要要求一个工作流30 分钟后你就能得到一个 CLI 以及能以一次调用运行的管道。Lobster 正是那缺失的一环确定性的管道、明确的审批以及可恢复的状态。为什么需要 Lobster如今复杂的工作流往往需要多次来回的工具调用。每次调用都会消耗 token而 LLM 必须编排每一步。Lobster 将这种编排转移到了类型化的运行时中一次调用替代多次调用OpenClaw 执行一次 Lobster 工具调用并获得结构化的结果。内置审批副作用发送邮件、发表评论会暂停工作流直到得到明确批准。可恢复暂停的工作流会返回一个令牌批准后可恢复运行无需重新执行所有步骤。为什么用 DSL 而不是普通程序Lobster 刻意保持精简。目标并不是“一种新语言”而是一个可预测、对 AI 友好的管道规范并原生支持审批和恢复令牌。审批/恢复是内置的普通程序可以提示人类但无法在不自行实现相应运行时的前提下通过持久令牌暂停并恢复。确定性与可审计性管道就是数据因此易于记录、对比、重放和审查。对 AI 的约束面极小的语法加上 JSON 管道减少了“创造性”代码路径并使验证切实可行。内置安全策略超时、输出上限、沙箱检查和允许列表均由运行时强制执行而非每个脚本自行处理。仍然可编程每个步骤都可以调用任何 CLI 或脚本。如果你想使用 JS/TS可以从代码生成.lobster文件。工作原理OpenClaw 在工具模式下启动本地lobsterCLI并从 stdout 解析 JSON 信封。如果管道因需要审批而暂停该工具会返回一个resumeToken以便稍后继续。模式小型 CLI JSON 管道 审批构建一些能输出 JSON 的小命令然后将它们串联到一个 Lobster 调用中。以下示例命令名仅作示意可替换为你自己的。inbox list--jsoninbox categorize--jsoninbox apply--json{action:run,pipeline:exec --json --shell inbox list --json | exec --stdin json --shell inbox categorize --json | exec --stdin json --shell inbox apply --json | approve --preview-from-stdin --limit 5 --prompt Apply changes?,timeoutMs:30000}如果管道请求审批则使用令牌恢复{action:resume,token:resumeToken,approve:true}AI 触发工作流Lobster 执行这些步骤。审批关卡让副作用保持明确且可审计。示例将输入项映射为工具调用gog.gmail.search--querynewer_than:1d\|openclaw.invoke--toolmessage--actionsend--each--item-key message --args-json{provider:telegram,to:...}纯 JSON 的 LLM 步骤llm-task对于需要结构化的 LLM 步骤的工作流请启用可选的llm-task插件工具并在 Lobster 中调用它。这既保持了工作流的确定性又能让你使用模型进行分类/总结/起草。启用该工具{plugins:{entries:{llm-task:{enabled:true}}},agents:{list:[{id:main,tools:{allow:[llm-task]}}]}}在管道中使用openclaw.invoke --tool llm-task --action json --args-json { prompt: Given the input email, return intent and draft., thinking: low, input: { subject: Hello, body: Can you help? }, schema: { type: object, properties: { intent: { type: string }, draft: { type: string } }, required: [intent, draft], additionalProperties: false } }有关详细信息和配置选项请参阅 LLM Task。工作流文件.lobsterLobster 可以运行包含name、args、steps、env、condition和approval字段的 YAML/JSON 工作流文件。在 OpenClaw 工具调用中将pipeline设置为文件路径。name:inbox-triageargs:tag:default:familysteps:-id:collectcommand:inbox list--json-id:categorizecommand:inbox categorize--jsonstdin:$collect.stdout-id:approvecommand:inbox apply--approvestdin:$categorize.stdoutapproval:required-id:executecommand:inbox apply--executestdin:$categorize.stdoutcondition:$approve.approved注意事项stdin: $step.stdout和stdin: $step.json会传递前一步的输出。condition或when可以根据$step.approved来控制步骤的执行。安装 Lobster在运行 OpenClaw 网关的同一台主机上安装 Lobster CLI参见 Lobster 仓库并确保lobster在PATH中。启用工具Lobster 是一个可选的插件工具默认不启用。推荐配置增量式安全{tools:{alsoAllow:[lobster]}}或者按代理配置{agents:{list:[{id:main,tools:{alsoAllow:[lobster]}}]}}除非你打算以限制性允许列表模式运行否则应避免使用tools.allow: [lobster]。注意对于可选插件允许列表是选择性加入的。如果你的允许列表只列出了插件工具如lobsterOpenClaw 仍会保持核心工具可用。若要限制核心工具请在允许列表中同时包含你需要的核心工具或工具组。示例邮件分类没有 Lobster 时用户“检查我的邮件并起草回复” → openclaw 调用 gmail.list → LLM 进行总结 → 用户“为 #2 和 #5 起草回复” → LLM 起草 → 用户“发送 #2” → openclaw 调用 gmail.send 每天重复没有关于已处理内容的记忆使用 Lobster 时{action:run,pipeline:email.triage --limit 20,timeoutMs:30000}返回一个 JSON 信封已截断{ok:true,status:needs_approval,output:[{summary:5 need replies, 2 need action}],requiresApproval:{type:approval_request,prompt:Send 2 draft replies?,items:[],resumeToken:...}}用户批准 → 恢复{action:resume,token:resumeToken,approve:true}一个工作流。确定性强。安全可靠。工具参数run在工具模式下运行管道。{action:run,pipeline:gog.gmail.search --query newer_than:1d | email.triage,cwd:workspace,timeoutMs:30000,maxStdoutBytes:512000}带参数运行工作流文件{action:run,pipeline:/path/to/inbox-triage.lobster,argsJson:{\tag\:\family\}}resume在审批后继续已暂停的工作流。{action:resume,token:resumeToken,approve:true}可选输入cwd管道的相对工作目录必须保持在当前进程的工作目录之内。timeoutMs如果子进程超过此持续时间则终止它默认20000。maxStdoutBytes如果 stdout 超过此大小则终止子进程默认512000。argsJson传递给lobster run --args-json的 JSON 字符串仅用于工作流文件。输出信封Lobster 会返回一个 JSON 信封包含以下三种状态之一ok→ 成功完成needs_approval→ 已暂停需要requiresApproval.resumeToken才能恢复cancelled→ 被明确拒绝或取消该工具在content格式化的 JSON和details原始对象中均会提供此信封。审批如果存在requiresApproval请检查提示并决定approve: true→ 恢复并继续执行副作用approve: false→ 取消并终结工作流使用approve --preview-from-stdin --limit N可以将 JSON 预览附加到审批请求中而无需使用自定义的 jq/heredoc 胶水代码。恢复令牌现在十分紧凑Lobster 将工作流恢复状态存储在其状态目录下并返回一个小型的令牌键。OpenProseOpenProse 与 Lobster 能很好地搭配使用先用/prose编排多代理的准备工作然后运行 Lobster 管道进行确定性的审批。如果某个 Prose 程序需要 Lobster可通过tools.subagents.tools为子代理允许lobster工具。请参阅 OpenProse。安全性仅本地子进程— 插件本身不进行网络调用。无密钥— Lobster 不管理 OAuth它调用的是负责管理这些的 OpenClaw 工具。沙箱感知— 当工具上下文被沙箱化时该工具将被禁用。加固— 固定可执行文件名为lobster并在PATH中查找强制执行超时和输出上限。故障排除lobster subprocess timed out→ 增大timeoutMs或者拆分较长的管道。lobster output exceeded maxStdoutBytes→ 提高maxStdoutBytes或减少输出大小。lobster returned invalid JSON→ 确保管道在工具模式下运行并且仅输出 JSON。lobster failed (code …)→ 在终端中运行相同的管道检查 stderr。了解更多插件插件工具编写案例研究社区工作流一个公开示例一个“第二大脑” CLI 加上 Lobster 管道用来管理三个 Markdown 知识库个人、伴侣、共享。该 CLI 能够以 JSON 格式输出统计信息、收件箱列表以及过期扫描结果Lobster 将这些命令串联成诸如weekly-review、inbox-triage、memory-consolidation和shared-task-sync等工作流每个工作流都带有审批关卡。当 AI 可用时它负责处理判断分类不可用时则回退到确定性规则。讨论串https://x.com/plattenschieber/status/2014508656335770033仓库https://github.com/bloomedai/brain-cli