Skills

• 既定ですべてのSkillsを無制限にするには、agents.defaults.skillsを省略します。
• agents.defaults.skillsを継承するには、agents.list[].skillsを省略します。
• そのエージェントにSkillsを一切公開しない場合は、agents.list[].skills: []を設定します。
• 空でないagents.list[].skillsリストが最終的なセットです。既定値とはマージされません。
• 有効な許可リストは、プロンプトの構築、スラッシュコマンドの検出、サンドボックスの同期、Skillスナップショットのすべてに適用されます。
• これはホストシェルの認可境界ではありません。同じエージェントがexecを使用できる場合は、サンドボックス化、OSユーザーの分離、execの拒否／許可リスト、リソースごとの認証情報を使用して、そのシェルを別途制限してください。

openclaw skills installは、既定でアクティブなワークスペースのskills/ディレクトリにインストールします。--globalを追加すると、共有の~/.openclaw/skillsディレクトリにインストールされ、エージェント許可リストで制限されない限り、すべてのローカルエージェントに表示されます。

Gitおよびローカルからのインストールでは、ソースルートにSKILL.mdが必要です。有効な場合、スラッグにはSKILL.mdのフロントマターにあるnameが使用され、それ以外の場合はディレクトリ名またはリポジトリ名が使用されます。上書きするには--as <slug>を使用します。 openclaw skills updateが追跡するのはClawHubからのインストールのみです。Gitまたはローカルソースを更新するには、再インストールしてください。

openclaw skills verify @owner/<slug>は、Skillのclawhub.skill.verify.v1信頼エンベロープをClawHubに要求します。インストール済みのClawHub Skillsは、.clawhub/origin.jsonに記録されたバージョンとレジストリに対して検証されます。 所有者を含まないスラッグも、既存のインストール済みSkillまたは一意に特定できるSkillでは引き続き受け付けられますが、所有者で修飾した参照を使用すると公開者の曖昧さを避けられます。

ClawHubのSkillページでは、インストール前に最新のセキュリティスキャン状態が表示され、VirusTotal、ClawScan、静的解析の詳細ページも提供されます。ClawHubが検証を失敗と判定した場合、コマンドは0以外の終了コードで終了します。公開者は、ClawHubダッシュボードまたはclawhub skill rescan @owner/<slug>を使用して誤検知から復旧できます。

ClawHub以外の配信が必要なGatewayクライアントは、skills.upload.begin、skills.upload.chunk、skills.upload.commitを使用してzip形式のSkillアーカイブをステージングし、その後skills.install({ source: "upload", ... })でインストールできます。この経路は既定で無効になっており、openclaw.jsonでskills.install.allowUploadedArchives: trueを設定する必要があります。通常のClawHubからのインストールでは、この設定は不要です。

ワークスペース、プロジェクトエージェント、追加ディレクトリでのSkill検出では、skills.load.allowSymlinkTargetsによって対象ルートが明示的に信頼されている場合を除き、解決後のrealpathが設定されたルート内に収まるSkillルートのみを受け付けます。 Skill Workshopは、skills.workshop.allowSymlinkTargetWritesが有効な場合に限り、それらの信頼された対象を通じて書き込みます。 管理対象の~/.openclaw/skillsと個人用の~/.agents/skillsにはシンボリックリンクされたSkillフォルダを含められますが、すべてのSKILL.mdのrealpathは、解決後のSkillディレクトリ内に収まる必要があります。

Skillのインストールを続行する前に、信頼されたローカルポリシーコマンドを実行するようsecurity.installPolicyを設定します。ポリシーはメタデータとステージング済みソースパスを受け取り、ClawHub、アップロード、Git、ローカル、更新、依存関係インストーラーの各経路に適用されます。コマンドが有効な判定を返せない場合は、拒否側に倒れます。

skills.entries.*.envとskills.entries.*.apiKeyは、そのエージェントターンの間だけ、シークレットをホストプロセスに注入します。サンドボックスには注入されません。プロンプトやログにシークレットを含めないでください。

• 複数のインストーラーが指定されている場合、Gateway は優先する 選択肢を 1 つ選びます（利用可能なら brew、そうでなければ node）。
• すべてのインストーラーが download の場合、OpenClaw は利用可能な すべての成果物を確認できるよう、各エントリーを一覧表示します。
• 仕様に os: ["darwin"|"linux"|"win32"] を含めると、プラットフォームで絞り込めます。
• Node のインストールでは、openclaw.json の skills.install.nodeManager が使用されます（デフォルト: npm、選択肢: npm / pnpm / yarn / bun）。これはスキルの インストールにのみ影響します。Gateway ランタイムには引き続き Node を使用してください。
• Gateway のインストーラー優先順位: Homebrew → uv → 設定済みの node マネージャー → go → download。

• Homebrew: OpenClaw は Homebrew を自動インストールせず、brew の formula をシステムパッケージコマンドに変換することもありません。brew のない Linux コンテナでは brew 専用インストーラーは非表示になります。カスタムイメージを使用するか、 依存関係を手動でインストールしてください。
• Go: OpenClaw によるスキルの自動インストールには Go 1.21 以降が必要です。 go がなく Homebrew が利用可能な場合、OpenClaw はまず Homebrew 経由で Go をインストールします。Homebrew のない Linux では、更新後の golang-go 候補が最低バージョンを満たしていれば、root として、またはパスワード不要の sudo 経由で apt-get を使用できます。依存関係に対する実際の go install は、 設定済みの GOBIN ではなく、常に OpenClaw が管理する専用の bin ディレクトリ （新規インストール時は Homebrew の bin、それ以外は ~/.local/bin）を対象とします。 独自の GOBIN、GOPATH、GOTOOLCHAIN 環境変数は読み取られますが、 上書きされることはありません。
• ダウンロード: url（必須）、archive（tar.gz | tar.bz2 | zip）、 extract（デフォルト: アーカイブ検出時に自動）、stripComponents、 targetDir（デフォルト: ~/.openclaw/tools/<skillKey>）。

requires.bins はスキルの読み込み時に ホスト 上で確認されます。エージェントが サンドボックス内で実行される場合、バイナリは コンテナ内 にも存在する必要があります。 agents.defaults.sandbox.docker.setupCommand またはカスタムイメージを使用して インストールしてください。setupCommand はコンテナ作成後に一度だけ実行され、 外部へのネットワーク接続、書き込み可能なルートファイルシステム、サンドボックス内の root ユーザーが必要です。

デフォルトでは、OpenClaw はスキルフォルダーを監視し、SKILL.md ファイルが 変更されるとスナップショットを更新します。skills.load 配下で設定します。

{  skills: {    load: {      extraDirs: ["~/Projects/agent-scripts/skills"],      allowSymlinkTargets: ["~/Projects/manager/skills"],      watch: true, // デフォルト      watchDebounceMs: 250, // デフォルト    },  },}

スキルルートのシンボリックリンクが設定済みルートの外部を指す、意図的な シンボリックリンク構成では allowSymlinkTargets を使用してください。例: <workspace>/skills/manager -> ~/Projects/manager/skills。 Skill Workshop からも、信頼されたそれらのシンボリックリンクパスを通じて提案を 適用する必要がある場合にのみ、skills.workshop.allowSymlinkTargetWrites を有効にしてください。

Gateway が Linux 上で動作していても、system.run が許可された macOS node が接続されている場合、必要なバイナリがその node に存在すれば、OpenClaw は macOS 専用スキルを使用対象として扱えます。エージェントは host=node を指定した exec ツール経由で、それらのスキルを実行する必要があります。

オフラインの node では、リモート専用スキルは表示されません。node が バイナリのプローブに応答しなくなると、OpenClaw はキャッシュされたバイナリ一致情報を消去します。