OpenClawの設定 - ツールとスキルのソースを表示

== 概要 ==
OpenClawのワークスペースには、エージェントの能力を拡張する2つの設定ファイルとして、<u>TOOLS.md</u> と <u>SKILL.md</u> が存在する。<br>
<br>
<u>TOOLS.md</u> は、環境固有のツール設定情報を記録するローカルノートファイルである。<br>
カメラ設備、SSH接続情報、音声合成設定、デバイスニックネーム等のローカル環境に依存する情報をMarkdown形式で管理する。<br>
スキル更新時に設定が失われず、スキル共有時に機密情報を露出させない設計となっている。<br>
<u>TOOLS.mdはワークスペースに留まり続けるため、環境固有の設定を再入力する必要がなく、スキルの可搬性とローカル設定の永続性を両立している。</u><br>
<br>
<u>SKILL.md</u> は、エージェントの能力を拡張するスキルを定義するファイルである。<br>
YAMLフロントマターとMarkdown形式で記述し、スラッシュコマンドによるユーザ呼び出しやモデルの自動呼び出しを制御できる。<br>
<br>
<u>スキルは、Workspaceスキル、Managed/Localスキル、Bundledスキルの優先度順で読み込まれ、同一名スキルの場合は優先度の高い方が採用される。</u><br>
<br>
OpenClawはMCP (Model Context Protocol) のネイティブサポートを持ち、<u>openclaw.json</u> ファイルの <code>agents[].mcp.servers</code> セクションでMCPサーバを設定する。<br>
トランスポートは <code>stdio</code> (デフォルト) を使用し、子プロセスでJSON-RPC 2.0通信を行う。<br>
<br>
公式スキルレジストリのClawHubには5,700以上のスキルが登録されており、VirusTotalによるセキュリティスキャンが自動で行われる。<br>
コミュニティが作成したスキルを検索・インストール・公開できるプラットフォームとして機能し、急速な成長を続けている。<br>
<br>
下表に、TOOLS.mdとSKILL.mdの特徴比較を示す。<br>
<br>
<center>
{| class="wikitable"
|+ TOOLS.md と SKILL.mdの特徴比較
! 項目 !! TOOLS.md !! SKILL.md
|-
| 役割 || 環境固有のツール設定情報の記録 || エージェント能力の拡張定義
|-
| 形式 || Markdown || YAMLフロントマター + Markdown
|-
| 配置場所 || <u>~/.openclaw/workspace/TOOLS.md</u> || <u>~/.openclaw/workspace/skills/<スキル名>/SKILL.md</u>
|-
| 読込タイミング || セッション開始時 || スキル呼び出し時
|-
| 共有時のセキュリティ || 機密情報を露出させない設計 || ClawHubを通じた安全な配布
|}
</center>
<br>
公式Webサイトおよびドキュメントへのリンクを以下に示す。<br>
* [https://openclaw.ai/ 公式サイト]
* [https://github.com/openclaw/openclaw GitHub]
* [https://docs.openclaw.ai/ ドキュメント]
<br><br>

== TOOLS.md ==
<u>TOOLS.md</u> は、OpenClawワークスペースにおいて環境固有のツール関連情報を記録するローカルノートファイルである。<br>
スキルがツールを使用する時に参照する設定情報 (カメラの配置場所、SSH接続情報、音声合成の設定等) を、人間が読みやすいMarkdown形式で管理する。<br>
<br>
<u><u>TOOLS.md</u> の特徴として、スキルの更新時に設定が失われない点がある。</u><br>
スキルが更新されても <u>TOOLS.md</u> はワークスペースに残り続けるため、環境固有の設定を再入力する必要がない。<br>
<br>
また、スキルを他者と共有する際に <u>TOOLS.md</u> はワークスペースに留まるため、SSH接続情報やAPIキー等の機密情報が意図せず公開されるリスクを低減できる。<br>
<br>
OpenClawはModel Context Protocol (MCP) のネイティブサポートを統合しており (<code>@modelcontextprotocol/sdk@1.25.3</code>)、<br>
<u>openclaw.json</u> ファイルの <code>agents[].mcp.servers</code> セクションでMCPサーバを設定する。<br>
<br>
トランスポートは <code>stdio</code> (デフォルト) で、子プロセスでJSON-RPC 2.0通信を行う。<br>
<br>
環境変数は <code>${VAR_NAME}</code> 構文で参照可能である。<br>
<br><br>

==== 基本構造 ====
<u>TOOLS.md</u> の主なセクション構成を以下に示す。<br>
<br>
<center>
{| class="wikitable"
|+ TOOLS.mdのセクション一覧
! セクション !! 役割
|-
| <code>Cameras</code> || カメラ設備と位置情報を記述する。
|-
| <code>SSH</code> || ホストエイリアスと接続情報を記述する。
|-
| <code>TTS</code> || 音声合成エンジンや声・速度等の設定を記述する。
|-
| <code>Device Names</code> || デバイスのニックネームと対応するハードウェア情報を記述する。
|-
| <code>Environment-Specific Notes</code> || ローカル環境固有の注記を記述する。
|}
</center>
<br>
MCP設定の基本構文を以下に示す。<br>
<br>
 <syntaxhighlight lang="json">
 {
    "name": "server-id",
    "command": "npx",
    "args": ["@anthropic/mcp-server"],
    "env": {"API_KEY": "${ENV_VAR_NAME}"}
 }
 </syntaxhighlight>
<br>
==== 記述例 ====
<u>TOOLS.md</u> の記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="md">
 # TOOLS
 
 ## Cameras
 
 * 玄関カメラ: リビング正面入り口
 * 庭カメラ: 裏庭南側フェンス付近
 
 ## SSH
 
 * dev-server: 192.168.1.100 (ポート 22)
 * staging: staging.example.com (ポート 2222)
 
 ## TTS
 
 * エンジン: OpenAI TTS
 * 声: alloy
 * 速度: 1.0
 
 ## Device Names
 
 * リビングライト: Hue Bridge → "Living Room Main"
 * エアコン: SwitchBot → "AC Unit 1"
 
 ## Environment Notes
 
 * Node.js v20がインストール済み
 * Dockerデーモンはsystemdで管理
 </syntaxhighlight>
<br><br>

== SKILL.md ==
<u>SKILL.md</u> は、OpenClawエージェントの能力を拡張するスキルを定義するファイルである。<br>
YAMLフロントマターとMarkdown本文の組み合わせで記述する。<br>
<br>
YAMLフロントマターには、スキルの名前、説明、バージョン、依存関係、呼び出し制御等のメタデータを定義する。<br>
Markdown本文にはスキルのプロンプトや実行指示を記述する。<br>
<br>
下表に、ユーザ呼び出し制御に関する主なフィールドを示す。<br>
<br>
<center>
{| class="wikitable"
|+ ユーザ呼び出し制御に関する主なフィールド
|-
! フィールド !! 説明
|-
| <code>user-invocable</code> || スラッシュコマンドでスキルを呼び出し可能かどうかを制御する。<br>デフォルト: <code>true</code>
|-
| <code>disable-model-invocation</code> || モデルによるスキルの自動呼び出しを禁止するかどうかを制御する。<br>デフォルト: <code>false</code>
|}
</center>
<br>
==== YAMLフロントマター仕様 ====
下表に、YAMLフロントマターのコアフィールドを示す。<br>
<br>
<center>
{| class="wikitable"
|+ コアフィールド一覧
! フィールド !! 説明 !! 必須
|-
| <code>name</code> || スキル識別子 (小文字、ハイフン許可) || はい
|-
| <code>description</code> || スキルの説明文 || はい
|-
| <code>version</code> || セマンティックバージョン (例: <u>1.0.0</u>) || はい
|}
</center>
<br>
下表に、メタデータフィールド (<code>metadata.openclaw</code>) を示す。<br>
<br>
<center>
{| class="wikitable"
|+ metadata.openclaw フィールド一覧
! フィールド !! 説明
|-
| <code>requires.env</code> || 必須環境変数 (配列)
|-
| <code>requires.bins</code> || 必須CLIバイナリ (全て必須)
|-
| <code>requires.oneOf</code> || 複数バイナリ中いずれか1つが必須
|-
| <code>requires.configs</code> || 必須設定ファイルパス
|-
| <code>primaryEnv</code> || メイン認証環境変数
|-
| <code>builtIn</code> || スキルが常に有効か (<u>true</u> / <u>false</u>)
|-
| <code>emoji</code> || 有効化時のアイコン
|-
| <code>homepage</code> || スキルのホームページURL
|}
</center>
<br>
下表に、呼び出し制御フィールドを示す。<br>
<br>
<center>
{| class="wikitable"
|+ 呼び出し制御フィールド一覧
! フィールド !! 説明 !! デフォルト
|-
| <code>user-invocable</code> || スラッシュコマンドで呼び出し可能か || true
|-
| <code>disable-model-invocation</code> || モデルの自動呼び出しを禁止するか || false
|-
| <code>command-dispatch</code> || <code>tool</code> で直接ディスパッチ || -
|-
| <code>command-tool</code> || 送信先ツール名 || -
|-
| <code>command-arg-mode</code> || 引数モード || <code>raw</code>
|}
</center>
<br>
下表に、呼び出しパターンの比較を示す。<br>
<br>
<center>
{| class="wikitable"
|+ 呼び出しパターン比較
! パターン !! user-invocable !! disable-model-invocation !! 動作
|-
| 標準 || true || false || スラッシュコマンド + モデル自動呼び出し
|-
| ユーザ専用 || true || true || スラッシュコマンドのみ
|-
| 自動呼び出しのみ || false || false || モデルからのみ呼び出し
|-
| ツールディスパッチ || - || - || <code>command-dispatch: tool</code> で直接実行
|}
</center>
<br>
==== スキルの読込順序 ====
スキルは以下の優先度順で読み込まれる。<br>
同一名スキルが存在する場合、優先度順の最初のものが採用される。<br>
<br>
<center>
{| class="wikitable"
|+ スキルの優先度と配置場所
! 優先度 !! 種別 !! 配置場所
|-
| 1 (最高) || Workspaceスキル || <u><workspace>/skills/</u> ディレクトリ
|-
| 2 || Managed / Localスキル || <u>~/.openclaw/skills/</u> ディレクトリ
|-
| 3 || Bundledスキル || OpenClaw本体に付属
|-
| 4 || Extra Directories || <u>openclaw.json</u> ファイルで追加指定
|}
</center>
<br>
環境変数インジェクションの仕様を以下に示す。<br>
* <code>requires.env</code> に列挙した環境変数は、スキル実行時に自動注入される。
* 既存の変数は上書きしない。
* <code>primaryEnv</code> を設定した場合、<code>apiKey</code> が自動マッピングされる。
<br>
==== 記述例 ====
天気確認スキルの <u>SKILL.md</u> 記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="yaml">
 ---
 name: weather-check
 description: Check weather conditions for a given location
 version: 1.0.0
 metadata:
    openclaw:
       requires:
          env:
             - OPENWEATHER_API_KEY
          bins:
             - curl
       primaryEnv: OPENWEATHER_API_KEY
       emoji: 🌤️
       homepage: https://github.com/example/weather-skill
 user-invocable: true
 disable-model-invocation: false
 ---
 </syntaxhighlight>
<br>
 <syntaxhighlight lang="md">
 # Weather Check Skill
 
 指定された場所の天気情報を取得して報告する。
 
 ## 手順
 
 1. ユーザが指定した場所をパースする
 2. OpenWeather APIに問い合わせる
 3. 結果を分かりやすくフォーマットして返す
 </syntaxhighlight>
<br>
ツールディスパッチを使用するスキルの記述例を以下に示す。<br>
<br>
 <syntaxhighlight lang="yaml">
 ---
 name: file-search
 description: Search files in the workspace using a given query
 version: 1.0.0
 user-invocable: true
 disable-model-invocation: false
 command-dispatch: tool
 command-tool: search_files
 command-arg-mode: raw
 ---
 </syntaxhighlight>
<br>
==== ClawHub ====
ClawHubは、OpenClawの公式スキルレジストリである。<br>
コミュニティが作成したスキルを検索・インストール・公開できるプラットフォームとして機能する。<br>
<br>
ClawHubの統計情報 (2026年2月時点) を以下に示す。<br>
* 総スキル数: 5,700以上
* 成長速度: 1月中旬50件/日 → 2月初旬500件/日以上
<br>
セキュリティスキャンの仕様を以下に示す。<br>
* VirusTotalによる自動スキャンが全スキルに対して実施される。
* スキャンは毎日再実行される。
* Code Insightキャパビリティを使用して解析する。
<br>
下表に、スキャン結果による分類と処理を示す。<br>
<br>
<center>
{| class="wikitable"
|+ スキャン結果の分類
! 結果 !! 処理
|-
| Benign || 自動承認
|-
| Suspicious || 警告フラグ付きで公開
|-
| Malicious || ブロック
|}
</center>
<br>
コミュニティレポート機能として、3件以上のユーザ報告が集まったスキルは自動的に非表示化される。<br>
<br><br>

== 関連項目 ==
* [[OpenClawの設定 - ファイル構成]]
*: OpenClawワークスペースのファイル構成の概要
* [[OpenClawの設定 - AGENTS.md]]
*: エージェントの動作構造を定義するAGENTS.md
* [[OpenClawの設定 - SOUL.md]]
*: エージェントのパーソナリティと価値観を定義するSOUL.md
* [[OpenClawの設定 - IDENTITY.md]]
*: エージェントのアイデンティティを定義するIDENTITY.md
* [[OpenClawの設定 - USER.md]]
*: ユーザ固有の設定を定義するUSER.md
* [[OpenClawの設定 - メモリとタスク管理]]
*: メモリ管理システムとタスク管理の詳細
* [[OpenClawの設定 - 初期化とセキュリティ]]
*: 起動手順とセキュリティポリシーの詳細
* [https://docs.openclaw.ai/tools/skills スキルドキュメント (OpenClaw公式)]
* [https://clawhub.ai/ ClawHub (公式スキルレジストリ)]
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板,OpenClaw,TOOLS.md,SKILL.md,AI Agent,ツール定義,スキル拡張,MCP,Model Context Protocol,ClawHub,YAMLフロントマター,Markdown,設定ファイル
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]