​

Lobster

​

Ilgak

​

Nega

• Ko‘p chaqiruvlar o‘rniga bitta: OpenClaw bitta Lobster asbob chaqiruvini bajaradi va tuzilgan natijani oladi.
• Tasdiqlar ichiga qurilgan: Yon ta’sirlar (email yuborish, izoh joylash) aniq tasdiqlanmaguncha ish jarayonini to‘xtatadi.
• Qayta tiklanadigan: To‘xtatilgan ish jarayonlari token qaytaradi; tasdiqlang va hammasini qayta ishga tushirmasdan davom eting.

​

Nega oddiy dasturlar o‘rniga DSL?

• Tasdiqlash/davom ettirish ichiga qurilgan: Oddiy dastur odamdan so‘rashi mumkin, ammo siz o‘zingiz alohida runtime ixtiro qilmasdan mustahkam token bilan to‘xtab davom eta olmaydi.
• Deterministiklik + auditlanish: Quvurlar ma’lumotdir, shuning uchun ularni yozib olish, farqlash, qayta ijro etish va ko‘rib chiqish oson.
• AI uchun cheklangan sirt: Kichik grammatika + JSON quvurlash “ijodiy” kod yo‘llarini kamaytiradi va tekshiruvni real qiladi.
• Xavfsizlik siyosati ichiga singdirilgan: Timeoutlar, chiqish cheklovlari, sandbox tekshiruvlari va allowlistlar har bir skript emas, balki runtime tomonidan majburlanadi.
• Hali ham dasturlanadigan: Har bir qadam istalgan CLI yoki skriptni chaqirishi mumkin. Agar JS/TS xohlasangiz, .lobster fayllarini koddan yarating.

​

Qanday ishlaydi

​

1. Naqsh: kichik CLI + JSON quvurlari + tasdiqlashlar

2. JSON bilan gaplashadigan juda kichik buyruqlarni yarating, so‘ng ularni bitta Lobster chaqiruviga zanjirlab ulang. 3. (Quyida buyruq nomlariga misollar — o‘zingiznikiga almashtiring.)

4. inbox list --json
inbox categorize --json
inbox apply --json

5. {
  "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
}

6. Agar quvur tasdiqlashni so‘rasa, token bilan davom ettiring:

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

8. AI ish jarayonini ishga tushiradi; Lobster bosqichlarni bajaradi. 9. Tasdiqlash darvozalari yon ta’sirlarni aniq va audit qilinadigan holatda saqlaydi.
9. Misol: kirish elementlarini asbob chaqiruvlariga moslash:

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

​

12. Faqat JSON bo‘lgan LLM bosqichlari (llm-task)

13. Tuzilgan LLM bosqichi kerak bo‘lgan ish jarayonlari uchun ixtiyoriy llm-task plagin asbobini yoqing va uni Lobster’dan chaqiring. 14. Bu ish jarayonini deterministik holatda saqlaydi, shu bilan birga model yordamida tasniflash/xulosa qilish/qoralama yozishga imkon beradi.
14. Vositanı yoqing:

18. 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
  }
}'

17. Uni quvurda ishlating:

18. 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
  }
}'

49. Tafsilotlar va sozlash variantlari uchun LLM Task ga qarang.

​

50. Workflow fayllari (.lobster)

21. Lobster name, args, steps, env, condition va approval maydonlariga ega YAML/JSON ish jarayoni fayllarini ishga tushira oladi. 22. OpenClaw asbob chaqiruvlarida pipeline ni fayl yo‘liga o‘rnating.

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

24. Eslatmalar:

• OpenClaw Gateway ishlaydigan xuddi shu xostga Lobster CLI’ni o‘rnating (Lobster repozitoriyasiga qarang) va lobster PATHda ekanini ta’minlang.
• Agar maxsus binar joylashuvdan foydalanmoqchi bo‘lsangiz, asbob chaqiruvida mutlaq lobsterPath ni bering.

​

27. Lobster’ni o‘rnating

28. OpenClaw Gateway ishlaydigan xuddi shu xostga Lobster CLI’ni o‘rnating (Lobster repozitoriyasiga qarang) va lobster PATHda ekanini ta’minlang.
29. Agar maxsus binar joylashuvdan foydalanmoqchi bo‘lsangiz, asbob chaqiruvida mutlaq lobsterPath ni bering.

​

30. Asbobni yoqing

31. Lobster — ixtiyoriy plagin asbob (sukut bo‘yicha yoqilmagan).
32. Tavsiya etiladi (qo‘shimcha, xavfsiz):

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

34. Yoki agent bo‘yicha:

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

36. Cheklovchi allowlist rejimida ishlashni ko‘zlamagan bo‘lsangiz, tools.allow: ["lobster"] dan foydalanishdan saqlaning.
37. Eslatma: allowlistlar ixtiyoriy plaginlar uchun opt-in hisoblanadi. 38. Agar allowlistingiz faqat lobster kabi plagin asboblarini nomlasa, OpenClaw asosiy asboblarni yoqilgan holda qoldiradi. 39. Asosiy asboblarni cheklash uchun allowlistga xohlagan asosiy asboblar yoki guruhlarni ham kiriting.

​

40. Misol: Email saralash

41. Lobster’siz:

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

43. Lobster bilan:

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

45. JSON konvertini qaytaradi (qisqartirilgan):

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

47. Foydalanuvchi tasdiqlaydi → davom ettirish:

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

49. Bitta ish jarayoni. 50. Deterministik. 1. Xavfsiz.

​

2. Asbob parametrlari

​

3. run

4. Asbob rejimida pipeline-ni ishga tushiring.

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

6. Argumentlar bilan workflow faylini ishga tushiring:

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

​

8. resume

9. Tasdiqlangandan so‘ng to‘xtatilgan workflow-ni davom ettiring.

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

​

11. Ixtiyoriy kirishlar

• Asbob konvertni ham content (chiroyli JSON), ham details (xom obyekt) da ko‘rsatadi.
• 13. cwd: Pipeline uchun ishchi katalog (standart bo‘yicha joriy jarayonning ishchi katalogi).
• 14. timeoutMs: Agar subprocess bu davomiylikdan oshsa, uni to‘xtatadi (standart: 20000).
• 15. maxStdoutBytes: Agar stdout bu hajmdan oshsa, subprocess-ni to‘xtatadi (standart: 512000).
• 16. argsJson: lobster run --args-json ga uzatiladigan JSON satri (faqat workflow fayllari uchun).

​

17. Chiqish konverti

18. Lobster uchta holatdan biri bilan JSON konvertini qaytaradi:

• 19. ok → muvaffaqiyatli yakunlandi
• 20. needs_approval → pauza qilingan; davom ettirish uchun requiresApproval.resumeToken talab qilinadi
• 21. cancelled → ochiqchasiga rad etilgan yoki bekor qilingan

22. Asbob konvertni ham content (chiroyli JSON), ham details (xom obyekt) da ko‘rsatadi.

​

23. Tasdiqlar

24. Agar requiresApproval mavjud bo‘lsa, so‘rovni ko‘rib chiqing va qaror qabul qiling:

• 25. approve: true → davom ettiring va yon ta’sirlarni davom ettiring
• 26. approve: false → bekor qiling va workflow-ni yakunlang

27. Maxsus jq/heredoc bog‘lovchisiz tasdiq so‘rovlariga JSON ko‘rinishini biriktirish uchun approve --preview-from-stdin --limit N dan foydalaning. 28. Resume tokenlari endi ixcham: Lobster workflow-ni davom ettirish holatini o‘zining state katalogida saqlaydi va kichik token kalitini qaytaradi.

​

29. OpenProse

30. OpenProse Lobster bilan yaxshi ishlaydi: ko‘p-agentli tayyorgarlikni boshqarish uchun /prose dan foydalaning, so‘ng deterministik tasdiqlar uchun Lobster pipeline-ni ishga tushiring. 31. Agar Prose dasturiga Lobster kerak bo‘lsa, sub-agentlar uchun tools.subagents.tools orqali lobster asbobiga ruxsat bering. 32. OpenProse ni ko‘ring.

​

33. Xavfsizlik

• 34. Faqat mahalliy subprocess — plagin o‘zi tarmoq chaqiruvlarini qilmaydi.
• 35. Maxfiy ma’lumotlar yo‘q — Lobster OAuth-ni boshqarmaydi; u buni qiladigan OpenClaw asboblarini chaqiradi.
• 36. Sandbox-ga mos — asbob konteksti sandbox qilingan bo‘lsa, o‘chiriladi.
• 37. Mustahkamlangan — agar ko‘rsatilsa, lobsterPath mutlaq bo‘lishi shart; timeout va chiqish cheklovlari majburiy.

​

38. Muammolarni bartaraf etish

• 39. lobster subprocess timed out → timeoutMs ni oshiring yoki uzun pipeline-ni bo‘ling.
• 40. lobster output exceeded maxStdoutBytes → maxStdoutBytes ni oshiring yoki chiqish hajmini kamaytiring.
• 41. lobster returned invalid JSON → pipeline asbob rejimida ishlashini va faqat JSON chop etishini ta’minlang.
• 42. lobster failed (code …) → stderr-ni ko‘rish uchun xuddi shu pipeline-ni terminalda ishga tushiring.

​

43. Batafsil ma’lumot

• Plugins
• Plugin tool authoring

​

46. Amaliy tadqiqot: hamjamiyat workflow-lari

47. Bitta ommaviy misol: uchta Markdown omborini (shaxsiy, hamkor, umumiy) boshqaradigan “ikkinchi miya” CLI + Lobster pipeline-lari. 48. CLI statistika, inbox ro‘yxatlari va eskirganlarni skanerlash uchun JSON chiqaradi; Lobster esa bu buyruqlarni weekly-review, inbox-triage, memory-consolidation va shared-task-sync kabi, har biri tasdiqlash darvozalari bilan workflow-larga zanjirlaydi. 49. AI mavjud bo‘lganda hukm chiqarishni (toifalashni) bajaradi va mavjud bo‘lmaganda deterministik qoidalarga tayanadi.

• 50. Mavzu: https://x.com/plattenschieber/status/2014508656335770033
• Repo: https://github.com/bloomedai/brain-cli