LLM Task

llm-task là một tool plugin tùy chọn để chạy LLM task chỉ trả về JSON và trả về output có cấu trúc (có thể validate theo JSON Schema).

Tool này rất hữu ích cho các workflow engine như Lobster: các bạn có thể thêm một bước LLM mà không cần viết code OpenClaw riêng cho từng workflow.

Bật plugin

  1. Bật plugin:
{
  "plugins": {
    "entries": {
      "llm-task": { "enabled": true }
    }
  }
}
  1. Thêm tool vào allowlist (vì nó được đăng ký với optional: true):
{
  "agents": {
    "list": [
      {
        "id": "main",
        "tools": { "allow": ["llm-task"] }
      }
    ]
  }
}

Config (tùy chọn)

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

allowedModels là danh sách allowlist các chuỗi provider/model. Nếu set, mọi request ngoài danh sách sẽ bị từ chối.

Tham số của tool

  • prompt (string, bắt buộc)
  • input (any, tùy chọn)
  • schema (object, JSON Schema tùy chọn)
  • provider (string, tùy chọn)
  • model (string, tùy chọn)
  • authProfileId (string, tùy chọn)
  • temperature (number, tùy chọn)
  • maxTokens (number, tùy chọn)
  • timeoutMs (number, tùy chọn)

Output

Trả về details.json chứa JSON đã parse (và validate theo schema nếu được cung cấp).

Ví dụ: Bước workflow Lobster

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

Lưu ý về bảo mật

  • Tool này chỉ trả JSON và yêu cầu model chỉ output JSON (không có code fence, không có comment).
  • Không có tool nào được expose cho model trong lần chạy này.
  • Coi output là không tin cậy trừ khi các bạn validate bằng schema.
  • Đặt approval trước bất kỳ bước nào có side-effect (send, post, exec).