# OpenClaw Skillとは何か?初心者向け完全入門ガイド
ローカルで動くAIアシスタント「OpenClaw」をご存知でしょうか。普通のチャットAIと違い、お使いのマシン上で直接動作し、ファイル操作・スクリプト実行・外部サービスとの連携など「実際の作業」を任せられるツールです。そしてそのOpenClawを真に強力にしているのが、本記事のテーマである「**Skill(スキル)**」という仕組みです。
この記事では、「Skillって何?」「どうやって入れるの?」「自分でも作れるの?」といった疑問に、OpenClawをこれから始める方に向けて、ひとつずつ丁寧に答えていきます。読み終える頃には、ClawHubからスキルを入れて、AIエージェントに新しい能力を与えられるようになっているはずです。
---
## OpenClaw Skillとは何でしょうか?
ひとことで言うと、**Skillは「AIエージェントに特定の仕事のやり方を教えるためのMarkdownファイル」**です。
OpenClaw自体は汎用のAIエージェントで、文章を書いたりコードを生成したりといった一般的なタスクはこなせます。しかし、例えば「Gmailを操作してほしい」「天気予報を取得してほしい」「自分のObsidianノートに新しいエントリを追加してほしい」といった専門的な作業については、何もしないままだとうまくこなせません。
そこで登場するのがSkillです。Skillは1つのフォルダで、その中に `SKILL.md` というファイルが入っています。このファイルには、「いつこのSkillを使うべきか」「どんなコマンドを実行すべきか」「どうやって結果を返すか」といった指示が、自然言語(英語のMarkdown)で書かれています。
エージェントがあなたから何かを頼まれると、まずインストールされているSkillの説明文を眺めて、「あ、今頼まれた仕事はこのSkillでこなせそうだぞ」と判断します。マッチするSkillがあれば、その指示書を読んで、書かれている通りに作業を進めるのです。
つまりSkillは、AIエージェントに対する**「専門書のような外付け知識」**だと考えるとイメージしやすいでしょう。
### なぜMarkdownなのでしょうか?
「プログラムの実行ファイルでもなく、複雑な設定ファイルでもなく、なぜMarkdown?」と思われるかもしれません。理由は3つあります。
1つ目は**人間にも読みやすい**こと。何をやるSkillなのか、誰でもすぐ理解できます。2つ目は**書きやすい**こと。プログラミングの専門知識がなくても、英語(あるいは日本語)でやってほしいことを書けば、それがそのままSkillになります。3つ目は**AIモデルとの相性が良い**こと。LLMはまさにテキストを読んで理解するのが得意なので、Markdownでの指示書は無駄なく伝わります。
このシンプルさが、OpenClawエコシステムが急速に拡大している大きな理由です。2026年2月時点で、公式レジストリには13,000以上のSkillが公開されています。
---
## SKILL.mdの中身を覗いてみましょう
百聞は一見にしかずですので、実際のSkillがどんな構造をしているか見てみましょう。最もシンプルなSKILL.mdは以下のような形をしています。
```markdown
---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
---
# Image Lab Skill
When the user asks to generate or edit images, follow these steps:
1. Confirm the desired style and dimensions
2. Call the image generation API
3. Save the result to the workspace folder
4. Show the result path to the user
```
ファイル冒頭の `---` で囲まれた部分が**YAMLフロントマター**と呼ばれるメタデータ部分で、最低限**Skillの名前(`name`)**と**説明文(`description`)**が必須となります。この `description` がとても重要で、エージェントが「このSkillを使うべきか」を判断するときに参照する文章になります。
その下には、自然言語で書かれた指示書が続きます。これがSkill本体の内容です。「ユーザーが画像を生成または編集してほしいと頼んできたら、次の手順に従う」というように、人間が読んでも理解できる形で手順を記述します。
もう少し本格的なSkillになると、メタデータ部分に必要な依存関係なども追加されます。
```markdown
---
name: gemini
description: Use Gemini CLI for coding assistance and Google search lookups.
metadata:
{
"openclaw":
{
"emoji": "♊️",
"requires": { "bins": ["gemini"] },
"install":
[
{
"id": "brew",
"kind": "brew",
"formula": "gemini-cli",
"bins": ["gemini"],
"label": "Install Gemini CLI (brew)"
}
]
}
}
---
```
ここでは「このSkillを使うには `gemini` というコマンドが必要」「もし入っていなければHomebrew経由でインストールできる」といった情報が宣言されています。OpenClawは起動時にこのメタデータを読み取って、必要なコマンドが揃っているかをチェックし、揃っていないSkillは自動的に無効にしてくれます。
---
## Skillはどこに置かれるのでしょうか?
OpenClawは複数の場所からSkillを読み込みます。場所ごとに「優先順位」があり、同じ名前のSkillが複数の場所にあった場合、優先度の高いほうが採用される仕組みです。
優先順位は以下のようになっています。
| 優先 | 場所 | パス | 用途 |
|---|---|---|---|
| 1 (最強) | ワークスペースSkill | `/skills` | プロジェクト固有の自作Skill |
| 2 | プロジェクトエージェントSkill | `/.agents/skills` | プロジェクト内のエージェント専用 |
| 3 | 個人エージェントSkill | `~/.agents/skills` | あなたのマシン内全エージェントで共有 |
| 4 | 管理/ローカルSkill | `~/.openclaw/skills` | ClawHubからインストールしたものなど |
| 5 | バンドルSkill | OpenClaw本体に同梱 | 公式の標準Skill |
| 6 (最弱) | 追加ディレクトリ | 設定ファイルで指定 | プラグイン提供のSkillなど |
例えば同じ名前の `weather` というSkillがバンドルにもワークスペースにもあった場合、ワークスペースの方が勝つ、ということです。これによって、公式のSkillを上書きして自分用にカスタマイズすることも自由にできます。
---
## ClawHubからSkillをインストールしてみましょう
OpenClawの公式Skillレジストリは「**ClawHub**」と呼ばれます。ここに登録されているSkillは、コマンド1つで簡単にインストールできます。
### 基本のインストールコマンド
最も基本的なインストール方法は以下の通りです。
```bash
openclaw skills install
```
`` の部分にインストールしたいSkillの識別子を入れます。これで、現在のワークスペースの `skills/` フォルダにSkillがダウンロードされます。
すべてのエージェントで使いたい(マシン全体で共有したい)場合は、`--global` フラグを付けます。
```bash
openclaw skills install --global
```
こちらは `~/.openclaw/skills` にインストールされ、お使いのマシン上で起動するすべてのエージェントから利用可能になります。
### Skillの更新
インストール済みのSkillをアップデートしたい場合は、次のコマンドを使います。
```bash
# ワークスペースの全Skillをアップデート
openclaw skills update --all
# グローバルな1つのSkillをアップデート
openclaw skills update --global
# グローバルな全Skillをアップデート
openclaw skills update --all --global
```
### Skillの探し方
「どんなSkillがあるんだろう?」と探す場合は、ブラウザで [https://clawhub.ai](https://clawhub.ai) にアクセスするのが最も視覚的でわかりやすいです。カテゴリやキーワードで絞り込みができますし、各Skillのページにインストール数やレビュー、セキュリティスキャン結果なども表示されています。
ターミナルから検索したい場合は `clawhub` というCLIツールが別途用意されています。
```bash
clawhub search "web scraping"
```
---
## 初心者におすすめのSkill
ClawHubには膨大な数のSkillがありますが、最初に試すのに向いている定番Skillをいくつかご紹介します。
### Weather (天気予報)
OpenClaw本体にバンドルされている標準Skillです。インストール作業は不要で、すぐに使えます。`wttr.in` という外部サービスから天気情報を取得してくれるシンプルなものですが、「明日の東京の天気を教えて」と頼むと当たり前のように答えてくれる、最初の感動体験にはちょうど良いSkillです。
### GOG (Google Workspace連携)
ClawHubで最もダウンロードされているSkillの1つで、Gmail、カレンダー、Drive、Contacts、Sheets、Docsへのアクセスをまとめて提供してくれます。OAuth認証の設定が少し手間ですが、一度設定してしまえば「今日のカレンダーを見せて」「未読メールに優先度を付けて要約して」といった指示が通るようになります。日々の業務時短に直結する強力なSkillです。
### Tavily (検索)
通常のWeb検索とは違い、AIエージェント向けに最適化された検索エンジンを使うSkillです。OpenClawがローカルメモリの範囲を超えて、最新の情報を取りに行く必要があるときに非常に有用です。
### Obsidian
知識管理ツールObsidianのVaultをOpenClawから操作するためのSkillです。Markdownノートの作成、更新、整理などができるようになります。第二の脳としてObsidianを使っている方にはたまらないSkillでしょう。
### Summarize (要約)
長い記事や議事録、研究論文などを構造化された要約にまとめてくれるSkillです。シンプルですが、知的作業の毎日に確実に効きます。
---
## SkillとPluginの違いは何でしょうか?
OpenClawには「Plugin(プラグイン)」という似たような仕組みも存在します。最初はこの2つの違いに戸惑うかもしれません。
ざっくり整理すると次のようになります。
**Plugin**は、OpenClawに**新しいツールそのもの**を追加します。例えば「ブラウザを操作する」「メモリを長期保存する」といった、これまでできなかった能力を加える仕組みです。Pluginは実行コードを含む本格的なソフトウェア拡張です。
**Skill**は、すでに存在するツールを**どう使うかの指示書**です。例えば「ブラウザPluginを使って、こういう手順でこういう作業をする」という具体的な使い方を、エージェントに教える役割を担います。
両者は補完的な関係にあります。実際、Pluginは自分専用のSkillを同梱して配布できる仕組みになっており、Pluginをインストールすると、それに付随したSkillも一緒にロードされるようになっています。例えば、ブラウザを操作するPluginには `browser-automation` というSkillが同梱されていて、ブラウザの細かい操作手順がそのSkillに書かれている、といった具合です。
---
## 自分でSkillを作ってみましょう
Skillの素晴らしいところは、**誰でも簡単に作れる**ことです。プログラムを書く必要すらありません。
### 最小構成のSkillを作る
例えば「テキストを校正する」Skillを作ってみるとしましょう。
まず、ワークスペースの `skills/` フォルダの中に、Skill名と同じ名前のフォルダを作ります。
```bash
mkdir -p ./skills/proofreader
```
その中に `SKILL.md` を作成します。
```markdown
---
name: proofreader
description: Proofread Japanese text for typos, grammar issues, and clarity.
---
# Proofreader Skill
When the user asks to proofread or improve Japanese text, follow these steps:
1. Read the entire text the user provided
2. Identify any of the following issues:
- Typos (誤字脱字)
- Grammar mistakes
- Unclear sentences
- Redundant expressions
3. Present a corrected version of the text
4. List the changes you made with brief explanations
5. Keep the original tone and style intact
```
これだけで、もうSkillとして機能します。OpenClawを再起動すれば、`proofreader` Skillが認識され、ユーザーが「この文章を校正して」と頼むと自動で使われるようになります。
### 自作Skillのコツ
良いSkillを書くには、いくつかコツがあります。
1つ目は、**`description` を具体的に書く**ことです。エージェントはこの説明文を見て「このSkillを使うかどうか」を判断します。「テキストを処理するSkill」のような曖昧な記述だと、いつ使われるべきかわかりません。「日本語テキストの誤字脱字・文法・明瞭性を校正するSkill」のように、対象と目的を明確に書きましょう。
2つ目は、**手順を番号付きリストにする**ことです。エージェントは指示書を順番に解釈します。順番が明確なほど、期待通りの動作をしてくれます。
3つ目は、**例外や境界を明示する**ことです。例えば「日本語以外のテキストが来た場合は、ユーザーに確認してから処理する」といったルールを明記しておくと、想定外の入力でも適切に振る舞ってくれます。
4つ目は、**短く書く**ことです。Skillの内容はエージェントのプロンプトに毎回挿入されるので、長すぎるとトークンコストが膨らみます。実は、OpenClawはSkill1つあたり約24トークン+説明文の長さ分だけプロンプトを消費する仕組みになっています。簡潔さは美徳です。
---
## セキュリティ上の重要な注意点
便利な反面、**Skillはサードパーティのコードのようなもの**だと考えてください。レジストリにあるからといって、すべてが安全とは限らない、というのが正直なところです。
実際、2026年2月には「ClawHavoc」と呼ばれる攻撃キャンペーンが発生し、何百もの悪意あるSkillがClawHubに紛れ込みました。`clawhub` を `claw__d__hub` のように一文字だけ変えた**タイポスクワッティング**(似た名前で正規ツールに偽装する手法)が使われ、SSHキーやAPIトークンを盗み出すコードを含んでいました。
ClawHubは現在、すべてのSkillに対して以下のセキュリティチェックを通すようになっています。
- VirusTotalによるウイルススキャン
- ClawScanによる独自のコード分析
- 静的解析ツールによるコードチェック
各Skillのページに、これらの検査結果が表示されますので、**インストール前に必ず確認する習慣**を付けてください。スキャンで「critical(重大)」な問題が検出されたSkillは、デフォルトでインストールがブロックされる仕組みになっていますが、いずれにせよ自分の目でも確認するのが大切です。
加えて、以下のような対策も心がけてください。
- インストール前に**SKILL.mdの中身を読む**(短いので簡単に読めます)
- 知らない作者のSkillは特に慎重に確認する
- 怪しいSkillは**サンドボックス環境**で先に試す
- APIキーや認証情報は**コードや設定ファイルに直書きしない**
公式ドキュメントにも明記されている通り、「**Treat third-party skills as untrusted code(サードパーティのSkillは信頼できないコードとして扱え)**」が鉄則です。
---
## トラブルシューティング
「インストールしたのにSkillが認識されない」という場面はよくあります。いくつか確認ポイントがあります。
### 必要なバイナリが入っているか確認
Skillに `requires.bins` が指定されていると、そのコマンドがPATH上に存在しないとSkillはロードされません。
```bash
# 一覧で確認
openclaw skills list --eligible
# 個別の詳細を確認
openclaw skills info
```
`--eligible` フラグは「実際に使える状態にあるSkillだけ」を表示してくれるので、何が抜けているかがわかります。
### PATHのズレに注意
ありがちな落とし穴として、ターミナル上では存在するコマンドが、OpenClawのGatewayプロセスからは見えていない、というケースがあります。例えばHomebrewで入れたコマンドがGatewayプロセスのPATHに含まれていない、といった状況です。
この場合は以下のコマンドで修復を試みてください。
```bash
openclaw doctor --repair
```
これで治らない場合は、`launchd` のplistファイルを直接編集してPATHを設定する必要があります。
### Skillの設定を確認
`~/.openclaw/openclaw.json` の `skills.entries` セクションで、特定のSkillが `enabled: false` になっていないか確認しましょう。インストールはされているのに、設定で無効化されているケースは意外と多いです。
---
## 高度な使い方
最後に、もう少し慣れてきた方向けに、覚えておくと便利な機能をいくつかご紹介します。
### スラッシュコマンドとして呼び出す
Skillのフロントマターに `user-invocable: true` を指定すると、`/skill-name` のようなスラッシュコマンドで明示的にSkillを呼び出せるようになります。エージェントの自動判断に任せず、確実にそのSkillを使いたい場合に便利です。
### エージェントごとのアクセス制御
複数エージェントを運用している場合、各エージェントに「どのSkillを使えるか」を制限できます。設定ファイルで以下のように書きます。
```javascript
{
agents: {
defaults: {
skills: ["github", "weather"], // デフォルト許可
},
list: [
{ id: "writer" }, // デフォルトを継承
{ id: "docs", skills: ["docs-search"] }, // 完全に上書き
{ id: "locked-down", skills: [] }, // Skill使用禁止
],
},
}
```
これにより、「校正用のエージェントには校正Skillだけ」「公開デモ用のエージェントには制限したSkillだけ」といった細かい制御が可能になります。
### Skill Workshop
OpenClawの実験的なPluginに「**Skill Workshop**」というものがあります。これは、エージェントが日々の作業中に見つけた「再利用できそうな手順」を自動的にSkillとして提案・作成してくれる機能です。例えば、「次回からは添付画像の出典を必ず確認する」といったルールを、エージェントとの対話の中から自動的にSkill化してくれます。
デフォルトでは無効になっているので、使ってみたい場合は明示的に有効化が必要です。
---
## まとめ
OpenClaw Skillは、AIエージェントに専門的な仕事のやり方を教える、シンプルかつ強力な仕組みです。中身はただのMarkdownファイルなので、誰でも作れますし、誰でも読めます。
この記事の要点を振り返ると以下のようになります。
- Skillは `SKILL.md` というMarkdownファイル1枚で構成される、AIエージェント用の指示書である
- ClawHubから `openclaw skills install ` でインストールできる
- 自分で書く場合は、ワークスペースの `skills/` フォルダにフォルダを作ってSKILL.mdを置くだけで完成する
- Plugin(新しいツールを追加する仕組み)とは別物で、補完関係にある
- セキュリティスキャンを必ず確認し、サードパーティSkillは信頼できないコードとして扱う
- 自作のコツは、説明文を具体的に・手順を番号付きで・短く書くこと
最初の一歩としては、まずバンドルされている `weather` Skillを試してみて、次にClawHubから興味のあるSkillを1〜2個インストールしてみるのがおすすめです。慣れてきたら、ぜひご自分の日常業務に合わせた自作Skillにチャレンジしてみてください。
「自分のワークフローに完璧にフィットしたAIエージェント」を作り上げる楽しさは、Skillを書き始めて初めてわかる醍醐味です。あなたのOpenClawが、世界に1つだけの相棒に進化していく過程を、ぜひ楽しんでみてください。
---
## 参考リンク
- OpenClaw公式ドキュメント (Skills): https://docs.openclaw.ai/tools/skills
- ClawHub (公式Skillレジストリ): https://clawhub.ai
- AgentSkills仕様: https://agentskills.io
- awesome-openclaw-skills (キュレーション済みSkillリスト): https://github.com/VoltAgent/awesome-openclaw-skills
