Overview
概要
このページは、適切な Capabilities サーフェスを選ぶために使用します。ツールは呼び出し可能なアクションであり、Skillsはエージェントに作業方法を教え、pluginsはツール、プロバイダー、チャネル、フック、パッケージ化された Skills などのランタイム機能を追加します。
これは概要とルーティングのページです。網羅的なツールポリシー、デフォルト、グループメンバーシップ、プロバイダー制限、設定フィールドについては、ツールとカスタムプロバイダーを使用してください。
ここから始める
ほとんどのエージェントでは、まず組み込みツールカテゴリから始め、その後、エージェントに見せるツールを減らす必要がある場合や、明示的なホストアクセスが必要な場合にだけポリシーを調整します。
| 必要なこと | 最初に使うもの | 次に読むもの |
|---|---|---|
| 既存の機能でエージェントに動作させる | 組み込みツール | ツールカテゴリ |
| エージェントが呼び出せるものを制御する | ツールポリシー | ツールとカスタムプロバイダー |
| エージェントにワークフローを教える | Skills | Skills と Skills の作成 |
| 新しいインテグレーションまたはランタイムサーフェスを追加する | Plugins | Plugins と plugins のビルド |
| 後で、またはバックグラウンドで作業を実行する | Automation | Automation の概要 |
| 複数のエージェントまたはハーネスを調整する | サブエージェント | ACP エージェント と エージェント送信 |
| 大規模な PI ツールカタログを検索する | Tool Search | Tool Search |
ツール、Skills、plugins を選ぶ
エージェントが行動する必要がある場合はツールを使う
ツールは、エージェントが呼び出せる型付き関数です。たとえば exec、browser、
web_search、message、image_generate などです。エージェントがデータを読み取る、
ファイルを変更する、メッセージを送信する、プロバイダーを呼び出す、または別のシステムを操作する必要がある場合にツールを使います。
表示されるツールは、構造化された関数定義としてモデルに送信されます。
モデルが見るのは、アクティブなプロファイル、許可/拒否ポリシー、 プロバイダー制限、サンドボックス状態、チャネル権限、 plugin の可用性を通過したツールだけです。
エージェントに指示が必要な場合は Skill を使う
Skill は、エージェントプロンプトに読み込まれる SKILL.md 指示パックです。
エージェントが必要なツールをすでに持っているが、再現可能なワークフロー、
レビュー基準、コマンドシーケンス、または操作上の制約が必要な場合に Skill を使います。
Skills は、ワークスペース、共有 Skill ディレクトリ、管理対象の OpenClaw Skill ルート、または plugin パッケージに置くことができます。
OpenClaw に新しい機能が必要な場合は plugin を使う
plugin は、ツール、Skills、チャネル、モデルプロバイダー、音声、リアルタイム音声、 メディア生成、Web 検索、Web 取得、フック、その他のランタイム機能を追加できます。 機能にコード、資格情報、ライフサイクルフック、マニフェストメタデータ、 またはインストール可能なパッケージングがある場合に plugin を使います。既存の plugins は、ClawHub、npm、git、ローカルディレクトリ、または アーカイブからインストールできます。
組み込みツールカテゴリ
この表には、サーフェスを認識できるよう代表的なツールを示しています。これは 完全なポリシーリファレンスではありません。正確なグループ、デフォルト、許可/拒否 セマンティクスについては、ツールとカスタムプロバイダーを使用してください。
| カテゴリ | エージェントに必要なこと | 代表的なツール | 次に読むもの |
|---|---|---|---|
| ランタイム | コマンドを実行する、プロセスを管理する、またはプロバイダー支援の Python 解析を使う | exec, process, code_execution |
Exec, コード実行 |
| ファイル | ワークスペースファイルを読み取り、変更する | read, write, edit, apply_patch |
Apply patch |
| Web | Web を検索する、X 投稿を検索する、または読み取り可能なページ内容を取得する | web_search, x_search, web_fetch |
Web ツール, Web fetch |
| ブラウザ | ブラウザセッションを操作する | browser |
ブラウザ |
| メッセージングとチャネル | 返信またはチャネルアクションを送信する | message |
エージェント送信 |
| セッションとエージェント | セッションを調べる、作業を委任する、別の実行を誘導する、またはステータスを報告する | sessions_*, subagents, agents_list, session_status |
サブエージェント, セッションツール |
| Automation | 作業をスケジュールする、またはバックグラウンドイベントに応答する | cron, heartbeat_respond |
Automation |
| Gateway とノード | Gateway 状態またはペアリングされたターゲットデバイスを調べる | gateway, nodes |
Gateway 設定, ノード |
| メディア | メディアを分析、生成、または読み上げる | image, image_generate, music_generate, video_generate, tts |
メディア概要 |
| 大規模な PI カタログ | すべてのスキーマをモデルに送らずに、多数の対象ツールを検索して呼び出す | tool_search_code, tool_search, tool_describe |
Tool Search |
plugin 提供のツール
plugins は追加のツールを登録できます。plugin 作者は
api.registerTool(...) とマニフェストの contracts.tools を通じてツールを接続します。契約の詳細については
Plugin SDK と Plugin マニフェスト
を使用してください。
一般的な plugin 提供ツールには次があります。
- ファイルと Markdown の差分をレンダリングするための Diffs
- JSON のみのワークフローステップ用の LLM Task
- 再開可能な承認を伴う型付きワークフロー用の Lobster
- ノイズの多い
execとbashツール出力を圧縮するための Tokenjuice - すべてのスキーマをプロンプトに入れずに大規模なツールカタログを発見して呼び出すための Tool Search
- ノード Canvas 制御と A2UI レンダリング用の Canvas
アクセスと承認を設定する
ツールポリシーはモデル呼び出しの前に適用されます。ポリシーがツールを削除した場合、 モデルはそのターンでそのツールのスキーマを受け取りません。実行では、 グローバル設定、エージェントごとの設定、チャネルポリシー、プロバイダー 制限、サンドボックスルール、オーナー限定ゲート、または plugin の可用性によってツールを失うことがあります。
- ツールとカスタムプロバイダーでは、ツールプロファイル、 許可/拒否リスト、プロバイダー固有の制限、ループ検出、 プロバイダー支援ツール設定を説明しています。
- Exec 承認では、ホストコマンド承認 ポリシーを説明しています。
- 昇格 execでは、サンドボックス外での制御された実行を 説明しています。
- サンドボックス vs ツールポリシー vs 昇格では、どのレイヤーがファイルとプロセスのアクセスを制御するかを説明しています。
- エージェントごとのサンドボックスとツール制限 では、委任された実行に対するエージェント固有の制限を説明しています。
機能を拡張する
OpenClaw に実行させる必要がある作業に応じて、拡張パスを選びます。
- Pluginsで既存の plugin をインストールまたは管理します。
- plugins のビルドで新しいインテグレーション、プロバイダー、チャネル、ツール、またはフックを構築します。
- Skills と Skills の作成で再利用可能なエージェント指示を追加または調整します。
- ワークフローが plugin 配布の Skill バンドルに属する場合は、 Skill workshopで再利用可能なワークフロー素材をパッケージ化します。
- 実装契約が必要な場合は、Plugin SDK と Plugin マニフェストを使用します。
見つからないツールのトラブルシューティング
モデルがツールを見たり呼び出したりできない場合は、現在のターンの有効なポリシーから始めます。
- ツールとカスタムプロバイダーで、アクティブなプロファイル、
tools.allow、tools.denyを確認します。 - ツールとカスタムプロバイダーでプロバイダー固有の制限を確認し、選択した モデルプロバイダーがそのツール形状をサポートしていることを確認します。
- サンドボックス vs ツールポリシー vs 昇格 と 昇格 execで、チャネル権限、サンドボックス状態、昇格アクセスを確認します。
- 所有元の plugin が Pluginsでインストールされ、有効化されているかを確認します。
- 委任された実行では、 エージェントごとのサンドボックスとツール制限でエージェントごとの制限を確認します。
- 大規模な PI カタログでは、その実行が直接のツール公開を使っているのか、 Tool Searchを使っているのかを確認します。
関連
- cron、タスク、Heartbeat、コミットメント、フック、常設指示、Task Flow については Automation
- エージェントモデル、セッション、メモリ、マルチエージェント調整については エージェント
- 正規のツールポリシーリファレンスについては ツールとカスタムプロバイダー
- plugin のインストールと管理については Plugins
- plugin 作者向けリファレンスについては Plugin SDK
- Skill の読み込み順、ゲート、設定については Skills
- コンパクトな PI ツールカタログ探索については Tool Search