Overview

概要

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

これは概要と案内のページです。ツールポリシー、デフォルト、グループの構成、プロバイダーの制限、設定フィールドの詳細については、ツールとカスタムプロバイダーを参照してください。

ここから始める

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

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

ツール、Skills、Plugin の選択

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

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

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

エージェントに指示が必要な場合は Skills を使用する

Skills は、エージェントのプロンプトに読み込まれる SKILL.md 指示パックです。エージェントが必要なツールをすでに備えているものの、反復可能なワークフロー、レビュー基準、コマンドの手順、または運用上の制約が必要な場合に Skills を使用します。

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

Skills | Skills ワークショップ | Skills の作成 | Skills の設定

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

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

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

組み込みツールカテゴリ

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

カテゴリ	エージェントが次のことを行う必要がある場合に使用	代表的なツール	次に読むもの
ランタイム	コマンドの実行、プロセスの管理、またはプロバイダーを利用した Python 分析の使用	`exec`, `process`, `code_execution`	Exec、コード実行
ファイル	ワークスペースファイルの読み取りと変更	`read`, `write`, `edit`, `apply_patch`	パッチの適用
ウェブ	ウェブの検索、X の投稿の検索、または読み取り可能なページコンテンツの取得	`web_search`, `x_search`, `web_fetch`	ウェブツール、ウェブ取得
ブラウザ	ブラウザセッションの操作	`browser`	ブラウザ
メッセージングとチャネル	返信またはチャネルアクションの送信	`message`	エージェント送信
セッションとエージェント	セッションの確認、作業の委任、別の実行の制御、またはステータスの報告	`sessions_*`, `subagents`, `agents_list`, `session_status`, `get_goal`, `create_goal`, `update_goal`	目標、サブエージェント、セッションツール
自動化	作業のスケジュール設定またはバックグラウンドイベントへの応答	`cron`, `heartbeat_respond`	自動化
Gateway と Node	Gateway の状態またはペアリングされた対象デバイスの確認	`gateway`, `nodes`	Gateway の設定、Node
メディア	メディアの分析、生成、または読み上げ	`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 が提供する一般的なツールには、次のものがあります。

ファイルと Markdown の差分をレンダリングする差分
ウェブチャット内で自己完結型のインライン SVG と HTML を表示するウィジェットを表示
JSON のみのワークフローステップに使用する LLM タスク
再開可能な承認を備えた型付きワークフローに使用する Lobster
ノイズの多い exec と bash ツールの出力を圧縮する Tokenjuice
すべてのスキーマをプロンプトに含めずに大規模なツールカタログを検出して呼び出すツール検索
Node の Canvas 制御と A2UI レンダリングに使用する Canvas

アクセスと承認の設定

ツールポリシーは、モデル呼び出しの前に適用されます。ポリシーによってツールが削除されると、そのターンではモデルにそのツールのスキーマが送信されません。実行でツールが使用できなくなる原因には、グローバル設定、エージェントごとの設定、チャネルポリシー、プロバイダーの制限、サンドボックスルール、チャネル/ランタイムポリシー、Plugin の可用性があります。

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

機能の拡張

OpenClaw に実行させる作業に応じて、拡張方法を選択します。

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

不足しているツールのトラブルシューティング

モデルがツールを表示または呼び出せない場合は、現在のターンに適用される実効ポリシーの確認から始めます。

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

概要