Skills

• デフォルトですべての Skills を制限なしにするには、agents.defaults.skills を省略します。
• agents.defaults.skills を継承するには、agents.entries.*.skills を省略します。
• そのエージェントに Skills を一切公開しない場合は、agents.entries.*.skills: [] を設定します。
• 空でない agents.entries.*.skills リストが最終的なセットになります。デフォルトとはマージされません。
• 有効な許可リストは、プロンプトの構築、スラッシュコマンドの検出、サンドボックスの同期、Skills のスナップショット全体に適用されます。
• これはホストシェルの認可境界ではありません。同じエージェントが 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> は、Skills の clawhub.skill.verify.v1 信頼エンベロープを ClawHub に問い合わせます。インストール済みの ClawHub Skills は、.clawhub/origin.json に記録されたバージョンとレジストリに対して検証されます。既存のインストール済み Skills または一意に特定できる Skills では、所有者なしのスラッグも引き続き受け付けられますが、所有者修飾付きの参照を使うことで公開者の曖昧さを回避できます。

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

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

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

Skills のインストールを続行する前に信頼済みのローカルポリシーコマンドを実行するには、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（デフォルト: アーカイブ検出時は auto）、stripComponents、 targetDir（デフォルト: ~/.openclaw/tools/<skillKey>）。

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

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

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

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

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

オフラインのノードによって、リモート専用スキルが表示されることはありません。ノードが bin プローブに応答しなくなると、OpenClaw はキャッシュされた bin の一致情報を消去します。