ここから始める
ほとんどのエージェントでは、組み込みツールカテゴリから始め、エージェントに表示する ツールを減らす必要がある場合や、明示的なホストアクセスが必要な場合にのみポリシーを調整します。ツール、Skills、Pluginの選択
1
エージェントがアクションを実行する必要がある場合はツールを使用する
ツールは、
exec、browser、
web_search、message、image_generateなど、エージェントが呼び出せる型付き関数です。エージェントが
データを読み取り、ファイルを変更し、メッセージを送信し、プロバイダーを呼び出し、または
別のシステムを操作する必要がある場合はツールを使用します。表示されるツールは、構造化された
関数定義としてモデルに送信されます。モデルに表示されるのは、アクティブなプロファイル、許可/拒否
ポリシー、プロバイダー制限、サンドボックスの状態、チャネル権限、および
Pluginの可用性による条件を満たしたツールだけです。2
エージェントに指示が必要な場合はSkillsを使用する
Skillsは、エージェントのプロンプトに読み込まれる
SKILL.md指示パックです。
エージェントが必要なツールをすでに備えているものの、反復可能な
ワークフロー、レビュー基準、コマンドシーケンス、または運用上の
制約が必要な場合はSkillsを使用します。Skillsは、ワークスペース、共有Skillsディレクトリ、管理対象のOpenClaw
Skillsルート、またはPluginパッケージに配置できます。Skills | Skillsワークショップ | 自己学習 | Skillsの作成 | Skills設定3
OpenClawに新しいケイパビリティが必要な場合はPluginを使用する
Pluginは、ツール、Skills、チャネル、モデルプロバイダー、音声、
リアルタイム音声、メディア生成、ウェブ検索、ウェブ取得、フック、その他の
ランタイムケイパビリティを追加できます。ケイパビリティにコード、
認証情報、ライフサイクルフック、マニフェストメタデータ、またはインストール可能な
パッケージが含まれる場合はPluginを使用します。既存のPluginは、ClawHub、npm、git、
ローカルディレクトリ、またはアーカイブからインストールできます。Pluginのインストールと設定 | Pluginの構築 | Plugin SDK
組み込みツールカテゴリ
この表には、サーフェスを識別できるように代表的なツールを示しています。これは 完全なポリシーリファレンスではありません。正確なグループ、デフォルト、および許可/拒否の セマンティクスについては、ツールとカスタムプロバイダーを参照してください。コードモードとツール検索は、実験的なOpenClawエージェントサーフェスです。Codex
ハーネスの実行では、
tools.codeModeまたはtools.toolSearchの代わりに、Codexネイティブのコードモード、ネイティブツール検索、遅延動的
ツール、およびネストされたツール呼び出しを使用します。Pluginが提供するツール
Pluginは追加のツールを登録できます。Plugin作成者は、api.registerTool(...)およびマニフェストのcontracts.toolsを介してツールを接続します。契約の詳細については、
Plugin SDKおよびPluginマニフェスト
を参照してください。
Pluginが提供する一般的なツールには、次のものがあります。
- ファイルおよび Markdown の差分をレンダリングするための Diffs
- 対応するチャットクライアントで自己完結型のインライン SVG および HTML を表示するための Show widget
- 接続された Control UI を配置するための Screen
- JSON のみのワークフローステップのための LLM Task
- 再開可能な承認を備えた型付きワークフローのための Lobster
- ノイズの多い
execおよびbashツールの 出力を圧縮するための Tokenjuice - すべてのスキーマをプロンプトに含めずに、大規模なツールカタログを 検出して呼び出すための Tool Search
- Node の Canvas 制御と A2UI レンダリングのための Canvas
アクセスと承認を設定する
ツールポリシーはモデルの呼び出し前に適用されます。ポリシーによってツールが除外された場合、 そのターンではモデルにそのツールのスキーマが提供されません。グローバル設定、エージェントごとの設定、 チャネルポリシー、プロバイダーの制限、サンドボックスルール、チャネル/ランタイムポリシー、 または Plugin の可用性により、実行時にツールが使用できなくなることがあります。- ツールとカスタムプロバイダーでは、ツールプロファイル、 許可/拒否リスト、プロバイダー固有の制限、ループ検出、および プロバイダーを利用するツール設定について説明します。
- Exec の承認では、ホストコマンドの承認 ポリシーについて説明します。
- 権限昇格 Execでは、サンドボックス外での制御された実行に ついて説明します。
- サンドボックスとツールポリシーと権限昇格の比較 では、ファイルおよびプロセスへのアクセスをどのレイヤーが制御するかを説明します。
- エージェントごとのサンドボックスとツール制限 では、委任された実行に対するエージェント固有の制限について説明します。
機能を拡張する
OpenClaw に実行させるジョブに応じて、拡張方法を選択します。- 既存の Plugin を Plugins でインストールまたは管理します。
- 新しいインテグレーション、プロバイダー、チャネル、ツール、またはフックを Plugin の構築で作成します。
- Skills と Skills の作成を使用して、再利用可能なエージェント指示を追加または調整します。
- 実装契約が必要な場合は、Plugin SDK と Plugin マニフェストを使用します。
見つからないツールをトラブルシューティングする
モデルがツールを認識または呼び出せない場合は、まず現在のターンに適用されている ポリシーを確認します。- ツールとカスタムプロバイダーで、アクティブなプロファイル、
tools.allow、およびtools.denyを確認します。 - ツールとカスタムプロバイダーでプロバイダー固有の制限を 確認し、選択したモデルプロバイダーがそのツール形式を サポートしていることを確認します。
- サンドボックスとツールポリシーと権限昇格の比較 および権限昇格 Execで、チャネル権限、サンドボックスの状態、 および権限昇格アクセスを確認します。
- Pluginsで、所有元の Plugin がインストールされ、 有効になっているかを確認します。
- 委任された実行では、 エージェントごとのサンドボックスとツール制限でエージェントごとの制限を確認します。
- 大規模な OpenClaw カタログでは、実行がツールの直接公開、 Code Mode、または Tool Search のいずれを使用しているか確認します。
関連項目
- Cron、タスク、Heartbeat、フック、 常設指示、Task Flow については自動化
- エージェントモデル、セッション、メモリ、および マルチエージェント連携についてはエージェント
- 正式なツールポリシーのリファレンスについては ツールとカスタムプロバイダー
- Plugin のインストールと管理については Plugins
- Plugin 作成者向けリファレンスについては Plugin SDK
- Skills の読み込み順序、ゲーティング、および設定については Skills
- 生成およびレビューを経た Skills の作成については Skills ワークショップ
- OpenClaw のツールカタログをコンパクトに検出する方法については Tool Search
- 非表示の OpenClaw ツールカタログを利用する、コンパクトな JavaScript または TypeScript ワークフローについては Code Mode
- Code Mode からの構造化されたファンアウトと収集については Swarm