メインコンテンツへスキップ

​
Skills の作成

Skills は、ツールをどのように、いつ使うかをエージェントに教えます。各 Skill は、 YAML frontmatter と Markdown の手順を含む SKILL.md ファイルを持つディレクトリです。 Skills がどのように読み込まれ、優先順位付けされるかについては、Skills を参照してください。

​
最初の Skill を作成する

1

Skill ディレクトリを作成する

Skills はワークスペース内に置かれます。新しいフォルダーを作成してください。
mkdir -p ~/.openclaw/workspace/skills/hello-world
2

SKILL.md を書く

そのディレクトリ内に SKILL.md を作成します。frontmatter でメタデータを定義し、 Markdown 本文にはエージェント向けの手順を書きます。
---
name: hello_world
description: A simple skill that says hello.
---

# Hello World Skill

When the user asks for a greeting, use the `echo` tool to say
"Hello from your custom skill!".
3

ツールを追加する（任意）

frontmatter 内でカスタムツールスキーマを定義することも、既存のシステムツール （exec や browser など）を使うようエージェントに指示することもできます。Skills は、 それらが説明するツールと一緒にプラグイン内で配布することもできます。
4

Skill を読み込む

OpenClaw が Skill を認識できるように、新しいセッションを開始します。
# From chat
/new

# Or restart the gateway
openclaw gateway restart
Skill が読み込まれたことを確認してください。
openclaw skills list
5

テストする

Skill を発動させるはずのメッセージを送信します。
openclaw agent --message "give me a greeting"
または、エージェントと普通にチャットして、あいさつを求めてもかまいません。

​
Skill メタデータのリファレンス

YAML frontmatter では、次のフィールドをサポートしています。
FieldRequiredDescription
nameYes一意の識別子（snake_case）
descriptionYesエージェントに表示される1行説明
metadata.openclaw.osNoOS フィルター（["darwin"], ["linux"] など）
metadata.openclaw.requires.binsNoPATH 上で必要なバイナリ
metadata.openclaw.requires.configNo必要な設定キー

​
ベストプラクティス

  • 簡潔にする — モデルに AI としてどう振る舞うかではなく、何をするかを指示してください
  • 安全第一 — Skill が exec を使う場合は、信頼できない入力から任意のコマンド注入が起きないよう、プロンプトに注意してください
  • ローカルでテストする — 共有する前に openclaw agent --message "..." でテストしてください
  • ClawHub を使う — ClawHub で Skills を閲覧・投稿できます

​
Skills の保存場所

LocationPrecedenceScope
\<workspace\>/skills/Highestエージェントごと
\<workspace\>/.agents/skills/Highワークスペースごとのエージェント
~/.agents/skills/Medium共有エージェントプロファイル
~/.openclaw/skills/Medium共有（すべてのエージェント）
Bundled (shipped with OpenClaw)Lowグローバル
skills.load.extraDirsLowestカスタム共有フォルダー

​
関連