メインコンテンツへスキップ
llm-task はバンドルされた任意の plugin toolで、JSON のみを返す単一の LLM 呼び出しを実行し、任意で JSON Schema に対して検証された構造化出力を返します。Lobster のようなワークフローエンジンに、ワークフローごとのカスタム OpenClaw コードなしで LLM ステップを提供します。

​
有効化

  1. Plugin を有効にします。
{
  "plugins": {
    "entries": {
      "llm-task": { "enabled": true }
    }
  }
}
  1. ツールを許可します。
{
  "tools": {
    "alsoAllow": ["llm-task"]
  }
}
alsoAllow は、他のコアツールを制限せずに、アクティブなツールプロファイルの上に llm-task を追加します。代わりに制限的な許可リストモードを使いたい場合のみ tools.allow を使用してください。

​
設定（任意）

{
  "plugins": {
    "entries": {
      "llm-task": {
        "enabled": true,
        "config": {
          "defaultProvider": "openai",
          "defaultModel": "gpt-5.5",
          "defaultAuthProfileId": "main",
          "allowedModels": ["openai/gpt-5.5"],
          "maxTokens": 800,
          "timeoutMs": 30000
        }
      }
    }
  }
}
allowedModels は provider/model 文字列の許可リストです。それ以外のモデルへのリクエストは拒否されます。他のすべてのキーは、ツール呼び出しでそのパラメータが省略された場合に使われる呼び出しごとのフォールバックです。

​
ツールパラメータ

パラメータ型注記
promptstring必須。LLM へのタスク指示。
inputany任意のペイロード。JSON にシリアライズされ、プロンプトに追加されます。
schemaobject任意の JSON Schema。解析された出力はこれに対して検証される必要があります。
providerstringdefaultProvider / エージェントのデフォルトプロバイダーを上書きします。
modelstringdefaultModel を上書きします。素のモデル ID、エイリアス、または provider/model 参照を受け付けます（重複するプロバイダープレフィックスは自動的に取り除かれます）。
thinkingstring推論レベル（例: low, medium）。解決されたモデルでサポートされているもののいずれかである必要があります。
authProfileIdstringdefaultAuthProfileId を上書きします。
temperaturenumberベストエフォート。すべてのプロバイダーがこれを尊重するわけではありません。
maxTokensnumber出力トークン数のベストエフォート上限。
timeoutMsnumber実行タイムアウト。デフォルトは 30000。

​
出力

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

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

​
重要な制限

以下の例は、スタンドアロンの Lobster CLI が実行されており、 openclaw.invoke にすでに正しい gateway URL/auth コンテキストがあることを前提としています。 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": "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
  }
}'

​
安全上の注意

  • JSON のみ: モデルには JSON 値のみを返すよう指示され、コードフェンスやコメントは返しません。
  • ツールなし: 下位の実行ではツールが無効化されているため、モデルはタスク中に外部呼び出しできません。
  • schema で検証しない限り、出力は信頼できないものとして扱ってください。
  • この出力を消費する副作用のあるステップ（send、post、exec）の前には承認を置いてください。

​
関連