​

Skills（OpenClaw）

​

配置場所と優先順位

1. 同梱 skills：インストール（npm パッケージまたは OpenClaw.app）に同梱
2. マネージド／ローカル skills：~/.openclaw/skills
3. ワークスペース skills：<workspace>/skills

​

エージェント別と共有 skills

• エージェント別 skills は、そのエージェント専用として <workspace>/skills に配置されます。
• 共有 skills は ~/.openclaw/skills（マネージド／ローカル）に配置され、同一マシン上の すべてのエージェント から参照できます。
• 共有フォルダー は、複数エージェントで共通の skills パックを使いたい場合、skills.load.extraDirs（最下位の優先順位）でも追加できます。

​

プラグインと skills

​

ClawHub（インストール＋同期）

• ワークスペースに skill をインストール：
  • clawhub install <skill-slug>
• インストール済み skills をすべて更新：
  • clawhub update --all
• 同期（スキャン＋公開更新）：
  • clawhub sync --all

​

セキュリティ上の注意

• サードパーティ製 skills は 信頼できないコード として扱ってください。有効化する前に内容を確認してください。
• 信頼できない入力やリスクの高いツールには、サンドボックス化された実行を優先してください。Sandboxing を参照してください。
• skills.entries.*.env と skills.entries.*.apiKey は、そのエージェントのターンにおいて ホスト プロセスにシークレットを注入します（サンドボックスではありません）。シークレットをプロンプトやログに含めないでください。
• より広範な脅威モデルとチェックリストについては Security を参照してください。

​

形式（AgentSkills + Pi-compatible）

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

• レイアウト／意図については AgentSkills 仕様に従います。
• 組み込みエージェントが使用するパーサーは、単一行のフロントマターキーのみをサポートします。
• metadata は 単一行の JSON オブジェクトである必要があります。
• 手順内で skill フォルダーパスを参照するには {baseDir} を使用してください。
• 任意のフロントマターキー：
  • homepage — macOS Skills UI に「Website」として表示される URL（metadata.openclaw.homepage でも対応）。
  • user-invocable — true|false（既定：true）。true の場合、skill はユーザーのスラッシュコマンドとして公開されます。
  • disable-model-invocation — true|false（既定：false）。true の場合、skill はモデルプロンプトから除外されます（ユーザー呼び出しでは引き続き利用可能）。
  • command-dispatch — tool（任意）。tool に設定すると、スラッシュコマンドはモデルをバイパスして直接ツールにディスパッチされます。
  • command-tool — command-dispatch: tool が設定されている場合に呼び出すツール名。
  • command-arg-mode — raw（default）。ツールディスパッチの場合、raw args 文字列をツールに転送します（コアパースなし）。 ツールは次のパラメータで呼び出されます：
    { 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",
      },
  }
---

• always: true — 常に skill を含めます（他のゲートをスキップ）。
• emoji — macOS Skills UI で使用される任意の絵文字。
• homepage — macOS Skills UI に「Website」として表示される任意の URL。
• os — 任意のプラットフォーム一覧（darwin, linux, win32）。設定した場合、その OS のみで有効です。
• requires.bins — リスト。各項目は PATH 上に存在する必要があります。
• requires.anyBins — リスト。少なくとも 1 つが PATH 上に存在する必要があります。
• requires.env — リスト。環境変数が存在する または 設定で提供されている必要があります。
• requires.config — 真である必要がある openclaw.json パスのリスト。
• primaryEnv — skills.entries.<name>.apiKey に関連付けられた環境変数名。
• install — macOS Skills UI で使用されるインストーラ仕様の任意の配列（brew/node/go/uv/download）。

• requires.bins は、skill のロード時に ホスト でチェックされます。
• エージェントがサンドボックス化されている場合、バイナリも コンテナ内 に存在する必要があります。
  agents.defaults.sandbox.docker.setupCommand（またはカスタムイメージ）でインストールします。
  setupCommand はコンテナ作成後に一度実行されます。
  パッケージのインストールには、ネットワーク egress、書き込み可能なルート FS、およびサンドボックス内の root ユーザーも必要です。
  例：summarize skill（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)",
            },
          ],
      },
  }
---

• 複数のインストーラが列挙されている場合、ゲートウェイは 単一 の優先オプション（利用可能な場合は brew、そうでなければ node）を選択します。
• すべてのインストーラが download の場合、OpenClaw は各エントリを一覧表示します。
• インストーラ仕様には、os: ["darwin"|"linux"|"win32"] を含めてプラットフォーム別にフィルタリングできます。
• Node のインストールは、openclaw.json の skills.install.nodeManager を尊重します（既定：npm；選択肢：npm/pnpm/yarn/bun）。
  これは skill installs のみに影響します。Gateway ランタイムは引き続き Node を使用してください（WhatsApp/Telegram では Bun は推奨されません）。
• Go のインストール：go がなく brew が利用可能な場合、先に Homebrew で Go をインストールし、可能であれば GOBIN を Homebrew の bin に設定します。
• Download のインストール：url（必須）、archive（tar.gz | tar.bz2 | zip）、extract（既定：アーカイブ検出時は自動）、stripComponents、targetDir（既定：~/.openclaw/tools/<skillKey>）。

​

設定による上書き（~/.openclaw/openclaw.json）

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

• enabled: false は、同梱／インストール済みであっても skill を無効化します。
• env：その変数がプロセス内ですでに設定されていない場合に のみ 注入されます。
• apiKey：metadata.openclaw.primaryEnv を宣言する skills 向けの簡便機能です。
• config：カスタムの skill ごとのフィールドを入れる任意の入れ物です。カスタムキーはここに配置する必要があります。
• allowBundled：同梱 skills のみを対象とした任意の許可リスト。設定されている場合、リスト内の同梱 skills のみが有効になります（マネージド／ワークスペース skills には影響しません）。

​

環境変数の注入（エージェント実行ごと）

1. Skill メタデータを読み取ります。
2. skills.entries.<key>.env または skills.entries.<key>.apiKey を process.env に適用します。
3. 有効な skills を用いてシステムプロンプトを構築します。
4. 実行終了後、元の環境を復元します。

​

セッションスナップショット（パフォーマンス）

​

リモート macOS ノード（Linux gateway）

​

Skills ウォッチャー（自動更新）

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

​

Token impact（skills list）

• Base overhead（1 つ以上の skill がある場合のみ）： 195 characters。
• Per skill： 97 characters + XML エスケープされた <name>、<description>、<location> の長さ。

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

• XML エスケープにより & < > " ' はエンティティ（&, < など）に展開され、長さが増加します。
• トークン数はモデルのトークナイザーによって異なります。OpenAI 風の概算では約 4 chars/token のため、97 chars ≈ 24 tokens／skill に加えて実際のフィールド長が加算されます。

​

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

​

設定リファレンス

​

さらに skills を探していますか？