スキル

​

場所と優先順位

1. バンドルされたスキル: インストールに同梱されています (npm パッケージまたは OpenClaw.app)
2. マネージド/ローカル スキル: ~/.openclaw/skills
3. ワークスペーススキル: <workspace>/skills

​

エージェントごとのスキルと共有スキル

• エージェントごとのスキルは、そのエージェントに対してのみ <workspace>/skills に存在します。
• 共有スキル は ~/.openclaw/skills (管理/ローカル) に存在し、表示されます 同じマシン上のすべてのエージェントに。
• 共有フォルダーは、skills.load.extraDirs (最低) 経由で追加することもできます。 優先) 複数のエージェントが使用する共通のスキル パックが必要な場合。同じスキル名が複数箇所に存在する場合は、通常のスキルが優先されます。 適用: ワークスペースが優先され、次に管理/ローカル、次にバンドルされます。

​

プラグイン + スキル

​

ClawHub (インストール + 同期)

• ワークスペースにスキルをインストールします。
  • clawhub install <skill-slug>
• インストールされているすべてのスキルを更新します。
  • clawhub update --all
• 同期 (スキャン + 更新の公開):
  • clawhub sync --all

​

セキュリティに関する注意事項- サードパーティのスキルを 信頼できないコード として扱います。有効にする前に読んでください

• 信頼できない入力や危険なツールに対しては、サンドボックスでの実行を優先します。 サンドボックス を参照してください。
• ワークスペースおよび追加ディレクトリのスキル検出は、解決されたリアルパスが構成されたルート内に留まるスキル ルートおよび SKILL.md ファイルのみを受け入れます。
• skills.entries.*.env および skills.entries.*.apiKey は ホスト プロセスにシークレットを挿入します そのエージェントのターン (サンドボックスではありません)。プロンプトやログに秘密を記載しないでください。
• より広範な脅威モデルとチェックリストについては、セキュリティ を参照してください。

​

形式 (AgentSkills + Pi 互換)

---
name: nano-banana-pro
description: Generate or edit images via Gemini 3 Pro Image
---

• 組み込みエージェントによって使用されるパーサーは、単一行 フロントマター キーのみをサポートします。
• metadata は 単一行の JSON オブジェクトである必要があります。
• スキルフォルダーのパスを参照するには、手順内で {baseDir} を使用します。
• オプションの前付キー:
  • homepage — URL は macOS スキル UI に「ウェブサイト」として表示されます (metadata.openclaw.homepage 経由でもサポートされています)。
  • user-invocable — true|false (デフォルト: true)。 true の場合、スキルはユーザーのスラッシュ コマンドとして公開されます。
  • disable-model-invocation — true|false (デフォルト: false)。 true の場合、スキルはモデル プロンプトから除外されます (ユーザー呼び出しを通じて引き続き使用できます)。
  • command-dispatch — tool (オプション)。 tool に設定すると、スラッシュ コマンドはモデルをバイパスし、ツールに直接ディスパッチされます。
  • command-tool — command-dispatch: tool が設定されている場合に呼び出すツール名。
  • command-arg-mode — raw (デフォルト)。ツールのディスパッチでは、生の引数文字列をツールに転送します (コア解析なし)。 このツールは params を使用して呼び出されます。 { command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }。

​

ゲーティング (ロード時間フィルター)

---
name: nano-banana-pro
description: Generate or edit images via Gemini 3 Pro Image
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"], "config": ["browser.enabled"] },
        "primaryEnv": "GEMINI_API_KEY",
      },
  }
---

• emoji — macOS スキル UI で使用されるオプションの絵文字。
• homepage — macOS スキル UI で「Web サイト」として表示されるオプションの URL。
• os — プラットフォームのオプションのリスト (darwin、linux、win32)。設定されている場合、スキルはそれらの OS でのみ有効です。
• requires.bins — リスト;それぞれが PATH に存在する必要があります。
• requires.anyBins — リスト;少なくとも 1 つは PATH に存在する必要があります。
• requires.env — リスト; env var は存在する必要があります**、または構成で指定する必要があります。
• requires.config — 真実でなければならない openclaw.json パスのリスト。
• primaryEnv — skills.entries.<name>.apiKey に関連付けられた環境変数名。
• install — macOS スキル UI で使用されるインストーラー仕様のオプションの配列 (brew/node/go/uv/download)。

• requires.bins はスキルのロード時に ホスト上でチェックされます。
• エージェントがサンドボックス化されている場合、バイナリは コンテナ内にも存在する必要があります。 agents.defaults.sandbox.docker.setupCommand (またはカスタム イメージ) を介してインストールします。 setupCommand は、コンテナーの作成後に 1 回実行されます。 パッケージのインストールには、ネットワーク出力、書き込み可能なルート FS、およびサンドボックス内のルート ユーザーも必要です。 例: summarize スキル (skills/summarize/SKILL.md) には summarize CLI が必要です サンドボックスコンテナ内で実行します。

---
name: gemini
description: Use Gemini CLI for coding assistance and Google search lookups.
metadata:
  {
    "openclaw":
      {
        "emoji": "♊️",
        "requires": { "bins": ["gemini"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "formula": "gemini-cli",
              "bins": ["gemini"],
              "label": "Install Gemini CLI (brew)",
            },
          ],
      },
  }
---

• すべてのインストーラーが download の場合、OpenClaw は各エントリをリストするので、利用可能なアーティファクトを確認できます。
• インストーラーの仕様には、プラットフォームごとにオプションをフィルターするための os: ["darwin"|"linux"|"win32"] を含めることができます。
• ノードは openclaw.json に skills.install.nodeManager をインストールします (デフォルト: npm; オプション: npm/pnpm/yarn/bun)。 これは スキルのインストールにのみ影響します。ゲートウェイ ランタイムは依然として Node である必要があります (Bun は WhatsApp/Telegram には推奨されません)。
• Go のインストール: go が見つからず、brew が利用可能な場合、ゲートウェイは最初に Homebrew 経由で Go をインストールし、可能な場合は GOBIN を Homebrew の bin に設定します。
• ダウンロード インストール: url (必須)、archive (tar.gz | tar.bz2 | zip)、extract (デフォルト: アーカイブ検出時に自動)、 stripComponents、targetDir (デフォルト: ~/.openclaw/tools/<skillKey>)。

​

構成の上書き (~/.openclaw/openclaw.json)

{
  skills: {
    entries: {
      "nano-banana-pro": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // or plaintext string
        env: {
          GEMINI_API_KEY: "GEMINI_KEY_HERE",
        },
        config: {
          endpoint: "https://example.invalid",
          model: "nano-pro",
        },
      },
      peekaboo: { enabled: true },
      sag: { enabled: false },
    },
  },
}

• enabled: false は、バンドル/インストールされている場合でもスキルを無効にします。
• env: 変数がプロセスにまだ設定されていない場合にのみ挿入されます。
• apiKey: metadata.openclaw.primaryEnv を宣言するスキルの利便性。 プレーンテキスト文字列または SecretRef オブジェクト ({ source, provider, id }) をサポートします。
• config: スキルごとのカスタムフィールド用のオプションのバッグ。カスタムキーはここに存在する必要があります。
• allowBundled: バンドル スキルのみのオプションの許可リスト。設定されている場合のみ、 リスト内のバンドルされたスキルが対象となります (管理/ワークスペース スキルは影響を受けません)。

​

環境インジェクション (エージェント実行ごと)

1. スキルのメタデータを読み取ります。
2. skills.entries.<key>.env または skills.entries.<key>.apiKey を process.env。
3. 資格のあるスキルを使用してシステム プロンプトを構築します。
4. 実行終了後に元の環境を復元します。

​

セッションのスナップショット (パフォーマンス)

​

リモート macOS ノード (Linux ゲートウェイ)

​

スキルウォッチャー (自動更新)

{
  skills: {
    load: {
      watch: true,
      watchDebounceMs: 250,
    },
  },
}

​

トークンの影響 (スキルリスト)

• スキルごと: 97 文字 + XML エスケープされた <name>、<description>、および <location> 値の長さ。

total = 195 + Σ (97 + len(name_escaped) + len(description_escaped) + len(location_escaped))

• XML エスケープにより、& < > " ' がエンティティ (&、< など) に展開され、長さが増加します。
• トークン数はトークナイザーのモデルによって異なります。 OpenAI スタイルの大まかな見積もりは、トークンあたり最大 4 文字であるため、スキルあたり 97 文字 ≈ 24 トークン + 実際のフィールドの長さになります。

​

マネージド スキルのライフサイクル

​

構成リファレンス

​

さらにスキルをお探しですか?