OpenShell：安全私密的自主 AI 代理叢集執行環境

重要

OpenShell 0.1.x 的新功能: 穩定的發行節奏、新的隔離原語、擴充的擴充套件介面，以及新的 API。閱讀 0.1.0 升級指南

OpenShell 是安全、私密的執行環境，適用於自治 AI 代理的艦隊。代理在能讀取檔案、安裝套件、呼叫 API 並使用憑證時最為有用。OpenShell 讓代理擁有這些能力，但不會授予其對您的資料、機密或網路的無限制存取。您可在政策中宣告每個代理可存取的範圍，OpenShell 將執行此政策。

工作原理

OpenShell 以兩種方式管理代理可執行的操作：它在核心層插裝程式以在執行時對每一次檔案存取、系統呼叫與網路連線執行政策，並且使用形式驗證在政策變更生效前檢查其允許的存取。

核心層執行。 每個代理都在隔離的沙盒中執行。核心控制限制其可存取的檔案與可呼叫的系統指令，且每一次網路連線在離開沙盒前都會經過政策檢查。代理永遠不會看到真實憑證；OpenShell 只會將憑證加入指向已核准端點的請求。
形式驗證的政策變更。 在政策變更獲批前，OpenShell 會使用形式驗證標記其可能授予的風險新存取，例如使用憑證連線新主機或呼叫新 API 方法，讓這些變更須經過人工審核。

參見架構瞭解閘道器、監督者與沙盒如何協同運作。

快速開始

您需要 Linux、Apple Silicon 上的 macOS 或 Windows (WSL 2，實驗性)，以及 Docker、Podman 或宿主虛擬化。詳情請參閱支援矩陣。

curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo

安裝程式會設定 CLI 與本機閘道器。預設的沙盒映像為最小化 Ubuntu，未安裝代理。若要執行實際代理，請依照執行您的第一個代理：它會在免費的 OpenRouter 模型上執行 OpenCode，並示範如何在代理需要時批准新存取。

進一步探索

沙盒：映像、執行環境、GPU 與生命週期。
政策: 檔案系統、網路與流程規則，與 advisor 與 prover 用於審查變更.
提供者：僅於已核准端點可使用的憑證，包含推論。
閘道器：沙盒、政策與存取的控制平面。
Kubernetes：使用 Helm 部署閘道器。您的 CNI 必須執行 NetworkPolicy。
可擴充性：中介軟體、攔截器與運算驅動程式。
教學：逐步說明政策與代理的使用流程。
預釋出與開發版本：試用即將發布的版本或 main 上的最新提交。

代理技能

為您的程式編寫代理安裝公開的 OpenShell 技能：

npx skills add NVIDIA/OpenShell

這些技能教導代理如何操作 OpenShell CLI、撰寫沙盒政策，以及除錯閘道器與推論路由。它們位於 skills/，並可在不檢出 OpenShell 原始碼的情況下使用。

SDKs

SDK 連線應用程式至 OpenShell 閘道器。它們不會安裝 CLI。盡可能使用相同版本的 OpenShell 供 SDK 與閘道器。

語言	安裝	檔案
Python	`uv add openshell`	README
TypeScript	`npm install @nvidia/openshell-sdk` (GitHub Packages)	README
Go	`go get github.com/NVIDIA/OpenShell/sdk/go@latest`	README
Rust	`cargo add openshell-sdk --git https://github.com/NVIDIA/OpenShell --tag <release-tag>`	安裝與使用

社群

問題與討論： GitHub Discussions
錯誤回報與功能請求: GitHub Issues, 使用 issue 範本
安全漏洞: 請遵循 SECURITY.md. 請勿開 GitHub 問題。
路線圖: OpenShell Roadmap 與 RFC board
雲端試用: Brev Launchable

OpenShell 以代理優先方式構建：它使用相同的代理驅動工作流程進行開發。請參閱 CONTRIBUTING.md 瞭解開發設定與貢獻工作流程，並參閱 AGENTS.md 瞭解倉庫程式碼規範。

遙測

OpenShell 會蒐集匿名遙測資料，僅限於操作類別與計數，以協助改善專案。它不會蒐集沙盒名稱、主機名稱、檔案路徑、提示、憑證、供應商或模型名稱，亦不收集使用者內容。若要停用，請於閘道設定 OPENSHELL_TELEMETRY_ENABLED=false，或於 Helm 安裝設定 server.telemetryEnabled=false。您亦可完全編譯時排除遙測。詳情請參閱 Telemetry，並參閱 community telemetry reports 以瞭解已公佈的使用趨勢。

通知與免責宣告

本軟體會自動檢索、存取或互動外部素材。這些檢索到的素材不隨本軟體分發，且僅受獨立條款、條件與授權協議管轄。您需自行負責尋找、審閱並遵守所有適用條款、條件與授權協議，並確認任何檢索素材的安全性、完整性與適用性，符合您的特定使用需求。本軟體以「原樣」提供，並不保證任何形式。作者對任何檢索素材不作任何陳述或保證，亦不承擔因您使用或無法使用本軟體或檢索素材所造成的任何損失、損害、責任或法律後果。使用本軟體與檢索素材風險由您自行承擔。

授權

本專案採用 Apache License 2.0 授權。