OpenClawスキル開発ガイド｜カスタムスキルの作り方と実践的な自動化レシピ

前回のEp.1では、OpenClawの基本的な使い方とエージェント構築を解説しました。

今回は一歩進んで、カスタムスキルの開発方法を詳しく解説します。OpenClawの真の力は「スキル」にあります。スキルを自作できるようになれば、AIエージェントの能力を自由に拡張し、あなたの業務に合わせた自動化が実現できます。

OpenClawスキルとは？基本構造を理解する

OpenClawのスキル（AgentSkill） は、エージェントに特定の能力を追加するモジュールです。たとえばGitHub連携、Web検索、画像生成といった機能が、それぞれ独立したスキルとして提供されています。

スキルのディレクトリ構造

skills/
└── my-custom-skill/
    ├── SKILL.md          # スキル定義（必須）
    ├── scripts/          # 実行スクリプト
    │   ├── main.py
    │   └── utils.sh
    └── templates/        # テンプレート（任意）
        └── report.md

スキルの核となるのはSKILL.mdです。このファイルがエージェントに「何ができるか」「どう使うか」を教えるマニュアルの役割を果たします。

スキルの仕組み

OpenClawのスキルは、従来のプラグインとは異なるアプローチを取っています。

つまりスキルとは、AIへの構造化されたプロンプト＋実行可能なスクリプトのセットです。コードを書かずにSKILL.mdだけでスキルを作ることも可能です。

SKILL.mdの書き方：フロントマターとボディ

フロントマター（メタデータ）

SKILL.mdの先頭にはYAMLフロントマターでメタデータを定義します。

---
name: daily-report
description: "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
metadata:
  openclaw:
    emoji: "📝"
    requires:
      bins: ["git"]
    primaryEnv: null
---

主要なフィールドは以下の通りです。

フィールド	説明	必須
name	スキルの一意な名前	✅
description	スキルの説明（エージェントが参照）	✅
metadata.openclaw.requires.bins	必要な外部コマンド	❌
metadata.openclaw.requires.env	必要な環境変数	❌
metadata.openclaw.primaryEnv	メインのAPI キー環境変数	❌
allowed-tools	スキルが使用するツール制限	❌

ボディ（使い方の指示）

フロントマター以降が、エージェントへの指示テキストです。ここに書いた内容をエージェントが読んで行動します。

# 日報自動生成

## 使い方
ユーザーが「日報を作成して」と言ったら、以下の手順で実行：

1. `git log --since="today 00:00" --oneline` でコミット一覧を取得
2. コミット内容をカテゴリ分け（機能追加・バグ修正・リファクタ等）
3. 以下のテンプレートで出力：

## テンプレート
### 本日の作業内容
- **機能追加**: ...
- **バグ修正**: ...
### 明日の予定
- （ユーザーに確認）

ポイントは、エージェントが迷わないよう具体的な手順とコマンドを記述することです。曖昧な指示はスキルの精度を下げます。

スクリプト連携：Python・シェルとの統合

SKILL.mdだけでは処理が複雑になる場合、スクリプトと連携します。

Pythonスクリプトの例

#!/usr/bin/env python3
"""Slack通知を送信するスクリプト"""
import argparse
import json
import urllib.request

def send_notification(webhook_url, message):
    data = json.dumps({"text": message}).encode()
    req = urllib.request.Request(
        webhook_url,
        data=data,
        headers={"Content-Type": "application/json"}
    )
    urllib.request.urlopen(req)

if __name__ == "__main__":
    parser = argparse.ArgumentParser()
    parser.add_argument("--webhook", required=True)
    parser.add_argument("--message", required=True)
    args = parser.parse_args()
    send_notification(args.webhook, args.message)
    print("通知を送信しました")

SKILL.mdからの参照：

# Slack通知

Slack Webhookで通知を送信する。

## 使い方
通知が必要な場合、以下のスクリプトを実行：

\```bash
python3 scripts/notify.py --webhook "$SLACK_WEBHOOK_URL" --message "通知内容"
\```

シェルスクリプトとの組み合わせ

既存のシェルスクリプトも活用できます。CI/CDパイプラインで使っているスクリプトをそのままスキルに組み込めるのが強みです。

#!/bin/bash
# scripts/health-check.sh
URL="${1:?URLを指定してください}"
STATUS=$(curl -s -o /dev/null -w "%{http_code}" "$URL")
if [ "$STATUS" -eq 200 ]; then
  echo "✅ $URL は正常です (HTTP $STATUS)"
else
  echo "⚠️ $URL に異常があります (HTTP $STATUS)"
  exit 1
fi

実践レシピ5選：すぐ使える自動化スキル

レシピ1：ブログ記事の自動投稿チェック

記事のMarkdownバリデーション・OGP確認・リンク切れチェックを自動化するスキルです。

---
name: blog-validator
description: "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
metadata:
  openclaw:
    emoji: "✍️"
    requires:
      bins: ["node"]
---

# ブログバリデーター

## トリガー
「記事をチェックして」「バリデーションして」

## 手順
1. 対象のMarkdownファイルのフロントマターを検証
2. 内部リンクの存在確認
3. 画像ファイルの存在確認
4. 文字数カウントと目安チェック（3,000字以上推奨）
5. 結果をサマリーで報告

レシピ2：サーバー監視と異常通知

定期的にヘルスチェックを行い、異常時にSlackへ通知するスキルです。Cron連携で真価を発揮します。

{
  "cron": [
    {
      "schedule": "*/5 * * * *",
      "task": "本番サーバーのヘルスチェックを実行して"
    }
  ]
}

レシピ3：PR自動レビュースキル

GitHub PRの差分を取得し、セキュリティ・パフォーマンス・コード品質の観点でレビューコメントを自動投稿します。

レシピ4：議事録の自動整理

Slackのスレッドやミーティングメモを取得し、決定事項・TODO・担当者を構造化して整理します。

レシピ5：定型メール下書き生成

クライアントへの報告メール、勤怠連絡などの定型メールをテンプレートから自動生成します。

ビルトインスキルの活用

OpenClawには多数のビルトインスキルが用意されています。自作する前に、まず既存スキルを確認しましょう。

# インストール済みスキルの一覧
openclaw skills list

SES現場での業務自動化活用例

SESエンジニアの現場では、プロジェクトごとに異なるツールや手順が求められます。スキルを自作することで、現場固有の業務を効率化できます。

現場入場時のオンボーディング自動化

新しい現場に入った際の環境構築手順をスキル化しておけば、セットアップ時間を大幅に短縮できます。

# オンボーディングスキル

## 手順
1. リポジトリのclone
2. 必要なツールのバージョン確認・インストール
3. 環境変数の設定ガイド表示
4. ローカル開発環境の起動確認

スキルシート更新の自動化

GitHubの活動履歴やプロジェクト経験から、スキルシートの更新を支援するスキルも作れます。直近のコミットログや使用技術を分析し、スキルシートに反映すべき項目を提案します。

クライアント報告書の自動生成

週次・月次の作業報告書を、Git履歴とタスク管理ツールのデータから自動生成するスキルを作れば、報告業務の時間を80%削減できます。

スキル開発のベストプラクティス

1. SKILL.mdは具体的に書く

エージェントが迷わないよう、実行コマンド・出力形式・エラーハンドリングを明記しましょう。

2. 冪等性を意識する

スキルの実行が何度繰り返されても同じ結果になるよう設計します。特にファイル操作やAPI呼び出しでは重要です。

3. エラー時の対処を定義する

## エラーハンドリング
- APIがタイムアウトした場合 → 3回までリトライ
- 認証エラーの場合 → ユーザーにAPIキーの確認を依頼
- 不明なエラーの場合 → エラーログを表示して停止

4. 小さく始めて段階的に拡張

最初は単機能のスキルから始め、運用しながら改善していくのが成功のコツです。

よくある質問（FAQ）

まとめ

OpenClawのスキル開発は、SKILL.md＋スクリプトというシンプルな構成で強力な自動化を実現します。

OpenClawの基本的な使い方は「OpenClaw使い方入門」、AIコーディングツール全般については「AIコーディングツール比較2026」、Claude Codeの活用法も参考にしてください。

Link1 Link2 Link3

ああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああああ