前のページ

06. OpenClaw Skills スキルシステム詳解

Skills は OpenClaw の拡張能力の中核です。コミュニティが 5700 以上のスキルパッケージを提供しています。本稿では Skills の概念、インストール方法、ClawHub の使い方、スキル分類、設定管理、そして AI アシスタントの能力を強化する適切なスキルの選び方と使い方を詳しく解説します。

OpenClaw v2026.2 対応 | 本稿は基本インストールが完了しており、AI アシスタントの能力を拡張したい方を対象としています。

TL;DR: Skills は事前パッケージ化された能力拡張です。openclaw skill install <name> でインストールし、ディレクトリは ~/.openclaw/workspace/skills/ です。ClawHub には 5700 以上のコミュニティスキルがあります:コーディングアシスタント、検索・リサーチ、開発・運用、Web オートメーションなど。各スキルには SKILL.md(説明・トリガーワード・指示)、オプションのツール実装が含まれます。セキュリティスキャンは VirusTotal で検証されます。

Skills とは?

概念の説明

Skills は事前パッケージ化された能力拡張モジュールで、以下を含みます:

構成要素 説明
SKILL.md スキル定義ファイル。説明、トリガーワード、指示、例を含む
Tools 呼び出し可能なツール関数(オプション)
Resources 関連リソースファイル(オプション)
Package.json 依存関係の宣言(オプション)

Skills vs Tools

特性 Skills Tools
ソース コミュニティ貢献 組み込み/カスタム
インストール インストールが必要 デフォルトで利用可能
複雑さ 複雑なものも可能 通常はシンプル
共有 可能 通常は共有しない
更新 独立して更新 システムと一緒に更新

スキル分類

ClawHub のスキルはカテゴリ別に整理されています:

カテゴリ 数量 代表スキル
コーディングアシスタント 133+ coding-agent, debug-pro, tdd-guide
検索・リサーチ 253+ web-search, deepwiki, exa-search
開発・運用 212+ docker-essentials, git-workflows
Web オートメーション 139+ browser-control, puppeteer-skill
生産性ツール 135+ calendar-skill, task-manager
データ分析 46+ data-analyzer, budget-variance
スマートホーム 56+ home-assistant, smart-home-io
PDF ドキュメント 67+ pdf-reader, doc-summarizer
画像・動画 60+ image-gen, video-editor
ノート・ナレッジ 100+ obsidian, notion-sync

Skills のインストール方法

方法1:ClawHub CLI(推奨)

# スキルを検索
openclaw skill search gmail

# スキルをインストール
openclaw skill install gmail

# 指定バージョンをインストール
openclaw skill install [email protected]

# GitHub からインストール
openclaw skill install github:user/skill-repo

# ローカルパスからインストール
openclaw skill install ./my-skill

方法2:手動インストール

# スキルリポジトリをクローン
git clone https://github.com/user/skill-repo.git

# スキルディレクトリにコピー
cp -r skill-repo ~/.openclaw/workspace/skills/skill-name

方法3:GitHub リンクを貼り付け

チャットで直接スキルの GitHub リンクを送信すると、Agent が自動認識してインストールします:

このスキルをインストールしてください:https://github.com/user/skill-repo

スキルディレクトリ構造

~/.openclaw/workspace/skills/
├── gmail/
│   └── SKILL.md
├── calendar/
│   └── SKILL.md
├── web-search/
│   ├── SKILL.md
│   └── package.json
└── my-custom-skill/
    ├── SKILL.md
    ├── src/
    │   └── index.js
    └── package.json

ClawHub 使用ガイド

ClawHub へのアクセス

clawhub.com にアクセスして、利用可能なすべてのスキルを閲覧できます。

スキルの検索

# CLI 検索
openclaw skill search <キーワード>

# 例
openclaw skill search email
openclaw skill search calendar
openclaw skill search home assistant

スキル詳細

各スキルページには以下が含まれます:

情報 説明
名前と説明 スキルの機能説明
作者 スキル開発者
バージョン 現在のバージョン番号
ダウンロード数 インストール回数
依存関係 必要な他のスキルやパッケージ
SKILL.md プレビュー スキル定義ファイル
セキュリティスキャン VirusTotal スキャン結果

セキュリティスキャン

ClawHub は VirusTotal と連携し、各スキルをセキュリティスキャンします:

# スキルのセキュリティ状態を確認
openclaw skill info gmail --security

# 出力例:
# Skill: gmail
# Security Status: ✅ Verified
# VirusTotal Scan: Clean (0/72)
# Last Updated: 2026-02-20

インストール前チェック

# スキルの依存関係を確認
openclaw skill check gmail

# 出力例:
# Skill: gmail
# Dependencies:
#   - google-auth: required ✓
#   - google-apis: required ✓
# Conflicts: None
# Recommendations:
#   - Consider also installing: calendar

スキル設定

設定ファイルの場所

~/.openclaw/workspace/skills/<skill-name>/SKILL.md

SKILL.md 構造の詳細

---
name: gmail
version: 1.2.0
author: community
description: Send and read Gmail messages through OpenClaw
triggers:
  - email
  - gmail
  - mail
  - send email
  - read email
dependencies:
  - google-auth
tools:
  - gmail_list
  - gmail_send
  - gmail_read
---

# Gmail Skill

Manage your Gmail account through OpenClaw.

## Features

- List recent emails
- Send new emails
- Read specific emails
- Search emails
- Manage labels

## Setup

1. Enable Gmail API in Google Cloud Console
2. Create OAuth credentials
3. Run `openclaw skill config gmail` to authenticate

## Usage Examples

### List emails
User: "Check my recent emails"
Action: Use gmail_list tool with default parameters

### Send email
User: "Send an email to [email protected]"
Action: 
1. Ask for subject and body
2. Use gmail_send tool

### Search emails
User: "Search for emails from github"
Action: Use gmail_list tool with query parameter

## Configuration

Set the following environment variables:
- GOOGLE_CLIENT_ID
- GOOGLE_CLIENT_SECRET
- GOOGLE_REDIRECT_URI

Or configure in ~/.openclaw/workspace/skills/gmail/config.json

スキル設定ファイル

一部のスキルには追加設定が必要です:

# スキルを設定
openclaw skill config gmail

# または手動で設定ファイルを編集
vi ~/.openclaw/workspace/skills/gmail/config.json

設定例:

{
  "clientId": "your-client-id",
  "clientSecret": "your-client-secret",
  "redirectUri": "http://localhost:18789/callback",
  "scopes": [
    "https://www.googleapis.com/auth/gmail.readonly",
    "https://www.googleapis.com/auth/gmail.send"
  ]
}

スキル環境変数

# スキル環境変数を設定
export GMAIL_CLIENT_ID="your-client-id"
export GMAIL_CLIENT_SECRET="your-client-secret"

# または .env ファイルに
echo "GMAIL_CLIENT_ID=your-client-id" >> ~/.openclaw/.env

スキル管理

インストール済みスキルの確認

# すべてのスキルを一覧表示
openclaw skill list

# 出力例:
# Name           Version   Status    Last Updated
# gmail          1.2.0     active    2026-02-20
# calendar       2.0.1     active    2026-02-18
# web-search     1.0.0     active    2026-02-15
# home-assistant 0.5.0    disabled  2026-02-10

スキルの有効化/無効化

# スキルを無効化
openclaw skill disable home-assistant

# スキルを有効化
openclaw skill enable home-assistant

スキルの更新

# 単一スキルを更新
openclaw skill update gmail

# すべてのスキルを更新
openclaw skill update --all

# 更新可能なものを確認
openclaw skill outdated

スキルのアンインストール

# スキルをアンインストール
openclaw skill uninstall gmail

# アンインストールして設定をクリーンアップ
openclaw skill uninstall gmail --purge

スキル診断

# スキルの問題を診断
openclaw skill diagnose gmail

# 出力例:
# ✓ SKILL.md valid
# ✓ Dependencies installed
# ✓ Configuration complete
# ✓ Authentication working
# ✗ API quota exceeded (2/100 used today)

おすすめスキル

プログラミング・開発

スキル名 機能 インストールコマンド
coding-agent Claude Code、Codex などを実行 openclaw skill install coding-agent
debug-pro 体系的なデバッグ手法 openclaw skill install debug-pro
tdd-guide テスト駆動開発 openclaw skill install tdd-guide
git-workflows Git ワークフロー openclaw skill install git-workflows
docker-essentials Docker 基礎 openclaw skill install docker-essentials

生産性

スキル名 機能 インストールコマンド
gmail Gmail 管理 openclaw skill install gmail
calendar カレンダー管理 openclaw skill install calendar
task-manager タスク管理 openclaw skill install task-manager
notion-sync Notion 同期 openclaw skill install notion-sync
obsidian Obsidian ノート openclaw skill install obsidian

検索・リサーチ

スキル名 機能 インストールコマンド
web-search Web 検索 openclaw skill install web-search
deepwiki Wiki 検索 openclaw skill install deepwiki
exa-search AI 検索 openclaw skill install exa-search
research-paper 論文検索 openclaw skill install research-paper

スマートホーム

スキル名 機能 インストールコマンド
home-assistant Home Assistant 制御 openclaw skill install home-assistant
smart-home-io スマートホームデバイス openclaw skill install smart-home-io
philips-hue フィリップス Hue openclaw skill install philips-hue

スキル開発の基礎

新規スキルの作成

# スキルテンプレートを作成
openclaw skill create my-skill

# 生成されるディレクトリ構造
my-skill/
├── SKILL.md
├── config.json.example
└── README.md

SKILL.md テンプレート

---
name: my-skill
version: 1.0.0
author: your-name
description: Brief description of what this skill does
triggers:
  - trigger-word-1
  - trigger-word-2
dependencies: []
tools: []
---

# My Skill

Detailed description of the skill.

## Features

- Feature 1
- Feature 2
- Feature 3

## Setup

1. Step 1
2. Step 2
3. Step 3

## Usage Examples

### Example 1
User: "..."
Action: ...

### Example 2
User: "..."
Action: ...

## Configuration

Required configuration and environment variables.

## Notes

Any additional notes or warnings.

ツール定義の追加

## Tools

This skill provides the following tools:

### my_tool_name

Description of what this tool does.

Parameters:
- `param1` (string, required): Description
- `param2` (number, optional): Description, default: 0

Returns:
- Result description

Example usage:
User: "..."
Action: Use my_tool_name with param1="value"

スキルの公開

# スキルを検証
openclaw skill validate my-skill

# ClawHub に公開
openclaw skill publish my-skill

# または GitHub にプッシュ
git add .
git commit -m "Initial skill release"
git push origin main

スキルセキュリティ

セキュリティベストプラクティス

推奨事項 説明
ソースの確認 信頼できるソースのスキルのみインストール
権限の確認 スキルが必要とする権限を把握
コードの確認 SKILL.md と実装コードを確認
隔離テスト まずテスト環境で新スキルを使用
定期的な更新 スキルを最新バージョンに保つ

スキル権限

# スキルの権限を確認
openclaw skill permissions gmail

# 出力例:
# Skill: gmail
# Permissions:
#   - network:outbound (gmail.googleapis.com)
#   - filesystem:read (credential files)
#   - filesystem:write (token cache)
# Risk Level: Medium

スキル権限の制限

{
  "skills": {
    "gmail": {
      "permissions": {
        "network": {
          "allow": ["gmail.googleapis.com", "oauth2.googleapis.com"],
          "deny": ["*"]
        },
        "filesystem": {
          "allow": ["~/.openclaw/workspace/skills/gmail/"],
          "deny": ["*"]
        }
      }
    }
  }
}

スキル競合の解決

よくある競合

競合タイプ 説明 解決策
トリガーワードの重複 複数スキルが同じキーワードに反応 トリガーワードを明確にするか、競合スキルを無効化
依存関係の競合 異なるスキルが異なるバージョンの依存関係を必要とする 隔離環境を使用
権限の競合 スキルが同じ権限を必要とする 必要性を確認

競合の解決

# スキル競合を確認
openclaw skill conflicts

# 出力例:
# Conflict: email trigger
#   - gmail
#   - outlook
# Resolution: Specify skill name or adjust priorities

# スキルの優先度を設定
openclaw skill priority gmail 10
openclaw skill priority outlook 5

隔離環境

依存関係の競合があるスキルには、隔離環境を使用できます:

{
  "skills": {
    "isolatedSkills": ["gmail", "outlook"],
    "isolationMode": "per-skill"
  }
}

トラブルシューティング

スキルが動作しない

# スキルの状態を確認
openclaw skill list --status

# スキルの読み込みを確認
openclaw skill load gmail --verbose

# スキルログを確認
openclaw logs --filter skill:gmail

認証失敗

# 再認証
openclaw skill auth gmail --reauth

# 認証状態を確認
openclaw skill auth gmail --status

依存関係の問題

# 依存関係を確認
openclaw skill deps gmail

# 依存関係をインストール
openclaw skill deps gmail --install

# 依存関係を更新
openclaw skill deps gmail --update

スキル読み込みエラー

# SKILL.md の構文を検証
openclaw skill validate gmail

# 出力例:
# ✗ Error: Invalid frontmatter
#   Line 5: Unknown field 'invalid-field'
# ✗ Error: Missing required field 'name'

まとめ

Skills システムは OpenClaw の拡張能力の中核です:

  • 豊富なエコシステム:5700 以上のコミュニティスキルが様々なシナリオをカバー
  • シンプルなインストール:1 行のコマンドでインストール可能
  • 柔軟な設定:カスタマイズとオーバーライドをサポート
  • 安全で制御可能:権限管理とセキュリティスキャン

適切なスキルの選択と設定により、AI アシスタントに無限の能力拡張が可能になります。


本稿のまとめ

  • Skills の概念と構造を理解した
  • 複数のインストール・管理方法を習得した
  • ClawHub でスキルを発見・評価する方法を学んだ
  • スキルセキュリティと権限管理を理解した
  • スキル開発の基礎知識を習得した

更新履歴

  • 2026-02-26:初版リリース、OpenClaw v2026.2 ベース

シリーズナビゲーション