Skills の作成

Skills は、ツールをいつ、どのように使用するかをエージェントに教えます。各 Skill は、YAML フロントマターと Markdown の手順を記述した SKILL.md ファイルを含むディレクトリです。 OpenClaw は、定義された優先順位に従って複数のルートから Skills を読み込みます。

最初の Skill を作成する

mkdir -p ~/.openclaw/workspace/skills/hello-world

mkdir -p ~/.openclaw/workspace/skills/personal/hello-world# Skill 名は引き続き「hello-world」で、/hello-world として呼び出す

---name: hello-worlddescription: 挨拶を出力するシンプルな Skill。--- # Hello World ユーザーが挨拶を求めたら、`exec` ツールを使用して次を実行します。 ```bashecho "カスタム Skill からこんにちは！"

 命名規則:- `name` には小文字、数字、ハイフンを使用します。- ディレクトリ名とフロントマターの `name` を一致させます。- `description` はエージェントとスラッシュコマンドの検出結果に表示されます。  1 行かつ 160 文字未満にします。 </Step> <Step title="Skill が読み込まれたことを確認する">```bashopenclaw skills list

# チャットから — 現在のセッションをアーカイブして新しく開始/new # または Gateway を再起動openclaw gateway restart

openclaw agent --message "挨拶して"

SKILL.md リファレンス

必須フィールド

任意のフロントマターキー

ゲーティングフィールド（requires.bins、requires.env など）については、 Skills — ゲーティングを参照してください。

{baseDir} の使用

パスをハードコードせずに Skill ディレクトリ内のファイルを参照できます。エージェントは {baseDir} を Skill 自身のディレクトリを基準に解決します。

`{baseDir}/scripts/run.sh` にあるヘルパースクリプトを実行します。

条件付き有効化を追加する

依存関係が利用できる場合にのみ読み込まれるよう、Skill にゲートを設定します。

---name: gemini-searchdescription: Gemini CLI を使用して検索する。metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } }---

{  skills: {    entries: {      "gemini-search": {        enabled: true,        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" },      },    },  },}

Skill Workshop を介して提案する

エージェントが作成した Skills や、Skill を稼働させる前にオペレーターによるレビューが必要な場合は、 SKILL.md を直接記述する代わりに、Skill Workshop の提案を使用します。

# 新しい Skill を提案openclaw skills workshop propose-create \  --name "hello-world" \  --description "挨拶を出力するシンプルな Skill。" \  --proposal ./PROPOSAL.md # 既存の Skill の更新を提案openclaw skills workshop propose-update hello-world \  --proposal ./PROPOSAL.md \  --description "更新された挨拶 Skill"

提案にサポートファイルが含まれる場合は、--proposal-dir を使用します。

openclaw skills workshop propose-create \  --name "hello-world" \  --description "挨拶を出力するシンプルな Skill。" \  --proposal-dir ./hello-world-proposal/

ディレクトリのルートには PROPOSAL.md が必要です。サポートファイルは assets/、examples/、references/、scripts/、または templates/ の下に配置します。

レビュー後:

openclaw skills workshop inspect <proposal-id>openclaw skills workshop apply <proposal-id>

提案のライフサイクル全体については、Skill Workshopを参照してください。

ClawHub に公開する

npm i -g clawhubclawhub login

clawhub skill publish ./path/to/hello-world

ベストプラクティス

関連項目