Skip to main content
OpenClaw のプラグインは、エージェント実行時に LLM へ公開される agent tool(JSON Schema ベースの関数)を登録できます。ツールは required(常に利用可能)にも optional(opt-in)にもできます。 agent tool は、メイン設定の tools、またはエージェントごとの agents.list[].tools で制御します。どのツールをエージェントが呼び出せるかは、allowlist / denylist ポリシーによって決まります。

基本的なツール

Optional tool(opt-in)

optional tool は 自動では有効になりません。利用者がエージェントの allowlist へ明示的に追加する必要があります。
optional tool は agents.list[].tools.allow(またはグローバルの tools.allow)で有効化します。
ツールの可用性に影響する他の設定項目:
  • プラグイン ツールだけを列挙した allowlist は、plugin opt-in として扱われます。core tool を制限したい場合は、allowlist に core tool または group も含めてください。
  • tools.profile / agents.list[].tools.profile(基本 allowlist)
  • tools.byProvider / agents.list[].tools.byProvider(provider ごとの allow / deny)
  • tools.sandbox.tools.*(サンドボックス実行時のツール ポリシー)

ルールとヒント

  • ツール名は core tool 名と 衝突してはいけません。衝突したツールはスキップされます。
  • allowlist で使う plugin id も、core tool 名と衝突してはいけません。
  • 副作用を持つツールや、追加のバイナリ / 認証情報を必要とするツールでは、optional: true を優先してください。