ここから始める
ほとんどのエージェントでは、組み込みツールカテゴリから始め、エージェントに見せるツールを減らす必要がある場合や、明示的なホストアクセスが必要な場合にのみポリシーを調整します。| 必要なこと | 最初に使うもの | 次に読むもの |
|---|---|---|
| 既存の機能でエージェントに動作させる | 組み込みツール | ツールカテゴリ |
| エージェントが呼び出せるものを制御する | ツールポリシー | ツールとカスタムプロバイダー |
| エージェントにワークフローを教える | 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 | ツール検索 |
ツール検索は実験的な OpenClaw エージェントサーフェスです。Codex ハーネス実行では、
tools.toolSearch の代わりに Codex ネイティブのコードモード、ネイティブツール検索、遅延動的ツール、ネストされた
ツール呼び出しを使います。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 カタログについては、実行が直接的なツール公開を使うのか、 ツール検索を使うのかを確認します。
関連
- 自動化: cron、タスク、heartbeat、コミットメント、フック、常時指示、Task Flow
- エージェント: エージェントモデル、セッション、メモリ、マルチエージェント調整
- ツールとカスタムプロバイダー: 正規のツールポリシーリファレンス
- Plugin: Plugin のインストールと管理
- Plugin SDK: Plugin 作者向けリファレンス
- Skills: Skill の読み込み順序、ゲート、構成
- Skill Workshop: 生成され、レビューされた Skill 作成
- ツール検索: コンパクトな OpenClaw ツールカタログ発見