กุ้งมังกร

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Hook

​

เหตุผล

• เรียกครั้งเดียวแทนหลายครั้ง: OpenClaw เรียกเครื่องมือ Lobster หนึ่งครั้งและได้ผลลัพธ์แบบมีโครงสร้าง
• มีการอนุมัติในตัว: ผลข้างเคียง (ส่งอีเมล โพสต์ความคิดเห็น) จะหยุดเวิร์กโฟลว์จนกว่าจะได้รับการอนุมัติอย่างชัดเจน
• กลับมาทำต่อได้: เวิร์กโฟลว์ที่หยุดไว้จะส่งคืนโทเค็น อนุมัติแล้วทำต่อได้โดยไม่ต้องเรียกซ้ำทุกอย่าง

​

ทำไมต้องใช้ DSL แทนโปรแกรมทั่วไป?

• อนุมัติ/กลับมาทำต่อมีในตัว: โปรแกรมปกติสามารถขอให้มนุษย์ยืนยันได้ แต่ไม่สามารถ หยุดชั่วคราวแล้วกลับมาทำต่อ ด้วยโทเค็นที่คงทนได้ เว้นแต่คุณจะสร้างรันไทม์นั้นเอง
• ความกำหนดผลลัพธ์ได้แน่นอน + ตรวจสอบย้อนหลังได้: ไปป์ไลน์เป็นข้อมูล จึงบันทึก เปรียบเทียบ เล่นซ้ำ และตรวจทานได้ง่าย
• พื้นผิวที่จำกัดสำหรับ AI: ไวยากรณ์ขนาดเล็ก + การส่งต่อ JSON ลดเส้นทางโค้ดแบบ “สร้างสรรค์” และทำให้การตรวจสอบความถูกต้องทำได้จริง
• นโยบายความปลอดภัยฝังอยู่ในตัว: การหมดเวลา ขีดจำกัดเอาต์พุต การตรวจสอบแซนด์บ็อกซ์ และ allowlist ถูกบังคับใช้โดยรันไทม์ ไม่ใช่สคริปต์แต่ละตัว
• ยังเขียนโปรแกรมได้: แต่ละขั้นตอนสามารถเรียก CLI หรือสคริปต์ใดก็ได้ หากต้องการ JS/TS ให้สร้างไฟล์ .lobster จากโค้ด

​

วิธีทำงาน

​

รูปแบบ: CLI ขนาดเล็ก + JSON pipe + การอนุมัติ

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
}

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

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

​

ขั้นตอน LLM แบบ JSON เท่านั้น (llm-task)

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

​

ข้อจำกัดสำคัญ: Lobster แบบฝังเทียบกับ openclaw.invoke

openclaw.invoke --tool llm-task --action json --args-json '{ ... }'

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 โดยตรงนอก Lobster หรือ
• ใช้ขั้นตอนที่ไม่ใช่ openclaw.invoke ภายในไปป์ไลน์ Lobster จนกว่าจะเพิ่มบริดจ์แบบฝังที่รองรับ

​

ไฟล์เวิร์กโฟลว์ (.lobster)

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 ส่งเอาต์พุตของขั้นตอนก่อนหน้า
• condition (หรือ when) สามารถใช้เป็นเกตขั้นตอนตาม $step.approved

​

ติดตั้ง Lobster

​

เปิดใช้เครื่องมือ

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

{
  "agents": {
    "list": [
      {
        "id": "main",
        "tools": {
          "alsoAllow": ["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)

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

{
  "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: ไดเรกทอรีทำงานแบบสัมพัทธ์สำหรับไปป์ไลน์ (ต้องอยู่ภายในไดเรกทอรีทำงานของ Gateway)
• timeoutMs: ยกเลิกเวิร์กโฟลว์หากเกินระยะเวลานี้ (ค่าเริ่มต้น: 20000)
• maxStdoutBytes: ยกเลิกเวิร์กโฟลว์หากเอาต์พุตเกินขนาดนี้ (ค่าเริ่มต้น: 512000)
• argsJson: สตริง JSON ที่ส่งให้ lobster run --args-json (เฉพาะไฟล์เวิร์กโฟลว์)

​

ซองเอาต์พุต

• ok → เสร็จสิ้นสำเร็จ
• needs_approval → หยุดชั่วคราว; ต้องใช้ requiresApproval.resumeToken เพื่อกลับมาทำต่อ
• cancelled → ถูกปฏิเสธหรือยกเลิกอย่างชัดเจน

​

การอนุมัติ

• approve: true → กลับมาทำต่อและดำเนินผลข้างเคียงต่อไป
• approve: false → ยกเลิกและจบเวิร์กโฟลว์

​

OpenProse

​

ความปลอดภัย

• เฉพาะในโปรเซสเดียวกันแบบโลคัล - เวิร์กโฟลว์ทำงานภายในโปรเซส Gateway; ไม่มีการเรียกเครือข่ายจากตัว Plugin เอง
• ไม่มีความลับ - Lobster ไม่จัดการ OAuth; มันเรียกเครื่องมือ OpenClaw ที่จัดการเรื่องนั้น
• รับรู้แซนด์บ็อกซ์ - ปิดใช้งานเมื่อบริบทเครื่องมืออยู่ในแซนด์บ็อกซ์
• เสริมความแข็งแรงแล้ว - ตัวรันแบบฝังบังคับใช้การหมดเวลาและขีดจำกัดเอาต์พุต

​

การแก้ไขปัญหา

• lobster timed out → เพิ่ม timeoutMs หรือแยกไปป์ไลน์ยาวออกเป็นส่วนๆ
• lobster output exceeded maxStdoutBytes → เพิ่ม maxStdoutBytes หรือลดขนาดเอาต์พุต
• lobster returned invalid JSON → ตรวจสอบให้แน่ใจว่าไปป์ไลน์ทำงานในโหมดเครื่องมือและพิมพ์เฉพาะ JSON
• lobster failed → ตรวจสอบล็อก Gateway สำหรับรายละเอียดข้อผิดพลาดของตัวรันแบบฝัง

​

เรียนรู้เพิ่มเติม

• Plugins
• การเขียนเครื่องมือ Plugin

​

กรณีศึกษา: เวิร์กโฟลว์ชุมชน

• เธรด: https://x.com/plattenschieber/status/2014508656335770033
• รีโป: https://github.com/bloomedai/brain-cli

​

ที่เกี่ยวข้อง

• Automation - การตั้งเวลาเวิร์กโฟลว์ Lobster
• ภาพรวม Automation - กลไกอัตโนมัติทั้งหมด
• ภาพรวมเครื่องมือ - เครื่องมือเอเจนต์ทั้งหมดที่พร้อมใช้งาน