Tools
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-tasklangsung di luar Lobster, atau - langkah Lobster yang tidak bergantung pada panggilan
openclaw.invokebertingkat.
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.
