Overview

概要

このページを使って、適切な Capabilities サーフェスを選択します。ツールは呼び出し可能なアクションで、Skillsはエージェントに作業方法を教え、Pluginはツール、プロバイダー、チャンネル、フック、パッケージ化された Skills などのランタイム機能を追加します。

これは概要とルーティングのページです。網羅的なツールポリシー、デフォルト、グループ所属、プロバイダー制限、構成フィールドについては、ツールとカスタムプロバイダーを参照してください。

ここから始める

ほとんどのエージェントでは、組み込みツールカテゴリから始め、エージェントに見せるツールを減らす必要がある場合や、明示的なホストアクセスが必要な場合にのみポリシーを調整します。

必要なこと	最初に使うもの	次に読むもの
既存の機能でエージェントに動作させる	組み込みツール	ツールカテゴリ
エージェントが呼び出せるものを制御する	ツールポリシー	ツールとカスタムプロバイダー
エージェントにワークフローを教える	Skills	Skills、Skills の作成、Skill Workshop
新しい統合またはランタイムサーフェスを追加する	Plugin	Plugin と Plugin の構築
後で、またはバックグラウンドで作業を実行する	自動化	自動化の概要
複数のエージェントまたはハーネスを調整する	サブエージェント	ACP エージェントとエージェント送信
大規模な OpenClaw ツールカタログを検索する	ツール検索	ツール検索

ツール、Skills、Plugin を選ぶ

エージェントが動作する必要がある場合はツールを使う

ツールは、exec、browser、 web_search、message、image_generate など、エージェントが呼び出せる型付き関数です。エージェントがデータを読み取る、ファイルを変更する、メッセージを送信する、プロバイダーを呼び出す、または別のシステムを操作する必要がある場合にツールを使います。表示されるツールは、構造化された関数定義としてモデルに送信されます。

モデルに見えるのは、アクティブなプロファイル、許可/拒否ポリシー、プロバイダー制限、サンドボックス状態、チャンネル権限、Plugin の可用性を通過したツールだけです。

エージェントが指示を必要とする場合は Skills を使う

Skill は、エージェントプロンプトに読み込まれる SKILL.md 指示パックです。エージェントが必要なツールをすでに持っているが、反復可能なワークフロー、レビュールーブリック、コマンドシーケンス、または運用上の制約を必要とする場合に Skill を使います。

Skills は、ワークスペース、共有 Skill ディレクトリ、管理対象の OpenClaw Skill ルート、または Plugin パッケージに配置できます。

Skills | Skill Workshop | Skills の作成 | Skills 構成

OpenClaw に新しい機能が必要な場合は Plugin を使う

Plugin は、ツール、Skills、チャンネル、モデルプロバイダー、音声、リアルタイム音声、メディア生成、Web 検索、Web 取得、フック、その他のランタイム機能を追加できます。機能にコード、認証情報、ライフサイクルフック、マニフェストメタデータ、またはインストール可能なパッケージングがある場合に Plugin を使います。既存の Plugin は、ClawHub、npm、git、ローカルディレクトリ、またはアーカイブからインストールできます。

Plugin のインストールと構成 | Plugin の構築 | Plugin SDK

組み込みツールカテゴリ

この表には、サーフェスを識別できるように代表的なツールを示しています。これは完全なポリシーリファレンスではありません。正確なグループ、デフォルト、許可/拒否セマンティクスについては、ツールとカスタムプロバイダーを参照してください。

カテゴリ	エージェントが必要とすること	代表的なツール	次に読むもの
ランタイム	コマンドを実行する、プロセスを管理する、またはプロバイダー支援の Python 解析を使う	`exec`, `process`, `code_execution`	Exec, コード実行
ファイル	ワークスペースファイルを読み取り、変更する	`read`, `write`, `edit`, `apply_patch`	パッチ適用
Web	Web を検索する、X 投稿を検索する、または読み取り可能なページコンテンツを取得する	`web_search`, `x_search`, `web_fetch`	Web ツール, Web 取得
ブラウザ	ブラウザセッションを操作する	`browser`	ブラウザ
メッセージングとチャンネル	返信またはチャンネルアクションを送信する	`message`	エージェント送信
セッションとエージェント	セッションを調査する、作業を委任する、別の実行を誘導する、またはステータスを報告する	`sessions_*`, `subagents`, `agents_list`, `session_status`, `goal`	Goal, サブエージェント, セッションツール
自動化	作業をスケジュールする、またはバックグラウンドイベントに応答する	`cron`, `heartbeat_respond`	自動化
Gateway とノード	Gateway の状態またはペアリング済みターゲットデバイスを調査する	`gateway`, `nodes`	Gateway 構成, ノード
メディア	メディアを解析、生成、または読み上げる	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`	メディアの概要
大規模な OpenClaw カタログ	すべてのスキーマをモデルに送信せずに、多数の対象ツールを検索して呼び出す	`tool_search_code`, `tool_search`, `tool_describe`	ツール検索

Plugin 提供ツール

Plugin は追加のツールを登録できます。Plugin 作者は api.registerTool(...) とマニフェストの contracts.tools を通じてツールを接続します。契約の詳細については、 Plugin SDK と Plugin マニフェストを参照してください。

一般的な Plugin 提供ツールには次のものがあります。

Diffs: ファイルと Markdown 差分のレンダリング
LLM Task: JSON のみのワークフローステップ
Lobster: 再開可能な承認を備えた型付きワークフロー
Tokenjuice: ノイズの多い exec と bash ツール出力の圧縮
ツール検索: すべてのスキーマをプロンプトに入れずに、大規模なツールカタログを発見して呼び出す
Canvas: ノード Canvas 制御と A2UI レンダリング

アクセスと承認を構成する

ツールポリシーはモデル呼び出しの前に適用されます。ポリシーがツールを削除すると、モデルはそのターンでそのツールのスキーマを受け取りません。実行は、グローバル構成、エージェントごとの構成、チャンネルポリシー、プロバイダー制限、サンドボックスルール、チャンネル/ランタイムポリシー、または Plugin の可用性によりツールを失うことがあります。

ツールとカスタムプロバイダーでは、ツールプロファイル、許可/拒否リスト、プロバイダー固有の制限、ループ検出、プロバイダー支援ツール設定について説明しています。
Exec 承認では、ホストコマンド承認ポリシーについて説明しています。
Elevated execでは、サンドボックス外での制御された実行について説明しています。
サンドボックス vs ツールポリシー vs elevatedでは、どのレイヤーがファイルとプロセスアクセスを制御するかを説明しています。
エージェントごとのサンドボックスとツール制限では、委任された実行に対するエージェント固有の制限について説明しています。

機能を拡張する

OpenClaw に実行させたいジョブに応じて拡張パスを選択します。

既存の Plugin をインストールまたは管理するには、Pluginを使います。
新しい統合、プロバイダー、チャンネル、ツール、またはフックを構築するには、 Plugin の構築を使います。
再利用可能なエージェント指示を追加または調整するには、Skills と Skills の作成を使います。
実装契約が必要な場合は、Plugin SDK と Plugin マニフェストを使います。

見つからないツールをトラブルシュートする

モデルがツールを確認または呼び出しできない場合は、現在のターンの有効なポリシーから始めます。

ツールとカスタムプロバイダーで、アクティブなプロファイル、tools.allow、tools.deny を確認します。
ツールとカスタムプロバイダーでプロバイダー固有の制限を確認し、選択されたモデルプロバイダーがそのツール形状をサポートしていることを確認します。
サンドボックス vs ツールポリシー vs elevated と Elevated execで、チャンネル権限、サンドボックス状態、elevated アクセスを確認します。
所有元の Plugin がインストールされ、有効になっているかを Pluginで確認します。
委任された実行については、エージェントごとのサンドボックスとツール制限でエージェントごとの制限を確認します。
大規模な OpenClaw カタログについては、実行が直接的なツール公開を使うのか、ツール検索を使うのかを確認します。

概要