Community translations by veiseule.ai — Help improve them on Crowdin
Skip to main content

Lobster

Lobster သည် OpenClaw ကို အဆင့်များစွာပါဝင်သော tool အစီအစဉ်များကို တစ်ခုတည်းသော၊ သတ်မှတ်ချက်ပြည့်မီသည့် လုပ်ဆောင်မှုအဖြစ် လည်ပတ်စေနိုင်ပြီး ထင်ရှားသော အတည်ပြုချက် checkpoint များပါဝင်စေသည့် workflow shell ဖြစ်သည်။

ဆွဲဆောင်ချက်

သင့် assistant သည် ကိုယ်တိုင်ကို စီမံခန့်ခွဲသည့် tools များကို တည်ဆောက်နိုင်သည်။ Workflow တစ်ခုကို မေးပါ၊ မိနစ် ၃၀ အတွင်း CLI တစ်ခုနှင့် pipeline များကို call တစ်ခါတည်းဖြင့် လည်ပတ်နိုင်လာမည်။ Lobster သည် ပျောက်ဆုံးနေသော အစိတ်အပိုင်းဖြစ်သည် — deterministic pipelines, ပြတ်သားသော approvals နှင့် resume လုပ်နိုင်သော state များ။

ဘာကြောင့်လဲ

ယနေ့တွင် ရှုပ်ထွေးသော workflows များသည် tool calls အပြန်အလှန် အများအပြား လိုအပ်သည်။ Call တစ်ခါချင်းစီသည် tokens ကုန်ကျပြီး LLM သည် အဆင့်တိုင်းကို စီမံညှိနှိုင်းရသည်။ Lobster သည် ထို orchestration ကို typed runtime ထဲသို့ ရွှေ့ပေးသည် —

  • တစ်ခေါက်ခေါ်ဆိုခြင်းသာ: OpenClaw သည် Lobster tool ကို တစ်ခါတည်း ခေါ်ပြီး ဖွဲ့စည်းထားသော ရလဒ်ကို ရယူသည်။
  • အတည်ပြုချက်များ ပါဝင်ပြီးသား: အကျိုးသက်ရောက်မှုရှိသော လုပ်ဆောင်ချက်များ (အီးမေးလ်ပို့ခြင်း၊ မှတ်ချက်တင်ခြင်း) သည် ထင်ရှားစွာ အတည်ပြုမချင်း workflow ကို ရပ်တန့်ထားသည်။
  • ပြန်လည်စတင်နိုင်မှု: ရပ်တန့်ထားသော workflow များသည် token တစ်ခုကို ပြန်ပေးပြီး အတည်ပြုပြီးနောက် အရာအားလုံးကို ပြန်မလုပ်ဘဲ ဆက်လက်လုပ်ဆောင်နိုင်သည်။

ရိုးရိုးပရိုဂရမ်များအစား DSL ကို ဘာကြောင့် အသုံးပြုသင့်သလဲ?

Lobster ကို ရည်ရွယ်ချက်ရှိရှိ သေးငယ်စွာ ဒီဇိုင်းလုပ်ထားသည်။ ရည်မှန်းချက်မှာ "ဘာသာစကားအသစ်" မဟုတ်ဘဲ first-class approvals နှင့် resume tokens ပါဝင်သော ခန့်မှန်းနိုင်ပြီး AI-friendly pipeline spec တစ်ခု ဖြစ်သည်။

  • Approve/resume ကို မူလက ပါဝင်: ပုံမှန် program တစ်ခုသည် လူကို မေးနိုင်သော်လည်း ကိုယ်တိုင် runtime မတီထွင်ဘဲ အကြမ်းခံ token ဖြင့် ရပ်ပြီး ပြန်လည်စတင် မလုပ်နိုင်ပါ။
  • Determinism + auditability: Pipelines များသည် data ဖြစ်သောကြောင့် log ပြုလုပ်ရန်၊ diff ကြည့်ရန်၊ ပြန်ကစားရန်၊ စစ်ဆေးရန် လွယ်ကူသည်။
  • AI အတွက် ကန့်သတ်ထားသော မျက်နှာပြင်: grammar သေးငယ်ခြင်း + JSON piping သည် “ဖန်တီးမှုလမ်းကြောင်းများ” ကို လျှော့ချပြီး စစ်ဆေးခြင်းကို လက်တွေ့ကျစေသည်။
  • လုံခြုံရေးမူဝါဒကို မူလက ထည့်သွင်းထားခြင်း: timeout များ၊ output ကန့်သတ်ချက်များ၊ sandbox စစ်ဆေးမှုများ၊ allowlist များကို script တစ်ခုချင်းစီမဟုတ်ဘဲ runtime က အတည်ပြုအကောင်အထည်ဖော်သည်။
  • ဆက်လက် programmable ဖြစ်နေဆဲ: အဆင့်တိုင်းသည် CLI သို့မဟုတ် script မည်သည့်အရာမဆို ခေါ်နိုင်သည်။ JS/TS ကို လိုချင်ပါက code မှ .lobster ဖိုင်များကို generate လုပ်ပါ။

လုပ်ဆောင်ပုံ

OpenClaw သည် local lobster CLI ကို tool mode ဖြင့် စတင်ကာ stdout မှ JSON envelope ကို parse လုပ်သည်။ Pipeline သည် approval အတွက် ရပ်နားပါက tool သည် နောက်မှ ဆက်လက်လုပ်နိုင်ရန် resumeToken ကို ပြန်ပေးသည်။

ပုံစံ: အသေးစား CLI + JSON pipes + အတည်ပြုမှုများ

JSON ကို ပြောနိုင်သော အမိန့်သေးသေးများကို တည်ဆောက်ပြီး၊ ထိုများကို Lobster call တစ်ခုတည်းအဖြစ် ချိတ်ဆက်ပါ။ (အောက်ပါသည် ဥပမာ command အမည်များသာ — သင့်ကိုယ်ပိုင်အမည်များဖြင့် အစားထိုးပါ။)

inbox list --json
inbox categorize --json
inbox 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
}

pipeline သည် အတည်ပြုချက်ကို တောင်းဆိုပါက token ဖြင့် ပြန်လည်စတင်ပါ။

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

AI သည် workflow ကို trigger လုပ်ပြီး Lobster သည် အဆင့်များကို အကောင်အထည်ဖော်ဆောင်ရွက်သည်။ Approval gates များသည် side effects များကို ပြတ်သားစွာ ဖော်ပြနိုင်ပြီး စစ်ဆေးနိုင်စေသည်။

ဥပမာ- input item များကို tool call များအဖြစ် map လုပ်ခြင်း။

gog.gmail.search --query 'newer_than:1d' \
  | openclaw.invoke --tool message --action send --each --item-key message --args-json '{"provider":"telegram","to":"..."}'

JSON သီးသန့် LLM အဆင့်များ (llm-task)

Structured LLM step လိုအပ်သော workflows များအတွက် optional llm-task plugin tool ကို enable လုပ်ပြီး Lobster မှ ခေါ်ပါ။ ၎င်းသည် workflow ကို deterministic ဖြစ်အောင် ထိန်းထားသော်လည်း model ဖြင့် classify/summarize/draft လုပ်နိုင်စေသည်။

tool ကို ဖွင့်ရန်-

{
  "plugins": {
    "entries": {
      "llm-task": { "enabled": true }
    }
  },
  "agents": {
    "list": [
      {
        "id": "main",
        "tools": { "allow": ["llm-task"] }
      }
    ]
  }
}

pipeline တွင် အသုံးပြုရန်-

openclaw.invoke --tool llm-task --action json --args-json '{
  "prompt": "Given the input email, return intent and draft.",
  "input": { "subject": "Hello", "body": "Can you help?" },
  "schema": {
    "type": "object",
    "properties": {
      "intent": { "type": "string" },
      "draft": { "type": "string" }
    },
    "required": ["intent", "draft"],
    "additionalProperties": false
  }
}'

အသေးစိတ်နှင့် configuration ရွေးချယ်စရာများအတွက် LLM Task ကို ကြည့်ပါ။

လုပ်ငန်းစဉ် ဖိုင်များ (.lobster)

Lobster သည် name, args, steps, env, condition, approval fields များပါသော YAML/JSON workflow ဖိုင်များကို run လုပ်နိုင်သည်။ OpenClaw tool calls တွင် pipeline ကို ဖိုင်လမ်းကြောင်းအဖြစ် သတ်မှတ်ပါ။

name: inbox-triage
args:
  tag:
    default: "family"
steps:
  - id: collect
    command: inbox list --json
  - id: categorize
    command: inbox categorize --json
    stdin: $collect.stdout
  - id: approve
    command: inbox apply --approve
    stdin: $categorize.stdout
    approval: required
  - id: execute
    command: inbox apply --execute
    stdin: $categorize.stdout
    condition: $approve.approved

မှတ်ချက်များ-

  • stdin: $step.stdout နှင့် stdin: $step.json သည် အရင်အဆင့်၏ output ကို ပို့ပေးသည်။
  • condition (သို့မဟုတ် when) သည် $step.approved အပေါ် မူတည်၍ အဆင့်များကို gate လုပ်နိုင်သည်။

Lobster ကို ထည့်သွင်းရန်

OpenClaw Gateway ကို run လုပ်သည့် host တစ်ခုတည်း ပေါ်တွင် Lobster CLI ကို install လုပ်ပြီး (lobster သည် PATH ထဲတွင် ရှိရမည်) — Lobster repo ကို ကြည့်ပါ။ Custom binary location ကို အသုံးပြုလိုပါက tool call ထဲတွင် absolute lobsterPath ကို ပေးပါ။

Enable the tool

Lobster သည် optional plugin tool ဖြစ်ပြီး မူလအတိုင်း မဖွင့်ထားပါ။

အကြံပြုထားသော နည်းလမ်း (additive, safe) -

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

သို့မဟုတ် per-agent -

{
  "agents": {
    "list": [
      {
        "id": "main",
        "tools": {
          "alsoAllow": ["lobster"]
        }
      }
    ]
  }
}

restrictive allowlist mode ဖြင့် လည်ပတ်ရန် ရည်ရွယ်ထားခြင်း မရှိပါက tools.allow: ["lobster"] ကို မသုံးရန် ရှောင်ပါ။

မှတ်ချက်: optional plugins များအတွက် allowlists သည် opt-in ဖြစ်သည်။ သင့် allowlist တွင် plugin tools (ဥပမာ lobster) သာ အမည်ပေးထားပါက OpenClaw သည် core tools များကို ဆက်လက် enable ထားမည် ဖြစ်သည်။ Core tools များကို ကန့်သတ်လိုပါက allowlist ထဲတွင် သင်လိုချင်သော core tools သို့မဟုတ် groups များကိုပါ ထည့်သွင်းပါ။

Example: Email triage

Lobster မပါဘဲ-

User: "Check my email and draft replies"
→ openclaw calls gmail.list
→ LLM summarizes
→ User: "draft replies to #2 and #5"
→ LLM drafts
→ User: "send #2"
→ openclaw calls gmail.send
(repeat daily, no memory of what was triaged)

Lobster နှင့်အတူ-

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

JSON envelope ကို ပြန်ပေးသည် (အတိုချုံး)-

{
  "ok": true,
  "status": "needs_approval",
  "output": [{ "summary": "5 need replies, 2 need action" }],
  "requiresApproval": {
    "type": "approval_request",
    "prompt": "Send 2 draft replies?",
    "items": [],
    "resumeToken": "..."
  }
}

User အတည်ပြု → ပြန်လည်စတင်-

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

Workflow တစ်ခု။ Deterministic။ လုံခြုံ။

Tool parameters

run

tool mode ဖြင့် pipeline ကို လည်ပတ်စေသည်။

{
  "action": "run",
  "pipeline": "gog.gmail.search --query 'newer_than:1d' | email.triage",
  "cwd": "/path/to/workspace",
  "timeoutMs": 30000,
  "maxStdoutBytes": 512000
}

args များဖြင့် workflow ဖိုင်ကို လည်ပတ်စေသည်-

{
  "action": "run",
  "pipeline": "/path/to/inbox-triage.lobster",
  "argsJson": "{\"tag\":\"family\"}"
}

resume

အတည်ပြုပြီးနောက် ရပ်တန့်ထားသော workflow ကို ဆက်လက်လုပ်ဆောင်သည်။

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

Optional inputs

  • lobsterPath: Lobster binary ၏ absolute path (မပေးပါက PATH ကို အသုံးပြုသည်)။
  • cwd: pipeline အတွက် working directory (မူလမှာ လက်ရှိ process working directory)။
  • timeoutMs: သတ်မှတ်ထားသော အချိန်ကို ကျော်လွန်ပါက subprocess ကို သတ်ပစ်သည် (default: 20000)။
  • maxStdoutBytes: stdout အရွယ်အစားသည် ဤအရွယ်အစားကို ကျော်လွန်ပါက subprocess ကို သတ်ပစ်သည် (default: 512000)။
  • argsJson: lobster run --args-json သို့ ပေးပို့သော JSON string (workflow ဖိုင်များအတွက်သာ)။

Output envelope

Lobster သည် အခြေအနေ သုံးမျိုးအနက် တစ်ခုဖြင့် JSON envelope ကို ပြန်ပေးသည်-

  • ok → အောင်မြင်စွာ ပြီးဆုံး
  • needs_approval → ရပ်တန့်ထားသည်; ပြန်လည်စတင်ရန် requiresApproval.resumeToken လိုအပ်သည်
  • cancelled → ထင်ရှားစွာ ငြင်းပယ် သို့မဟုတ် ဖျက်သိမ်းထားသည်

tool သည် envelope ကို content (pretty JSON) နှင့် details (raw object) နှစ်မျိုးစလုံးဖြင့် ပြသပေးသည်။

Approvals

requiresApproval ရှိပါက prompt ကို စစ်ဆေးပြီး ဆုံးဖြတ်ပါ-

  • approve: true → ဆက်လက်လုပ်ဆောင်ပြီး အကျိုးသက်ရောက်မှုများကို ဆောင်ရွက်ရန်
  • approve: false → ဖျက်သိမ်းပြီး workflow ကို အပြီးသတ်ရန်
  1. custom jq/heredoc glue မလိုအပ်ဘဲ approval requests တွင် JSON preview ကိုတွဲရန် approve --preview-from-stdin --limit N ကို အသုံးပြုပါ။ 2. Resume tokens များကို ယခုအခါ သေးငယ်အောင် ပြုလုပ်ထားသည်: Lobster သည် workflow resume state ကို ၎င်း၏ state dir အောက်တွင် သိမ်းဆည်းပြီး token key အသေးတစ်ခုကို ပြန်ပေးသည်။

OpenProse

  1. OpenProse သည် Lobster နှင့် ကောင်းစွာ တွဲဖက်အသုံးပြုနိုင်သည်: multi-agent prep ကို စီမံရန် /prose ကို အသုံးပြုပြီးနောက် deterministic approvals အတွက် Lobster pipeline ကို chạy ပါ။ 4. Prose program တစ်ခုအတွက် Lobster လိုအပ်ပါက sub-agents များအတွက် tools.subagents.tools မှတဆင့် lobster tool ကို ခွင့်ပြုပါ။ 5. OpenProse ကို ကြည့်ပါ။

Safety

  • Local subprocess only — plugin ကိုယ်တိုင်မှ network call များ မလုပ်ပါ။
  • No secrets — Lobster သည် OAuth ကို မစီမံပါ; OpenClaw tools များကိုသာ ခေါ်ပါသည်။
  • Sandbox-aware — tool context သည် sandboxed ဖြစ်ပါက ပိတ်ထားပါသည်။
  • Hardened — သတ်မှတ်ပါက lobsterPath သည် absolute ဖြစ်ရမည်; timeout နှင့် output cap များကို အတည်ပြုအကောင်အထည်ဖော်ထားသည်။

Troubleshooting

  • lobster subprocess timed out → timeoutMs ကို တိုးမြှင့်ပါ၊ သို့မဟုတ် pipeline ရှည်လျားမှုကို ခွဲပါ။
  • lobster output exceeded maxStdoutBytes → maxStdoutBytes ကို မြှင့်ပါ သို့မဟုတ် output အရွယ်အစားကို လျှော့ချပါ။
  • lobster returned invalid JSON → pipeline ကို tool mode ဖြင့် လည်ပတ်ပြီး JSON သာ ထုတ်ပေးကြောင်း သေချာပါစေ။
  • lobster failed (code …) → stderr ကို စစ်ဆေးရန် terminal တွင် တူညီသော pipeline ကို လည်ပတ်ပါ။

Learn more

Case study: community workflows

  1. Public example တစ်ခု: Markdown vault သုံးခု (personal, partner, shared) ကို စီမံခန့်ခွဲသော “second brain” CLI + Lobster pipelines။ 7. CLI သည် stats, inbox listings နှင့် stale scans အတွက် JSON ကို ထုတ်ပေးပြီး Lobster သည် ထို command များကို weekly-review, inbox-triage, memory-consolidation, နှင့် shared-task-sync ကဲ့သို့ approval gates ပါသော workflows များအဖြစ် ချိတ်ဆက်အသုံးပြုသည်။ 8. AI ရရှိနိုင်ပါက judgment (categorization) ကို ကိုင်တွယ်ပြီး မရရှိပါက deterministic rules များသို့ ပြန်လည်အသုံးပြုသည်။
veiseule.ai — Community translations maintained by John Kelly. Improve translations on Crowdin.