Tác vụ LLM

llm-task là một công cụ Plugin tùy chọn được tích hợp sẵn, thực hiện một lệnh gọi LLM chỉ trả về JSON và trả về đầu ra có cấu trúc, có thể tùy chọn xác thực theo JSON Schema. Công cụ này cung cấp cho các công cụ quy trình như Lobster một bước LLM mà không cần mã OpenClaw tùy chỉnh cho từng quy trình.

​

Bật

1. Bật Plugin:

{
  "plugins": {
    "entries": {
      "llm-task": { "enabled": true }
    }
  }
}

2. Cho phép công cụ:

{
  "tools": {
    "alsoAllow": ["llm-task"]
  }
}

alsoAllow bổ sung llm-task vào hồ sơ công cụ đang hoạt động mà không hạn chế các công cụ cốt lõi khác. Chỉ sử dụng tools.allow nếu bạn muốn dùng chế độ danh sách cho phép có tính hạn chế.

​

Cấu hình (tùy chọn)

{
  "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 là danh sách cho phép gồm các chuỗi provider/model; yêu cầu đối với bất kỳ mô hình nào khác sẽ bị từ chối. Tất cả các khóa khác là giá trị dự phòng cho từng lệnh gọi, được sử dụng khi lệnh gọi công cụ bỏ qua tham số tương ứng.

​

Tham số công cụ

Tham số	Kiểu	Ghi chú
prompt	string	Bắt buộc. Chỉ dẫn tác vụ cho LLM.
input	any	Dữ liệu đầu vào tùy chọn; được tuần tự hóa thành JSON và nối vào lời nhắc.
schema	object	JSON Schema tùy chọn mà đầu ra đã phân tích phải đáp ứng khi xác thực.
provider	string	Ghi đè defaultProvider / nhà cung cấp mặc định của tác tử.
model	string	Ghi đè defaultModel; chấp nhận mã định danh mô hình thuần, bí danh hoặc tham chiếu provider/model (tiền tố nhà cung cấp trùng lặp sẽ tự động bị loại bỏ).
thinking	string	Mức độ suy luận (ví dụ: low, medium); phải là một mức được mô hình đã phân giải hỗ trợ.
authProfileId	string	Ghi đè defaultAuthProfileId.
temperature	number	Áp dụng trong phạm vi có thể; không phải mọi nhà cung cấp đều tuân thủ giá trị này.
maxTokens	number	Giới hạn tối đa số token đầu ra trong phạm vi có thể.
timeoutMs	number	Thời gian chờ khi chạy; mặc định là 30000.

​

Đầu ra

Trả về details.json (JSON đã được phân tích và xác thực theo lược đồ), cùng với details.provider và details.model cho biết nhà cung cấp và mô hình thực tế đã chạy.

​

Ví dụ: bước trong quy trình Lobster

​

Giới hạn quan trọng

Ví dụ dưới đây giả định CLI Lobster độc lập đang chạy trong môi trường mà openclaw.invoke đã có đúng URL Gateway/ngữ cảnh xác thực.

Đối với trình chạy Lobster nhúng được tích hợp bên trong OpenClaw, mẫu CLI lồng nhau này hiện không đáng tin cậy:

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

Cho đến khi Lobster nhúng có cầu nối được hỗ trợ cho luồng này, hãy ưu tiên một trong các cách sau:

• gọi trực tiếp công cụ llm-task bên ngoài Lobster, hoặc
• sử dụng các bước Lobster không phụ thuộc vào lệnh gọi openclaw.invoke lồng nhau.

Ví dụ về CLI Lobster độc lập:

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

​

Lưu ý an toàn

• Chỉ JSON: mô hình được chỉ dẫn chỉ trả về một giá trị JSON, không có hàng rào mã và không có bình luận.
• Không có công cụ: lần chạy nền đã tắt các công cụ, vì vậy mô hình không thể gọi ra bên ngoài giữa chừng trong tác vụ.
• Xem đầu ra là không đáng tin cậy, trừ khi bạn xác thực đầu ra bằng schema.
• Đặt các bước phê duyệt trước mọi bước gây tác dụng phụ (gửi, đăng, thực thi) sử dụng đầu ra này.

​

Liên quan

• Các mức suy luận
• Tác tử con
• Lệnh gạch chéo