lobster-jobs

将 OpenClaw 的定时任务转换为具备审批关卡和可恢复执行功能的 Lobster 工作流。

目的

OpenClaw 的定时任务主要分为两类：

• systemEvent：简单的 shell 命令（完全确定性）
• agentTurn：生成 AI 代理的自然语言指令（灵活但消耗大量令牌）

Lobster 工作流提供以下优势：

• 确定性执行：无需 LLM 为每个步骤重新规划
• 审批关卡：需要用户明确批准的硬性停止点
• 有状态执行：记住光标位置/检查点
• 可恢复性：能够从上次中断的地方暂停并恢复执行

此技能旨在帮助分析现有的定时任务，并将其转换为 Lobster 工作流。

命令

第一层级（当前可用）

lobster-jobs list

列出所有cron作业及其Lobster就绪度评分。

输出类别：

• ✅完全可迁移：简单的shell命令（systemEvent）
• 🟡部分迁移：混合了确定性步骤与LLM步骤（agentTurn）
• ❌不可迁移：需要大量LLM推理

lobster-jobs inspect <job-id>

检查特定cron作业的详细迁移评估。

显示：

• 作业元数据（计划、目标、负载类型）
• Lobster迁移状态及原因
• 负载预览
• 迁移建议

lobster-jobs validate <workflow-file>

根据模式验证Lobster工作流YAML文件。

检查：

• 必填字段（名称、步骤）
• 步骤结构（ID，命令）
• 审批门语法
• 条件语法

第2层（现已可用）

lobster-jobs convert <任务ID>

将cron任务转换为Lobster工作流。

lobster-jobs convert 17fe68ca
lobster-jobs convert 17fe68ca --output-dir ~/workflows
lobster-jobs convert 17fe68ca --force  # Overwrite existing

生成：

• .lobster工作流文件位于~/.lobster/workflows/
• 从systemEvent或agentTurn有效载荷中提取命令
• 自动验证生成的工作流

选项：

• --output-dir, -o：自定义输出目录
• --force, -f：覆盖现有工作流
• --keep-on-error：即使验证失败也保留文件

lobster-jobs new <名称>

使用模板从头创建新的Lobster工作流。

lobster-jobs new my-workflow
lobster-jobs new my-workflow --template with-approval
lobster-jobs new my-workflow --template stateful

模板：

• 简单shell基本命令执行
• 需审批：审批门控工作流
• 有状态：带游标/状态跟踪的工作流

安装

# Add to PATH
export PATH="$PATH:/home/art/niemand/skills/lobster-jobs/bin"

# Or create symlink
ln -s /home/art/niemand/skills/lobster-jobs/bin/lobster-jobs ~/.local/bin/

快速开始

# See all your cron jobs and their migration status
lobster-jobs list

# Inspect a specific job
lobster-jobs inspect 17fe68ca

# Convert a job to Lobster workflow
lobster-jobs convert 17fe68ca

# Create a new workflow from template
lobster-jobs new my-workflow --template with-approval

# Validate a workflow file
lobster-jobs validate ~/.lobster/workflows/my-workflow.lobster

工作流文件格式

name: my-workflow
description: Optional description

steps:
  - id: fetch_data
    command: some-cli fetch --json
    
  - id: process
    command: some-cli process
    stdin: $fetch_data.stdout
    
  - id: approve_send
    command: approve --prompt "Send notification?"
    approval: required
    
  - id: send
    command: message.send --channel telegram --text "Done!"
    condition: $approve_send.approved

迁移策略

包装器方法（推荐）

保留cron作为调度器，修改负载以调用Lobster：

{
  "payload": {
    "kind": "systemEvent",
    "text": "lobster run ~/.lobster/workflows/my-workflow.lobster"
  }
}

优势：

• 回滚很简单（恢复负载）
• 增量迁移
• Cron调度已可用

处理LLM判断

对于需要确定性步骤和LLM推理的任务：

steps:
  - id: gather
    command: gh issue list --json title,body
    
  - id: triage
    command: clawd.invoke
    prompt: "Classify these issues by urgency"
    
  - id: notify
    command: telegram-send

工作流是确定性的；LLM是一个黑盒步骤。

边界情况

引用

• Lobster项目：https://github.com/openclaw/lobster
• Lobster项目愿景：https://github.com/openclaw/lobster/blob/main/VISION.md