Tools
งานของ LLM
llm-task เป็น เครื่องมือ Plugin แบบไม่บังคับ ที่รันงาน LLM แบบเฉพาะ JSON และ
ส่งคืนเอาต์พุตแบบมีโครงสร้าง (เลือกตรวจสอบความถูกต้องกับ JSON Schema ได้)
เหมาะสำหรับเอนจินเวิร์กโฟลว์อย่าง Lobster: คุณสามารถเพิ่มขั้นตอน LLM เพียงขั้นตอนเดียว โดยไม่ต้องเขียนโค้ด OpenClaw แบบกำหนดเองสำหรับแต่ละเวิร์กโฟลว์
เปิดใช้ Plugin
- เปิดใช้ Plugin:
{ "plugins": { "entries": { "llm-task": { "enabled": true } } }}- อนุญาตเครื่องมือแบบไม่บังคับ:
{ "tools": { "alsoAllow": ["llm-task"] }}ใช้ tools.allow เฉพาะเมื่อคุณต้องการโหมดรายการอนุญาตแบบจำกัด
การกำหนดค่า (ไม่บังคับ)
{ "plugins": { "entries": { "llm-task": { "enabled": true, "config": { "defaultProvider": "openai", "defaultModel": "gpt-5.5", "defaultAuthProfileId": "main", "allowedModels": ["openai/gpt-5.5"], "maxTokens": 800, "timeoutMs": 30000 } } } }}allowedModels คือรายการอนุญาตของสตริง provider/model หากตั้งค่าไว้ คำขอใดก็ตาม
ที่อยู่นอกรายการจะถูกปฏิเสธ
พารามิเตอร์ของเครื่องมือ
prompt(สตริง, จำเป็น)input(ใด ๆ, ไม่บังคับ)schema(อ็อบเจกต์, JSON Schema ไม่บังคับ)provider(สตริง, ไม่บังคับ)model(สตริง, ไม่บังคับ)thinking(สตริง, ไม่บังคับ)authProfileId(สตริง, ไม่บังคับ)temperature(ตัวเลข, ไม่บังคับ)maxTokens(ตัวเลข, ไม่บังคับ)timeoutMs(ตัวเลข, ไม่บังคับ)
thinking รับพรีเซ็ตการให้เหตุผลมาตรฐานของ OpenClaw เช่น low หรือ medium
เอาต์พุต
ส่งคืน details.json ที่มี JSON ที่แยกวิเคราะห์แล้ว (และตรวจสอบความถูกต้องกับ
schema เมื่อระบุไว้)
ตัวอย่าง: ขั้นตอนเวิร์กโฟลว์ Lobster
ข้อจำกัดสำคัญ
ตัวอย่างด้านล่างถือว่า Lobster CLI แบบสแตนด์อโลน กำลังรันอยู่ในสภาพแวดล้อมที่ openclaw.invoke มี URL ของ Gateway และบริบทการยืนยันตัวตนที่ถูกต้องอยู่แล้ว
สำหรับตัวรัน Lobster แบบ ฝังในตัว ที่มาพร้อม OpenClaw รูปแบบ CLI ซ้อนนี้ ยังไม่น่าเชื่อถือในปัจจุบัน:
openclaw.invoke --tool llm-task --action json --args-json '{ ... }'จนกว่า Lobster แบบฝังในตัวจะมีบริดจ์ที่รองรับสำหรับโฟลว์นี้ ให้เลือกใช้อย่างใดอย่างหนึ่งต่อไปนี้:
- เรียกเครื่องมือ
llm-taskโดยตรงนอก Lobster หรือ - ขั้นตอน Lobster ที่ไม่พึ่งพาการเรียก
openclaw.invokeแบบซ้อน
ตัวอย่าง Lobster CLI แบบสแตนด์อโลน:
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 }}'หมายเหตุด้านความปลอดภัย
- เครื่องมือนี้เป็นแบบ เฉพาะ JSON และสั่งให้โมเดลส่งออกเฉพาะ JSON (ไม่มี code fences ไม่มีคำอธิบายประกอบ)
- ไม่มีเครื่องมือใดถูกเปิดเผยให้โมเดลใช้สำหรับการรันนี้
- ถือว่าเอาต์พุตไม่น่าเชื่อถือ เว้นแต่คุณจะตรวจสอบความถูกต้องด้วย
schema - ใส่การอนุมัติก่อนขั้นตอนใด ๆ ที่มีผลข้างเคียง (ส่ง โพสต์ exec)