​

Skills（OpenClaw）

​

場所と優先順位

1. 追加 skill フォルダー: skills.load.extraDirs で設定
2. バンドル済み Skills: インストールに同梱（npm パッケージまたは OpenClaw.app）
3. managed/local Skills: ~/.openclaw/skills
4. 個人エージェント Skills: ~/.agents/skills
5. プロジェクトエージェント Skills: <workspace>/.agents/skills
6. workspace Skills: <workspace>/skills

​

エージェント単位の Skills と共有 Skills

• エージェント単位の Skills は、そのエージェント専用の <workspace>/skills にあります。
• プロジェクトエージェント Skills は <workspace>/.agents/skills にあり、 通常の workspace skills/ フォルダーより前にその workspace に適用されます。
• 個人エージェント Skills は ~/.agents/skills にあり、 そのマシン上の複数 workspace にまたがって適用されます。
• 共有 Skills は ~/.openclaw/skills（managed/local）にあり、 同じマシン上の すべてのエージェント から見えます。
• 複数エージェントで使う共通の Skills パックが必要なら、 skills.load.extraDirs（最低優先度）で 共有フォルダー を追加することもできます。

​

エージェント Skill allowlist

• 場所/優先順位は、同名 skill のどのコピーが勝つかを決定します。
• エージェント allowlist は、可視な Skills のうちそのエージェントが実際に使えるものを決定します。

{
  agents: {
    defaults: {
      skills: ["github", "weather"],
    },
    list: [
      { id: "writer" }, // github, weather を継承
      { id: "docs", skills: ["docs-search"] }, // defaults を置き換える
      { id: "locked-down", skills: [] }, // Skills なし
    ],
  },
}

• デフォルトで Skills を無制限にするには agents.defaults.skills を省略します。
• agents.defaults.skills を継承するには agents.list[].skills を省略します。
• Skills なしにするには agents.list[].skills: [] を設定します。
• 空でない agents.list[].skills リストはそのエージェントの最終セットであり、 defaults とはマージされません。

​

Plugins + Skills

​

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

• workspace に skill をインストールする:
  • openclaw skills install <skill-slug>
• インストール済みのすべての Skills を更新する:
  • openclaw skills update --all
• 同期する（スキャン + 更新を公開）:
  • clawhub sync --all

​

セキュリティ上の注意

• サードパーティの Skills は 信頼されていないコード として扱ってください。有効化する前に読んでください。
• 信頼できない入力や危険なツールには sandboxed 実行を優先してください。Sandboxing を参照してください。
• workspace と extra-dir の skill 検出では、解決された realpath が設定済みルート内にとどまる skill ルートと SKILL.md ファイルのみを受け付けます。
• Gateway バックの skill 依存関係インストール（skills.install、オンボーディング、および Skills 設定 UI）は、installer metadata を実行する前に組み込みの dangerous-code scanner を実行します。critical な検出結果は、呼び出し側が明示的に dangerous override を設定しない限り、デフォルトでブロックされます。疑わしい検出結果は警告のみです。
• openclaw skills install <slug> は異なります。これは ClawHub の skill フォルダーを workspace にダウンロードし、上記の installer-metadata パスは使用しません。
• skills.entries.*.env と skills.entries.*.apiKey は、そのエージェントターンに対して host プロセスへ secret を注入します （sandbox ではありません）。secret をプロンプトやログに含めないでください。
• より広い脅威モデルとチェックリストについては Security を参照してください。

​

形式（AgentSkills + Pi 互換）

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
---

• レイアウト/意図については AgentSkills 仕様に従っています。
• 組み込みエージェントで使われる parser は single-line frontmatter キーのみをサポートします。
• metadata は single-line JSON object である必要があります。
• skill フォルダーパスを参照するには、説明内で {baseDir} を使用してください。
• 任意の frontmatter キー:
  • homepage — macOS Skills UI で「Website」として表示される URL（metadata.openclaw.homepage 経由でもサポート）。
  • user-invocable — true|false（デフォルト: true）。true の場合、この skill はユーザー slash command として公開されます。
  • disable-model-invocation — true|false（デフォルト: false）。true の場合、この skill は model prompt から除外されます（ユーザー呼び出しでは引き続き利用可能）。
  • command-dispatch — tool（任意）。tool に設定すると、slash command は model をバイパスしてツールへ直接ディスパッチされます。
  • command-tool — command-dispatch: tool が設定されているときに呼び出すツール名。
  • command-arg-mode — raw（デフォルト）。ツールディスパッチでは、生の args 文字列をそのままツールへ転送します（core 側の解析なし）。 ツールは次の params で呼び出されます: { command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }。

​

ゲーティング（ロード時フィルター）

---
name: image-lab
description: Generate or edit images via a provider-backed image workflow
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）。設定されている場合、その skill はその OS でのみ対象になります。
• requires.bins — 一覧。各項目が PATH 上に存在する必要があります。
• requires.anyBins — 一覧。少なくとも 1 つが PATH 上に存在する必要があります。
• requires.env — 一覧。env var が存在する か、設定で提供されている必要があります。
• requires.config — truthy でなければならない openclaw.json パスの一覧。
• primaryEnv — skills.entries.<name>.apiKey に関連付けられる env var 名。
• install — macOS Skills UI で使われる installer spec の任意配列（brew/node/go/uv/download）。

• requires.bins は、skill ロード時に host 上でチェックされます。
• エージェントが sandboxed の場合、そのバイナリーは container 内にも 存在する必要があります。 agents.defaults.sandbox.docker.setupCommand（または custom image）でインストールしてください。 setupCommand は container 作成後に 1 回実行されます。 パッケージインストールには、network egress、書き込み可能な root FS、そして sandbox 内の root ユーザーも必要です。 例: summarize skill（skills/summarize/SKILL.md）がそこで実行されるには、 summarize CLI が sandbox container 内に必要です。

---
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)",
            },
          ],
      },
  }
---

• 複数の installer が列挙されている場合、gateway は 単一の 優先オプションを選びます（brew が利用可能なら brew、そうでなければ node）。
• すべての installer が download の場合、OpenClaw は利用可能なアーティファクトを見られるよう各エントリを列挙します。
• installer spec には os: ["darwin"|"linux"|"win32"] を含めて、プラットフォーム別に選択肢をフィルタリングできます。
• Node インストールは openclaw.json 内の skills.install.nodeManager に従います（デフォルト: npm。選択肢: npm/pnpm/yarn/bun）。 これは skill インストール にのみ影響します。Gateway ランタイムは引き続き Node であるべきです（WhatsApp/Telegram では Bun は推奨されません）。
• Gateway バックの installer 選択は node-only ではなく、優先度駆動です: install spec に複数 kind が混在している場合、OpenClaw は skills.install.preferBrew が有効で brew が存在すれば Homebrew を優先し、その後 uv、次に設定済みの node manager、その後 go や download などの他のフォールバックを使います。
• すべての install spec が download の場合、OpenClaw は 1 つの優先 installer にまとめず、 すべての download オプションを表示します。
• Go インストール: go がなく brew が利用可能な場合、gateway は先に Homebrew で Go をインストールし、可能なら GOBIN を Homebrew の bin に設定します。
• Download インストール: url（必須）、archive（tar.gz | tar.bz2 | zip）、extract（デフォルト: archive 検出時は自動）、stripComponents、targetDir（デフォルト: ~/.openclaw/tools/<skillKey>）。

​

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

{
  skills: {
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, // または 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 は、bundled/installed であってもその skill を無効化します。
• env: 変数が process 内でまだ設定されていない 場合のみ 注入されます。
• apiKey: metadata.openclaw.primaryEnv を宣言した skill 向けの 便利機能。plaintext string または SecretRef object（{ source, provider, id }）をサポートします。
• config: custom な skill ごとのフィールドのための任意の bag。custom key はここに置く必要があります。
• allowBundled: bundled Skills 専用の任意の allowlist。設定した場合、 一覧内の bundled skill のみが対象になります（managed/workspace Skills には影響しません）。

​

環境注入（エージェント実行単位）

1. skill metadata を読み取る。
2. skills.entries.<key>.env または skills.entries.<key>.apiKey を process.env に適用する。
3. 対象となる Skills を使って system prompt を構築する。
4. 実行終了後、元の環境を復元する。

​

セッション snapshot（パフォーマンス）

​

リモート macOS node（Linux gateway）

​

Skills watcher（自動更新）

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

​

トークンへの影響（Skills 一覧）

• ベースオーバーヘッド（1 つ以上の skill がある場合のみ）: 195 文字。
• skill ごと: 97 文字 + XML エスケープされた <name>、<description>、<location> の長さ。

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

• XML エスケープでは & < > " ' がエンティティ（&、< など）に展開され、長さが増えます。
• トークン数は model tokenizer によって異なります。OpenAI 風の概算では約 4 文字/トークンなので、97 文字 ≈ 24 トークン/skill に実際のフィールド長が加わります。

​

managed Skills のライフサイクル

​

設定リファレンス

​

もっと多くの Skills を探していますか？

​

関連

• Creating Skills — custom Skills の作成
• Skills Config — Skill 設定リファレンス
• Slash Commands — 利用可能なすべての slash command
• Plugins — plugin システム概要