ここから始める
ほとんどのエージェントでは、まず組み込みのツールカテゴリから始め、エージェントに表示するツールを減らす必要がある場合や明示的なホストアクセスが必要な場合にのみポリシーを調整します。| やりたいこと… | まず使うもの | 次に読むもの |
|---|---|---|
| 既存の機能でエージェントに動作させる | 組み込みツール | ツールカテゴリ |
| エージェントが呼び出せるものを制御する | ツールポリシー | ツールとカスタムプロバイダー |
| エージェントにワークフローを教える | Skills | Skills、Skills の作成、Skill Workshop |
| 新しい統合またはランタイムサーフェスを追加する | Plugin | Plugin と Plugin の構築 |
| 後で、またはバックグラウンドで作業を実行する | 自動化 | 自動化の概要 |
| 複数のエージェントまたはハーネスを調整する | サブエージェント | ACP エージェント と エージェント送信 |
| 大規模な OpenClaw ツールカタログを検索する | ツール検索 | ツール検索 |
ツール、Skills、Plugin を選択する
エージェントが動作する必要がある場合はツールを使う
ツールは、
exec、browser、
web_search、message、image_generate など、エージェントが呼び出せる型付き関数です。エージェントが
データを読み取る、ファイルを変更する、メッセージを送信する、プロバイダーを呼び出す、または
別のシステムを操作する必要がある場合にツールを使います。表示されるツールは、構造化された
関数定義としてモデルに送信されます。モデルに見えるのは、アクティブなプロファイル、許可/拒否
ポリシー、プロバイダー制限、サンドボックス状態、チャネル権限、
Plugin の可用性を通過したツールだけです。エージェントに指示が必要な場合は Skill を使う
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, get_goal, create_goal, update_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 提供ツールには次のものがあります。
- ファイルと Markdown の差分をレンダリングする Diffs
- JSON のみのワークフローステップ用の LLM Task
- 再開可能な承認を伴う型付きワークフロー用の Lobster
- ノイズの多い
execとbashツールの出力を圧縮する Tokenjuice - すべてのスキーマをプロンプトに入れずに大規模なツール カタログを検出して呼び出すための ツール検索
- Node Canvas 制御と A2UI レンダリング用の Canvas
アクセスと承認を設定する
ツールポリシーはモデル呼び出しの前に適用されます。ポリシーがツールを削除すると、 モデルはそのターンでそのツールのスキーマを受け取りません。実行は、グローバル設定、 エージェントごとの設定、チャネルポリシー、プロバイダー 制限、サンドボックスルール、チャネル/ランタイムポリシー、または Plugin の可用性によってツールを失うことがあります。- ツールとカスタムプロバイダーでは、ツールプロファイル、 許可/拒否リスト、プロバイダー固有の制限、ループ検出、 プロバイダー支援ツール設定について説明しています。
- Exec 承認では、ホストコマンド承認 ポリシーについて説明しています。
- 昇格 execでは、サンドボックス外での制御された実行について説明しています。
- サンドボックス vs ツールポリシー vs 昇格 では、ファイルおよびプロセスアクセスをどのレイヤーが制御するかを説明しています。
- エージェントごとのサンドボックスとツール制限 では、委任された実行に対するエージェント固有の制限について説明しています。
機能を拡張する
OpenClaw に実行させたいジョブに応じて拡張パスを選択します。- 既存の Plugin をインストールまたは管理するには、Pluginを使います。
- 新しい統合、プロバイダー、チャネル、ツール、またはフックを構築するには、 Plugin の構築を使います。
- 再利用可能なエージェント指示を追加または調整するには、Skills と Skills の作成を使います。
- 実装 契約が必要な場合は、Plugin SDK と Plugin マニフェストを使います。
見つからないツールのトラブルシューティング
モデルがツールを見られない、または呼び出せない場合は、現在のターンの有効なポリシーから確認します。- ツールとカスタムプロバイダーで、アクティブなプロファイル、
tools.allow、tools.denyを確認します。 - ツールとカスタムプロバイダーでプロバイダー固有の制限を確認し、 選択されたモデルプロバイダーがそのツール 形状をサポートしていることを確認します。
- サンドボックス vs ツールポリシー vs 昇格 と 昇格 execで、チャネル権限、サンドボックス状態、昇格アクセスを確認します。
- 所有元の Plugin がインストールされ、有効になっているかを Pluginで確認します。
- 委任された実行については、 エージェントごとのサンドボックスとツール制限でエージェントごとの制限を確認します。
- 大規模な OpenClaw カタログについては、実行が直接的なツール 公開を使っているのか、ツール検索を使っているのかを確認します。
関連
- 自動化: cron、タスク、Heartbeat、コミットメント、フック、 常設指示、Task Flow
- エージェント: エージェントモデル、セッション、メモリ、 マルチエージェント連携
- ツールとカスタムプロバイダー: 正規のツール ポリシーリファレンス
- Plugin: Pluginのインストールと管理
- Plugin SDK: Plugin作成者向けリファレンス
- Skills: スキルの読み込み順序、ゲーティング、設定
- スキルワークショップ: 生成済みおよびレビュー済みスキルの 作成
- ツール検索: コンパクトなOpenClawツールカタログの 検出