Tugas LLM

llm-task adalah alat Plugin opsional bawaan yang menjalankan satu panggilan LLM khusus JSON dan mengembalikan keluaran terstruktur, yang secara opsional divalidasi terhadap JSON Schema. Alat ini menyediakan langkah LLM bagi mesin alur kerja seperti Lobster tanpa memerlukan kode OpenClaw khusus untuk setiap alur kerja.

Mengaktifkan

Aktifkan Plugin:

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

Izinkan alat:

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

alsoAllow menambahkan llm-task di atas profil alat aktif tanpa membatasi alat inti lainnya. Gunakan tools.allow hanya jika Anda menginginkan mode daftar izin yang restriktif.

Konfigurasi (opsional)

{
  "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 adalah daftar izin berisi string provider/model; permintaan untuk model lain akan ditolak. Semua kunci lainnya merupakan nilai cadangan per panggilan yang digunakan ketika panggilan alat tidak menyertakan parameter tersebut.

Parameter alat

Parameter	Jenis	Catatan
`prompt`	string	Wajib. Instruksi tugas untuk LLM.
`input`	any	Muatan opsional; diserialisasi menjadi JSON dan ditambahkan ke perintah.
`schema`	object	JSON Schema opsional yang harus dipenuhi oleh keluaran yang telah diuraikan.
`provider`	string	Menggantikan `defaultProvider` / penyedia default agen.
`model`	string	Menggantikan `defaultModel`; menerima ID model biasa, alias, atau referensi `provider/model` (prefiks penyedia yang terduplikasi dihapus secara otomatis).
`thinking`	string	Tingkat penalaran (misalnya `low`, `medium`); harus termasuk tingkat yang didukung oleh model yang ditentukan.
`authProfileId`	string	Menggantikan `defaultAuthProfileId`.
`temperature`	number	Upaya terbaik; tidak semua penyedia mendukungnya.
`maxTokens`	number	Batas upaya terbaik untuk token keluaran.
`timeoutMs`	number	Batas waktu eksekusi; default `30000`.

Keluaran

Mengembalikan details.json (JSON yang telah diuraikan dan divalidasi terhadap skema), beserta details.provider dan details.model yang menunjukkan penyedia dan model yang benar-benar dijalankan.

Contoh: langkah alur kerja Lobster

Batasan penting

Contoh di bawah ini mengasumsikan bahwa CLI Lobster mandiri berjalan di lingkungan tempat openclaw.invoke telah memiliki konteks URL Gateway/autentikasi yang benar. Untuk pelaksana Lobster tertanam bawaan di dalam OpenClaw, pola CLI bertingkat ini saat ini belum andal:

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

Hingga Lobster tertanam memiliki jembatan yang didukung untuk alur ini, sebaiknya gunakan salah satu dari berikut:

panggilan alat llm-task langsung di luar Lobster, atau
langkah Lobster yang tidak bergantung pada panggilan openclaw.invoke bertingkat.

Contoh CLI Lobster mandiri:

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

Catatan keamanan

Khusus JSON: model diinstruksikan untuk hanya mengembalikan nilai JSON, tanpa pagar kode dan tanpa komentar.
Tanpa alat: eksekusi yang mendasarinya menonaktifkan alat, sehingga model tidak dapat melakukan panggilan keluar di tengah tugas.
Perlakukan keluaran sebagai tidak tepercaya kecuali Anda memvalidasinya menggunakan schema.
Tempatkan persetujuan sebelum setiap langkah yang menimbulkan efek samping (mengirim, memposting, mengeksekusi) dan menggunakan keluaran ini.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Mengaktifkan

Konfigurasi (opsional)

Parameter alat

Keluaran

Contoh: langkah alur kerja Lobster

Batasan penting

Catatan keamanan

Terkait

​Mengaktifkan

​Konfigurasi (opsional)

​Parameter alat

​Keluaran

​Contoh: langkah alur kerja Lobster

​Batasan penting

​Catatan keamanan

​Terkait

Mengaktifkan

Konfigurasi (opsional)

Parameter alat

Keluaran

Contoh: langkah alur kerja Lobster

Batasan penting

Catatan keamanan

Terkait