OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

LLM 任務

llm-task 是內建的選用外掛工具，可執行單次僅限 JSON 的 LLM 呼叫並傳回結構化輸出，也可選擇使用 JSON Schema 驗證。它讓 Lobster 等工作流程引擎能加入 LLM 步驟，而無須為每個工作流程撰寫自訂 OpenClaw 程式碼。

啟用

  1. 啟用此外掛：
json
{  "plugins": {    "entries": {      "llm-task": { "enabled": true }    }  }}
  1. 允許使用此工具：
json
{  "tools": {    "alsoAllow": ["llm-task"]  }}

alsoAllow 會在目前使用中的工具設定檔之上加入 llm-task，而不會 限制其他核心工具。只有在想使用限制性 允許清單模式時，才改用 tools.allow。

設定（選用）

json
{  "plugins": {    "entries": {      "llm-task": {        "enabled": true,        "config": {          "defaultProvider": "openai",          "defaultModel": "gpt-5.6-sol",          "defaultAuthProfileId": "main",          "allowedModels": ["openai/gpt-5.6-sol"],          "maxTokens": 800,          "timeoutMs": 30000        }      }    }  }}

allowedModels 是由 provider/model 字串組成的允許清單；任何要求使用 其他模型的請求都會遭到拒絕。其餘所有鍵都是每次呼叫的備用值，會在 工具呼叫省略對應參數時使用。

工具參數

參數 類型 說明
prompt string 必填。提供給 LLM 的任務指示。
input any 選填的承載資料；會序列化為 JSON 並附加至提示詞。
schema object 選填的 JSON Schema；剖析後的輸出必須通過其驗證。
provider string 覆寫 defaultProvider／代理程式的預設供應商。
model string 覆寫 defaultModel；接受不含供應商的模型 ID、別名或 provider/model 參照（重複的供應商前綴會自動移除）。
thinking string 推理層級（例如 low、medium）；必須是解析後的模型所支援的層級。
authProfileId string 覆寫 defaultAuthProfileId。
temperature number 盡力套用；並非所有供應商都會採用此值。
maxTokens number 輸出權杖數的盡力上限。
timeoutMs number 執行逾時時間；預設為 30000。

輸出

傳回 details.json（經剖析及 Schema 驗證的 JSON），並透過 details.provider 與 details.model 指明實際執行時使用的供應商及模型。

範例：Lobster 工作流程步驟

重要限制

下列範例假設獨立版 Lobster 命令列介面在 openclaw.invoke 已具備正確閘道 URL／驗證內容的環境中執行。

對於 OpenClaw 內建的嵌入式 Lobster 執行器，這種巢狀命令列介面 模式目前並不可靠：

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

在嵌入式 Lobster 尚未提供支援此流程的橋接機制前，建議優先使用：

  • 在 Lobster 外部直接呼叫 llm-task 工具，或
  • 不依賴巢狀 openclaw.invoke 呼叫的 Lobster 步驟。

獨立版 Lobster 命令列介面範例：

lobster
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 值的指示，不得包含程式碼 圍欄或說明文字。
  • 不使用工具：底層執行已停用工具，因此模型無法在任務進行期間 發出外部呼叫。
  • 除非使用 schema 驗證輸出，否則應將其視為不受信任的內容。
  • 對於任何會使用此輸出且產生副作用的步驟（傳送、發布、執行），請先設定 核准程序。

相關內容

Was this useful?
On this page

On this page