最初のスキルを作る

Prerequisites

開始前に以下を確認してください：

• OpenClaw がインストール済みで起動している - 先に Getting Started チュートリアルを完了
• チャンネルを接続済み - Channel Setup チュートリアルを完了
• テキストエディタ - nano / VS Code など何でもOK
• ワークスペースへのアクセス - 既定の場所は ~/.openclaw

ファイルを書く前に、このスキルが何をするか整理します：

スキルの目的

ランダム名言スキルは次を行います：

• 名言/インスピレーション/モチベーションを求められたら応答する
• あらかじめ用意したリストからランダムに名言を返す
• 理解しやすくシンプルにしつつ、拡張できる構造にする

必要なツールは？

このスキルでは OpenClaw の組み込み機能だけを使います。外部 API は不要で、名言はスキルファイル内に保存します。学習用としてシンプルに保てます。

スキルはワークスペース内に保存されます。ディレクトリ構造を作りましょう：

mkdir -p ~/.openclaw/skills/random-quote

Directory structure: Skills are organized as ~/.openclaw/skills/<skill-name>/. The skill name should be lowercase with hyphens (kebab-case).

すべてのスキルには SKILL.md が必要です。これはスキルを定義する Markdown ファイルです。

手順 3.1: SKILL.md を作成

スキルディレクトリ内にスキルファイルを作成します：

touch ~/.openclaw/skills/random-quote/SKILL.md
# or open in your editor:
code ~/.openclaw/skills/random-quote/SKILL.md

手順 3.2: 内容を書く

SKILL.md を開いて次の内容を追加します：

# Random Quote Skill

## Description
Provides inspirational and motivational quotes when users ask for quotes, inspiration, or motivation. 
This skill demonstrates basic skill structure and can be extended with more quotes or API integration.

## Tools
This skill uses OpenClaw's built-in capabilities to select and return quotes. No external tools required.

## Instructions
When the user asks for:
- A quote
- Inspiration
- Motivation
- A random quote
- Something uplifting

Respond with a random quote from the following list, formatted nicely:

1. "The only way to do great work is to love what you do." - Steve Jobs
2. "Innovation distinguishes between a leader and a follower." - Steve Jobs
3. "Life is what happens to you while you're busy making other plans." - John Lennon
4. "The future belongs to those who believe in the beauty of their dreams." - Eleanor Roosevelt
5. "It is during our darkest moments that we must focus to see the light." - Aristotle
6. "The only impossible journey is the one you never begin." - Tony Robbins
7. "In the middle of difficulty lies opportunity." - Albert Einstein
8. "Success is not final, failure is not fatal: it is the courage to continue that counts." - Winston Churchill

Vary your responses and make them feel natural. You can add context or commentary to the quote if appropriate.

## Examples
- User: "Give me a quote"
  Response: "Here's an inspiring quote for you: 'The only way to do great work is to love what you do.' - Steve Jobs"

- User: "I need some motivation"
  Response: "Here's something to inspire you: 'The future belongs to those who believe in the beauty of their dreams.' - Eleanor Roosevelt"

- User: "Random quote please"
  Response: "Here's a quote: 'In the middle of difficulty lies opportunity.' - Albert Einstein"

内容を追加したら保存してください。

スキル構造を理解する

各セクションの役割を整理します：

• Description - スキルの概要（いつ使うべきかを OpenClaw が判断する材料）
• Tools - 使う能力（組み込みツールや外部 API など）
• Instructions - 使い方（トリガー、挙動、例）
• Examples - 期待する動作の具体例

次に、この新しいスキルを OpenClaw に認識させます。方法は 2 つあります：

方法 A: OpenClaw に頼む（最も簡単）

接続済みチャンネルから、OpenClaw にスキルの有効化を依頼します：

• 「random-quote スキルを有効化して」
• 「random-quote スキルを使って」
• 「random-quote を有効にして」

OpenClaw がスキルを自動検出し、有効化してくれます。

方法 B: 手動で設定

または、設定ファイルに追記します：

{
  "agent": {
    "model": "anthropic/claude-opus-4-5"
  },
  "skills": {
    "enabled": ["random-quote"]
  }
}

設定に追加したら、変更を反映するため Gateway を再起動してください。

スキルが動くかテストしましょう。

手順 5.1: テストメッセージを送る

接続済みチャンネル（Telegram、WhatsApp など）から、次のように聞いてみてください：

• 「名言ちょうだい」
• 「インスピレーションが欲しい」
• 「ランダム名言お願い」
• 「やる気を出させて」

手順 5.2: 応答を確認

OpenClaw がスキル内の名言を返せば成功です。おめでとうございます。スキルが動いています。

基本スキルが動いたら、次のように拡張できます：

• 1
  名言を増やすInstructions セクションの名言リストを拡張します。好きな著者やスピーカー、ソースから追加してください。
• 2
  カテゴリを追加するカテゴリ対応に拡張できます（例：「やる気が出る名言」「成功についての名言」）。Instructions セクションで分岐の扱いを追加します。
• 3
  外部 API と連携するさらに高度にするなら、名言 API を使ったり、Web から名言を取得するツールを追加したり、DB に保存したりできます。

トラブルシューティング

スキルが動かない

OpenClaw がスキルを使わない場合：

• ファイル位置を確認：SKILL.md が ~/.openclaw/skills/random-quote/SKILL.md にあること
• 有効化を確認：設定を確認するか、OpenClaw に有効なスキル一覧を出させる
• 形式を確認：Markdown と構造が正しいこと
• Gateway を再起動：新しいスキルの読み込みに再起動が必要な場合があります

スキルが起動しない

名言を求めてもスキルが起動しない場合：

• Instructions セクションを見直す（トリガーが明確か？）
• 「random-quote スキルを使って」のように明示的に依頼する
• Description に quote / inspiration などが書かれているか確認する

期待と違う応答になる

OpenClaw は返答するが名言にならない場合：

• Instructions をより具体的にする
• 例を増やして期待する挙動を明確化する
• スキル説明に目的が明確に書かれているか確認する

最初のスキル作成、おめでとうございます。次に試すこと：

高度なスキルパターン

基本が分かってきたら、次のパターンも試してください：

• API 連携 - 外部サービス/API と接続する
• ファイル操作 - システム上のファイルを読み書きする
• DB アクセス - データの保存と取得を行う
• 複雑なツール - 複数パラメータのカスタムツールを作る
• 条件分岐 - 状況に応じて挙動が変わるスキル

コミュニティが作った高度なスキル例は OpenClaw Hub のスキルレジストリで確認できます。