LLM タスク

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

有効化

Plugin を有効にします。

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

ツールを許可します。

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

ツールパラメータ

パラメータ	型	注記
`prompt`	string	必須。LLM に対するタスク指示。
`input`	any	任意のペイロード。JSON にシリアライズされ、プロンプトに追加されます。
`schema`	object	任意の JSON Schema。解析された出力は、このスキーマに対する検証に合格する必要があります。
`provider`	string	`defaultProvider` またはエージェントのデフォルトプロバイダーを上書きします。
`model`	string	`defaultModel` を上書きします。修飾なしのモデル ID、エイリアス、または `provider/model` 参照を指定できます（重複したプロバイダープレフィックスは自動的に削除されます）。
`thinking`	string	推論レベル（例: `low`、`medium`）。解決されたモデルがサポートするものを指定する必要があります。
`authProfileId`	string	`defaultAuthProfileId` を上書きします。
`temperature`	number	ベストエフォートです。すべてのプロバイダーが従うとは限りません。
`maxTokens`	number	出力トークン数に対するベストエフォートの上限。
`timeoutMs`	number	実行タイムアウト。デフォルトは `30000`。

出力

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 で検証しない限り、出力は信頼できないものとして扱ってください。
この出力を使用する、副作用を伴うステップ（送信、投稿、実行）の前に承認を配置してください。

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

有効化

設定（任意）

ツールパラメータ

出力

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

重要な制限事項

安全上の注意

関連項目

​有効化

​設定（任意）

​ツールパラメータ

​出力

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

​重要な制限事項

​安全上の注意

​関連項目

有効化

設定（任意）

ツールパラメータ

出力

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

重要な制限事項

安全上の注意

関連項目