NVIDIA/OpenShell 源码：https://github.com/NVIDIA/OpenShell 许可证 (https://github.com/NVIDIA/OpenShell/blob/main/LICENSE) PyPI (https://pypi.org/project/openshell/) 安全策略 文档 (https://docs.nvidia.com/openshell/latest/index.html)

OpenShell 0.1.x 新增内容： 稳定的发布周期、新的隔离原语、扩展的接口以及全新 API。请阅读 0.1.0 升级指南 (https://docs.nvidia.com/openshell/latest/upgrade/0-1-0)。

OpenShell 是用于自主 AI 智能体集群的安全、私密运行时环境。当智能体能够读取文件、安装软件包、调用 API 并使用凭证时，它们将发挥最大效用。OpenShell 赋予智能体这些能力，同时避免它们对您的数据、密钥或网络进行无限制访问。您可以通过策略声明每个智能体可访问的资源，而 OpenShell 会强制执行这些限制。

工作原理

OpenShell 通过两种方式管理智能体的行为：在内核层面实施策略，在运行时对每次文件访问、系统调用和网络连接进行控制；并运用形式化验证在策略变更生效前检查其可能带来的权限扩展。

• 内核级执行。 每个智能体运行在隔离的沙箱环境中。内核控制限定其可访问的文件和可发起的系统调用，每个网络连接在离开沙箱前都会经过策略检查。智能体无法获取真实凭证；OpenShell 仅在发往授权端点的请求中添加凭证。

• 形式化验证的策略变更。 在策略变更获批前，OpenShell 通过形式化验证标记可能授予的新风险访问权限，例如使用凭证访问新主机或调用新 API 方法，因此此类变更需等待人工审核。

查看架构说明 (https://docs.nvidia.com/openshell/latest/about/architecture) 了解网关、监视器和沙箱的协作机制。

快速入门

您需要 Linux、搭载 Apple Silicon 的 macOS 或使用 WSL 2 的 Windows（实验性支持），以及 Docker、Podman 或宿主机虚拟化环境。详情请参阅支持矩阵 (https://docs.nvidia.com/openshell/latest/about/support-matrix)。

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

安装程序将设置 CLI 和本地网关。默认沙箱镜像是未安装智能体的精简版 Ubuntu。要运行真实智能体，请按照《运行您的首个智能体》(https://docs.nvidia.com/openshell/latest/about/run-your-first-agent) 操作：该指南通过 OpenCode 对接免费 OpenRouter 模型，演示如何在智能体需要时批准新的访问权限。

深入探索

• 沙箱 (https://docs.nvidia.com/openshell/latest/how-it-works/sandboxes/overview)：镜像、运行时、GPU 和生命周期管理。
• 策略 (https://docs.nvidia.com/openshell/latest/how-it-works/policies/overview)：文件系统、网络和进程规则，配合顾问 (https://docs.nvidia.com/openshell/latest/how-it-works/policies/advisor) 与验证器 (https://docs.nvidia.com/openshell/latest/how-it-works/policies/prover) 审查变更。
• 提供商 (https://docs.nvidia.com/openshell/latest/how-it-works/providers/overview)：仅在授权端点生效的凭证，包括推理服务 (https://docs.nvidia.com/openshell/latest/how-it-works/inference)。
• 网关 (https://docs.nvidia.com/openshell/latest/how-it-works/gateways/overview)：沙箱、策略和访问的控制平面。
• Kubernetes (https://docs.nvidia.com/openshell/latest/kubernetes/setup)：使用 Helm 部署网关。您的 CNI 必须强制执行 NetworkPolicy。
• 可扩展性 (https://docs.nvidia.com/openshell/latest/extensibility/overview)：中间件、拦截器和计算驱动程序。
• 教程 (https://docs.nvidia.com/openshell/latest/tutorials/first-network-policy)：分步策略与智能体操作指南。
• 预发布与开发版本 (https://docs.nvidia.com/openshell/latest/about/installation#prerelease-and-development-builds)：尝试即将发布的版本或 main 分支最新提交。

智能体技能

为您的编码智能体安装公共 OpenShell 技能：

npx skills add NVIDIA/OpenShell

这些技能教会智能体操作 OpenShell CLI、编写沙箱策略以及调试网关与推理路由。技能文件位于 skills/ 目录，无需检出 OpenShell 源码即可使用。

SDK

SDK 将应用程序连接至 OpenShell 网关，不安装 CLI。建议尽可能使用相同版本的 OpenShell 构建 SDK 和网关。

社区

• 问题与讨论： GitHub 讨论区 (https://github.com/NVIDIA/OpenShell/discussions)
• 缺陷报告与功能请求： GitHub Issues (https://github.com/NVIDIA/OpenShell/issues)，请使用问题模板
• 安全漏洞： 请遵循 SECURITY.md。不要提交 GitHub issue。
• 开发路线图： OpenShell 路线图 (https://github.com/orgs/NVIDIA/projects/233) 和 RFC 看板 (https://github.com/orgs/NVIDIA/projects/233/views/6)
• 云端体验： Brev Launchable (https://brev.nvidia.com/launchable/deploy/now?launchableID=env-3Ap3tL55zq4a8kew1AuW0FpSLsg)

OpenShell 以智能体为先进行构建：它使用其赋能的相同智能体驱动工作流进行开发。请参阅 CONTRIBUTING.md 了解开发设置与贡献流程，以及 AGENTS.md 获取贡献者智能体技能与工作流链信息。

遥测

OpenShell 收集匿名遥测数据（限于操作类别和计数），以帮助改进项目。它不收集沙箱名称、主机名、文件路径、提示词、凭证、提供商或模型名称，或用户内容。如需禁用，请在网关设置 OPENSHELL_TELEMETRY_ENABLED=false，或在 Helm 安装中设置 server.telemetryEnabled=false。您也可以完全编译移除遥测功能。详见遥测文档 (https://docs.nvidia.com/openshell/latest/observability/telemetry) 和社区遥测报告了解已发布的使用趋势。

声明与免责声明

本软件自动检索、访问或与外部材料进行交互。这些检索的材料并未与本软件一同分发，完全受独立条款、条件和许可证约束。您需自行负责查找、审查并遵守所有适用的条款、条件和许可证，并验证任何检索材料对您特定用例的安全性、完整性和适用性。

本软件按“原样”提供，不附带任何形式的明示或暗示保证。作者对任何检索材料不作任何陈述或保证，并对因您使用或无法使用本软件或任何检索材料所造成的任何损失、损害、责任或法律后果不承担任何责任。使用本软件和检索材料需自行承担风险。

许可证

本项目采用 Apache 许可证 2.0 (https://github.com/NVIDIA/OpenShell/blob/main/LICENSE)。