NVIDIA OpenShell 0.1.x 入門 : 概要

OpenShellは、カーネルレベルの隔離を備えたサンドボックス環境で、自律型AIエージェントのフリートを実行するためのオープンソースのランタイムです。サンドボックスのランタイム制御と宣言的なYAMLポリシーを組み合わせることで、チームはエージェントにローカルファイル、認証情報、および外部ネットワークへの無制限のアクセスを与えることなく、エージェントを実行できます。

OpenShell 0.1.x 入門 : OpenShell について – 概要

作成 : Masashi Okumura (@ClassCat)
作成日時 : 11/19/2026
バージョン : OpenShell v0.1.9

* 本記事は docs.nvidia.com/openshell の以下のページを参考にしています :

* サンプルコードの動作確認はしておりますが、必要な場合には適宜、追加改変しています。

 

 

OpenShell 0.1.x 入門 : OpenShell について – 概要

OpenShellは、カーネルレベルの隔離を備えたサンドボックス環境で、自律型AIエージェントのフリート (fleets) を実行するためのオープンソースのランタイムです。サンドボックスのランタイム制御と宣言的なYAMLポリシーを組み合わせることで、チームはエージェントにローカルファイル、認証情報、および外部ネットワークへの無制限のアクセスを与えることなく、エージェントを実行できます。

 

OpenShellが存在する理由

AIエージェントは、ファイルの読み取り、パッケージのインストール、APIの呼び出し、そして認証情報の使用ができるときに最も役立ちます。その一方で、これと同じアクセス権限が重大なリスクを生み出す可能性もあります。OpenShellは、まさにこのトレードオフに対処するために設計されています: エージェントがアクセスできる対象に対して明示的な制御を強制しながら、エージェントの能力を維持します。

 

一般的なリスクと制御

以下の表は、一般的な障害モードと、OpenShellがそれらをどのように軽減しているかをまとめたものです。

脅威 制御なし OpenShell装備
データ流出 (exfiltration) エージェントがソースコードや内部ファイルを許可されていないエンドポイントにアップロードする。 ネットワークポリシーにより承認された宛先のみが許可; その他のアウトバウンドトラフィックは拒否される。
認証情報の窃盗 エージェントがSSHキーやクラウドの認証情報などのローカルの秘密情報を読み取る。 ファイルシステムの制限(Landlock)により、宣言されたパスのみにアクセスが制限される。
不正なAPI利用 エージェントがプロンプトやデータを未承認のモデルプロバイダーに送信する。 プロバイダープロファイルとネットワークポリシーにより、モデルのトラフィックが承認されたエンドポイントとバイナリに制限される。
権限昇格 エージェントがsudo、setuidパス、または危険なシステムコールの動作を試みる。 特権を持たないプロセスのアイデンティティとseccompの制限により、昇格パスがブロックされる。

 

保護レイヤーの概要

OpenShell は以下のポリシードメイン全体にわたって多層防御 (defense in depth) を適用します。

レイヤー 保護対象 適用タイミング
ファイルシステム 許可されたパス以外への読み取り/書き込みを防ぎます。 サンドボックス作成時にロックされます。
ネットワーク 許可されていないアウトバウンド接続をブロックします。 実行時にホットリロード可能です。
プロセス 権限昇格と危険なシステムコールをブロックします。 サンドボックス作成時にロックされます。
プロバイダー認証情報 プロファイルで許可されたエンドポイントでのみ、不透明な認証情報プレースホルダーを解決します。 (認証情報の) アタッチ・ローテーション・失効は実行時に更新されます; 新しい環境変数には新しいプロセスが必要です。

For details, refer to Sandbox Policies and Default Policy.

 

一般的なユースケース

OpenShell は、さまざまなエージェントのデプロイメントパターンをサポートします。

ユースケース 説明
セキュアなコーディングエージェント 制限されたファイルとネットワークアクセスで、Claude Code、OpenCode、Codex、またはGitHub Copilot CLIを実行します。
プライベートなエンタープライズ開発 機密コンテキストをユーザの管理下に置いたまま、選択されたサンドボックスにセルフホストまたはプライベートなモデルエンドポイントへのアクセスを許可します。
コンプライアンスと監査 ポリシーYAMLを、レビューおよび監査が可能なバージョン管理されたセキュリティ制御として扱います。
再利用可能な環境 デフォルトのUbuntuワークロードを使用するか、独自のコンテナ化されたランタイムを持ち込みます。

 

以上