LLM タスク

llm-task は、JSON のみを扱う単一の LLM 呼び出しを実行し、構造化された出力を返す、同梱のオプション Plugin ツールです。必要に応じて、JSON Schema に対する検証も行えます。Lobster のようなワークフローエンジンで、ワークフローごとにカスタム OpenClaw コードを作成することなく LLM ステップを利用できます。

有効化

1. Plugin を有効にします。

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

2. ツールを許可します。

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

alsoAllow は、他のコアツールを制限することなく、アクティブなツールプロファイルに llm-task を追加します。代わりに制限的な許可リストモードを使用する場合にのみ、tools.allow を使用してください。

設定（任意）

{  "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 文字列の許可リストです。それ以外のモデルへのリクエストは拒否されます。その他のキーはすべて呼び出し単位のフォールバックであり、ツール呼び出しで該当するパラメータが省略された場合に使用されます。

ツールパラメータ

出力

details.json（解析され、スキーマ検証に合格した JSON）に加えて、実際に実行された内容を示す details.provider と details.model を返します。

例: Lobster ワークフローステップ

重要な制限事項

以下の例では、スタンドアロンの Lobster CLI が、openclaw.invoke に正しい Gateway URL と認証コンテキストがすでに設定されている環境で実行されていることを前提としています。

OpenClaw に同梱された組み込み Lobster ランナーでは、次のような CLI のネストパターンは現在のところ信頼性がありません。

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

組み込み Lobster でこのフローに対応するブリッジがサポートされるまでは、次のいずれかを推奨します。

• Lobster の外部から llm-task ツールを直接呼び出す、または
• ネストされた openclaw.invoke 呼び出しに依存しない Lobster ステップを使用する。

スタンドアロン Lobster CLI の例:

openclaw.invoke --tool llm-task --action json --args-json '{  "prompt": "入力されたメールに基づいて、意図と返信案を返してください。",  "thinking": "low",  "input": {    "subject": "こんにちは",    "body": "手伝ってもらえますか？"  },  "schema": {    "type": "object",    "properties": {      "intent": { "type": "string" },      "draft": { "type": "string" }    },    "required": ["intent", "draft"],    "additionalProperties": false  }}'

安全上の注意

• JSON のみ: モデルには、コードフェンスや解説を含めず、JSON 値のみを返すよう指示されます。
• ツールなし: 基盤となる実行ではツールが無効化されているため、モデルがタスクの途中で外部を呼び出すことはできません。
• schema で検証しない限り、出力は信頼できないものとして扱ってください。
• この出力を使用する、副作用を伴うステップ（送信、投稿、実行）の前に承認を配置してください。

関連項目

• 推論レベル
• サブエージェント
• スラッシュコマンド