OpenClawで自作のカスタムツール・スキルを追加する方法

「毎日同じようなSlack報告を手で書いている」「コードレビュー依頼のコメントをGitHubに投稿するのが地味に面倒くさい」「Jiraのチケット作成を後回しにしてしまう」——SES現場ではこういった小さな繰り返し作業が積み重なって、本来の開発に集中できない時間が生まれがちです。

OpenClawのスキルシステムを使えば、これらの定型作業を**「Slackに通知して」「レビュー依頼しておいて」と自然言語で話しかけるだけ**で実行できるカスタムツールとして登録できます。この記事では、スキルの仕組みから実践的なスキル作成まで、順を追って解説します。

OpenClawのスキルシステムとは

OpenClawは、Claude・GPT・Geminiなど複数のAIモデルを統合した自律型AIエージェントプラットフォームです。Node.js製であり、npm install -g openclaw でグローバルインストールして使います。

OpenClawの最大の特徴のひとつがスキルシステムです。スキルとは、OpenClawに追加する機能モジュールのことで、以下のような仕組みで動きます。

1. スキルは ~/.openclaw/skills/[スキル名]/ というディレクトリに配置する
2. そのディレクトリ内の SKILL.md がスキルの定義ファイル
3. SKILL.md に書かれた自然言語の「トリガー」にマッチする指示があると、OpenClawがそのスキルを自動で選択して実行する

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

スキルの配置場所と基本的なファイル構成は以下のとおりです。

~/.openclaw/skills/
├── slack-notifier/
│   ├── SKILL.md          # スキルの定義（必須）
│   └── notify.sh         # 実行スクリプト（オプション）
├── github-reviewer/
│   ├── SKILL.md
│   └── post-review.sh
├── jira-ticket/
│   ├── SKILL.md
│   └── create-ticket.sh
└── daily-report/
    ├── SKILL.md
    └── send-report.sh

最低限必要なのは SKILL.md だけです。シェルスクリプトや他のファイルはオプションですが、外部APIを呼び出す処理は別ファイルに書くと管理しやすくなります。

SKILL.mdの書き方

SKILL.mdはスキルの「仕様書」と「使い方マニュアル」を兼ねたファイルです。OpenClawはこのファイルを読み込んで、どんな指示に反応すべきか・何をすべきかを判断します。

基本形式

---
name: slack-notifier
description: Slackの指定チャンネルにメッセージを送信するスキル
version: 1.0.0
author: your-name
triggers:
  - "Slackに通知して"
  - "Slackで報告して"
  - "Slackに送って"
  - "Slack通知"
requires:
  env:
    - SLACK_WEBHOOK_URL
---

## 概要

Slack Incoming Webhook URLを使用して、指定チャンネルにメッセージを送信するスキルです。

## 設定

以下の環境変数を事前に設定してください。

```bash
export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK/URL"

使い方

自然言語で指示するだけで送信できます。

基本的な使い方

openclaw "プロジェクトAのデプロイが完了したことを#deployチャンネルに通知して"
openclaw "今日の作業完了をチームのSlackに報告して"

チャンネルを指定する場合

openclaw "#general に明日の定例は14時に変更となったことをSlackで連絡して"

実行方法

このスキルは以下のスクリプトを実行します。

bash ~/.openclaw/skills/slack-notifier/notify.sh "$message" "$channel"

注意事項

• Slack Incoming WebhookはSlackワークスペースの管理者が発行する必要があります
• チャンネル名は # を含む形式または含まない形式のどちらでも動作します

フロントマター（`---` で囲まれた部分）のフィールドの意味は以下のとおりです。

| フィールド | 説明 |
|---|---|
| `name` | スキルの識別子（英数字とハイフン） |
| `description` | スキルの概要（OpenClawがスキル選択時に参照） |
| `triggers` | このスキルを呼び出す自然言語キーワード |
| `requires.env` | 必要な環境変数（未設定時は警告を表示） |

## ステップバイステップ：Slack通知スキルを作成する

では実際に手を動かしてSlack通知スキルを作成しましょう。

### ステップ1：スキルディレクトリを作成する

```bash
mkdir -p ~/.openclaw/skills/slack-notifier

ステップ2：実行スクリプトを作成する

cat > ~/.openclaw/skills/slack-notifier/notify.sh << 'EOF'
#!/bin/bash
# Slack通知スクリプト
# 引数: $1 = メッセージ本文, $2 = チャンネル名（省略可能）

MESSAGE="${1:-テスト通知です}"
CHANNEL="${2:-#general}"
WEBHOOK_URL="${SLACK_WEBHOOK_URL}"

if [ -z "$WEBHOOK_URL" ]; then
  echo "Error: SLACK_WEBHOOK_URL が設定されていません" >&2
  exit 1
fi

# チャンネル名の # を除去して統一
CHANNEL="${CHANNEL/#/}"

PAYLOAD=$(cat <<JSON
{
  "channel": "#${CHANNEL}",
  "text": "${MESSAGE}",
  "username": "OpenClaw Bot",
  "icon_emoji": ":robot_face:"
}
JSON
)

RESPONSE=$(curl -s -o /dev/null -w "%{http_code}" \
  -X POST \
  -H "Content-Type: application/json" \
  -d "$PAYLOAD" \
  "$WEBHOOK_URL")

if [ "$RESPONSE" -eq 200 ]; then
  echo "Slack通知を送信しました（チャンネル: #${CHANNEL}）"
else
  echo "Error: Slack通知の送信に失敗しました（HTTPステータス: ${RESPONSE}）" >&2
  exit 1
fi
EOF
chmod +x ~/.openclaw/skills/slack-notifier/notify.sh

ステップ3：SKILL.mdを作成する

上記の「基本形式」セクションの内容を ~/.openclaw/skills/slack-notifier/SKILL.md として保存します。

ステップ4：スキルを登録して確認する

# スキルを登録
openclaw skill add slack-notifier

# 登録済みスキルの一覧を確認
openclaw skill list

NAME              VERSION   STATUS    DESCRIPTION
slack-notifier    1.0.0     active    Slackの指定チャンネルにメッセージを送信するスキル

ステップ5：動作をテストする

# 環境変数を設定
export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK/URL"

# スキル単体のテスト
openclaw skill test slack-notifier --message "テストメッセージです" --channel "general"

# 実際にOpenClawから使ってみる
openclaw "今日のデプロイが完了しました。バージョン2.3.0です。#deployチャンネルにSlack通知して"

実践スキル例2：GitHubにコードレビューコメントを投稿するスキル

~/.openclaw/skills/github-reviewer/
├── SKILL.md
└── post-review.sh

SKILL.md：

---
name: github-reviewer
description: 指定したGitHubのPull RequestにレビューコメントやApprovalを投稿するスキル
version: 1.0.0
triggers:
  - "GitHubにレビュー依頼"
  - "PRにコメントして"
  - "コードレビューを依頼して"
  - "PRをApproveして"
requires:
  env:
    - GITHUB_TOKEN
    - GITHUB_REPO
---

## 概要

GitHub APIを使用してPull Requestにコメントを投稿したり、Approvalを送信するスキルです。

## 設定

```bash
export GITHUB_TOKEN="ghp_your_token_here"
export GITHUB_REPO="org/repository"   # 例: mycompany/my-app

使い方

openclaw "PR #42 に『LGTM！マージしてOKです』とコメントして"
openclaw "PR #42 をApproveして"
openclaw "PR #42 に『このロジックですが、エッジケースの処理が抜けています』とレビューコメントして"

post-review.sh：

```bash
#!/bin/bash
# GitHub PR コメント投稿スクリプト
# 引数: $1 = PR番号, $2 = コメント本文, $3 = アクション (comment/approve)

PR_NUMBER="$1"
COMMENT="$2"
ACTION="${3:-comment}"

if [ -z "$GITHUB_TOKEN" ] || [ -z "$GITHUB_REPO" ]; then
  echo "Error: GITHUB_TOKEN または GITHUB_REPO が設定されていません" >&2
  exit 1
fi

API_BASE="https://api.github.com/repos/${GITHUB_REPO}"

if [ "$ACTION" = "approve" ]; then
  # Approvalを送信
  PAYLOAD=$(printf '{"event": "APPROVE", "body": "%s"}' "${COMMENT}")
  ENDPOINT="${API_BASE}/pulls/${PR_NUMBER}/reviews"
else
  # 通常コメントを送信
  PAYLOAD=$(printf '{"body": "%s"}' "${COMMENT}")
  ENDPOINT="${API_BASE}/issues/${PR_NUMBER}/comments"
fi

RESPONSE=$(curl -s -w "\n%{http_code}" \
  -X POST \
  -H "Authorization: Bearer ${GITHUB_TOKEN}" \
  -H "Accept: application/vnd.github.v3+json" \
  -H "Content-Type: application/json" \
  -d "$PAYLOAD" \
  "$ENDPOINT")

HTTP_CODE=$(echo "$RESPONSE" | tail -n1)

if [ "$HTTP_CODE" -eq 200 ] || [ "$HTTP_CODE" -eq 201 ]; then
  echo "GitHub PR #${PR_NUMBER} へのコメント投稿が完了しました"
else
  echo "Error: GitHubへの投稿に失敗しました（HTTPステータス: ${HTTP_CODE}）" >&2
  exit 1
fi

実践スキル例3：Jiraチケットを自動作成するスキル

~/.openclaw/skills/jira-ticket/
├── SKILL.md
└── create-ticket.sh

SKILL.md：

---
name: jira-ticket
description: Jiraに新しいタスクやバグチケットを作成するスキル
version: 1.0.0
triggers:
  - "Jiraにチケット作成"
  - "Jiraにタスクを登録"
  - "バグチケットを作って"
  - "Jiraに起票して"
requires:
  env:
    - JIRA_BASE_URL
    - JIRA_EMAIL
    - JIRA_API_TOKEN
    - JIRA_PROJECT_KEY
---

## 概要

Jira REST APIを使用して新しいチケット（Issue）を作成するスキルです。

## 設定

```bash
export JIRA_BASE_URL="https://yourcompany.atlassian.net"
export JIRA_EMAIL="[email protected]"
export JIRA_API_TOKEN="your_api_token"
export JIRA_PROJECT_KEY="PROJ"

使い方

openclaw "ログイン画面でパスワードリセットが効かないバグをJiraに起票して"
openclaw "来週のリリース用に決済フロー改善のタスクをJiraに作成して。優先度は高で"

<div class="balloon">
  <div class="balloon-avatar">👤</div>
  <div class="balloon-text">スクリプトを書くのが難しそうに見えますが、もっとシンプルにできますか？</div>
</div>
<div class="balloon balloon-right">
  <div class="balloon-avatar">🤖</div>
  <div class="balloon-text">SKILL.md だけで完結させることもできます。スクリプトなしで「OpenClaw自身にcurlコマンドを組み立てて実行させる」方式ならSKILL.mdに指示を書くだけでOKですよ。</div>
</div>

## スクリプトなしでSKILL.mdだけで完結させる方法

シェルスクリプトを書かなくても、SKILL.mdに詳細な指示を書くことでOpenClaw自身にツール実行を任せることができます。

```markdown
---
name: slack-notifier-simple
description: Slackの指定チャンネルにcurlでWebhook通知を送るスキル
version: 1.0.0
triggers:
  - "Slackに通知して"
  - "Slackで報告して"
requires:
  env:
    - SLACK_WEBHOOK_URL
---

## 実行手順

以下のcurlコマンドを使ってSlack通知を送信してください。

1. 環境変数 `SLACK_WEBHOOK_URL` からWebhook URLを取得する
2. ユーザーの指示からメッセージ本文とチャンネル名を抽出する
3. 以下のコマンドを実行する：

```bash
curl -s -X POST \
  -H "Content-Type: application/json" \
  -d "{\"text\": \"[メッセージ本文]\", \"channel\": \"[チャンネル名]\"}" \
  "$SLACK_WEBHOOK_URL"

4. HTTPステータスコードを確認して成功/失敗をユーザーに報告する

この方法のメリットは設定が非常にシンプルである点で、デメリットはOpenClawが毎回コマンドを解釈・組み立てするため、複雑な処理では精度が下がる場合があります。本番運用ではシェルスクリプトを使う方法を推奨します。

## スキルのデバッグ方法

スキルが期待通りに動かない場合のデバッグ手順です。

```bash
# スキルの詳細情報を確認
openclaw skill info slack-notifier

# デバッグモードで実行（どのスキルが選択されたかを表示）
openclaw --debug "Slackに通知して"

# スキルを直接指定して実行（スキル選択をバイパス）
openclaw --skill slack-notifier "テスト通知を#generalに送って"

# スキルの検証（SKILL.mdの構文チェック）
openclaw skill validate slack-notifier

デバッグモードでは以下のような情報が表示されます。

[DEBUG] User input: "Slackに通知して"
[DEBUG] Skill matching:
  - slack-notifier: score=0.95 (triggers: "Slackに通知して" matched)
  - github-reviewer: score=0.12
[DEBUG] Selected skill: slack-notifier
[DEBUG] Executing: notify.sh

SES現場での活用例

スキルの共有と再利用

作成したスキルはディレクトリをまるごとコピーするだけで別環境に展開できます。チームで共有する場合の方法をいくつか紹介します。

方法1：dotfilesリポジトリで管理する

# dotfilesリポジトリにスキルを追加
cp -r ~/.openclaw/skills/slack-notifier ~/dotfiles/.openclaw/skills/

# シンボリックリンクで管理
ln -s ~/dotfiles/.openclaw/skills ~/.openclaw/skills

方法2：tarballで共有する

# スキルをパッケージング
cd ~/.openclaw/skills
tar -czf slack-notifier-skill.tar.gz slack-notifier/

# 受け取り側でインストール
tar -xzf slack-notifier-skill.tar.gz -C ~/.openclaw/skills/
openclaw skill add slack-notifier

よくある質問（FAQ）

まとめ

OpenClawのスキルシステムを使うことで、SES現場での定型作業を自然言語の指示だけで自動化できます。

スキルの核心は「SKILL.mdを書くだけでAIが仕様を理解してくれる」点です。複雑なプラグイン開発や設定ファイルの記述は不要で、マークダウン形式の仕様書を置くだけで機能します。

今回作成したスキルのまとめ：

• slack-notifier：Slack Webhookを使ったチャンネル通知
• github-reviewer：GitHub PRへのコメント・Approval投稿
• jira-ticket：Jira REST APIを使ったチケット作成

これらをベースに、自分の現場特有の作業に合わせてカスタマイズしてみてください。スキルの数が増えるほど、OpenClawが「なんでもやってくれる頼れる同僚」になっていきます。

OpenClawのさらなる活用方法についてはOpenClaw完全攻略シリーズをご覧ください。AIツールを活用したSES現場でのキャリアアップについてはSESエンジニアのスキルアップロードマップ2026も参考にどうぞ。

Link1 Link2 Link3

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