OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Overview

概要

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

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

ここから始める

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

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

ツール、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、terminal、code_execution Exec、Control UIターミナル、コード実行
    ファイル ワークスペースファイルの読み取りと変更 read、write、edit、apply_patch パッチの適用
    人による入力 ユーザーが決定権を持つ構造化された判断のために一時停止する ask_user ユーザーに質問
    ウェブ ウェブの検索、X投稿の検索、または読み取り可能なページコンテンツの取得 web_search、x_search、web_fetch ウェブツール、ウェブ取得
    ブラウザー ブラウザーセッションの操作 browser ブラウザー
    オペレーターUI 接続されたControl UIのペイン、パネル、ナビゲーションの配置 screen 画面
    メッセージングとチャネル 返信またはチャネルアクションの送信 message エージェント送信
    セッションとエージェント セッションの検査、作業の委任、コレクターのオーケストレーション、別の実行の誘導、またはステータスの報告 sessions_*、agents_wait、subagents、agents_list、session_status、get_goal、create_goal、update_goal 目標、Swarm、サブエージェント、セッションツール
    自動化 作業のスケジュール設定またはバックグラウンドイベントへの応答 cron、heartbeat_respond 自動化
    GatewayとNode Gatewayの状態またはペアリングされた対象デバイスの検査 gateway、nodes Gateway設定、Node
    メディア メディアの分析、生成、または音声化 image、image_generate、music_generate、video_generate、tts メディアの概要
    大規模なOpenClawカタログ すべてのスキーマをモデルに送信することなく、多数の利用可能なツールを検索、呼び出し、組み合わせる exec、wait、tool_search_code、tool_search、tool_describe コードモード、ツール検索

    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 の可用性により、実行時にツールが使用できなくなることがあります。

    機能を拡張する

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

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

    見つからないツールをトラブルシューティングする

    モデルがツールを認識または呼び出せない場合は、まず現在のターンに適用されている ポリシーを確認します。

    1. ツールとカスタムプロバイダーで、アクティブなプロファイル、 tools.allow、および tools.deny を確認します。
    2. ツールとカスタムプロバイダーでプロバイダー固有の制限を 確認し、選択したモデルプロバイダーがそのツール形式を サポートしていることを確認します。
    3. サンドボックスとツールポリシーと権限昇格の比較 および権限昇格 Execで、チャネル権限、サンドボックスの状態、 および権限昇格アクセスを確認します。
    4. Pluginsで、所有元の Plugin がインストールされ、 有効になっているかを確認します。
    5. 委任された実行では、 エージェントごとのサンドボックスとツール制限でエージェントごとの制限を確認します。
    6. 大規模な 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
    Was this useful?
    On this page

    On this page