重要
OpenShell 0.1.x 中的新特性：稳定的发布节奏、新的隔离原语、扩展的扩展面，以及新的 API。阅读 0.1.0 升级指南。
OpenShell 是面向自主 AI 智能体集群的安全、私密运行时。智能体在能够读取文件、安装软件包、调用 API 和使用凭证时最为有用。OpenShell 赋予它们这些能力，同时不让它们无限制地访问你的数据、密钥或网络。你在策略中声明每个智能体可以接触什么，OpenShell 负责强制执行。
工作原理
OpenShell 通过两种方式管控智能体的行为：它在运行时对内核进行插桩，对每一次文件访问、系统调用和网络连接强制执行策略；并使用形式化验证，在策略变更被应用之前检查该变更会允许哪些操作。
- 内核级强制执行。每个智能体都在隔离的沙箱中运行。内核控制限制它可以访问哪些文件、可以发起哪些系统调用，并且每个网络连接在离开沙箱之前都要经过策略检查。智能体永远看不到真实凭证；OpenShell 只会在发往已批准端点的请求中添加它们。
- 经形式化验证的策略变更。在策略变更获批之前，OpenShell 使用形式化验证标记该变更将授予的高风险新访问权限，例如使用凭证访问新主机或调用新的 API 方法，因此这些变更会等待人工审核。
参见架构了解网关、监督器和沙箱如何协同工作。
快速开始
你需要 Linux、Apple Silicon 上的 macOS，或带 WSL 2 的 Windows（实验性），以及 Docker、Podman 或主机虚拟化。详见支持矩阵。
curl -LsSf https://raw.githubusercontent.com/NVIDIA/OpenShell/main/install.sh | sh
openshell sandbox create --name demo安装程序会设置 CLI 和一个本地网关。默认沙箱镜像是最小化的 Ubuntu，未安装任何智能体。要运行真实智能体，请按照运行你的第一个智能体操作：它针对一个免费的 OpenRouter 模型运行 OpenCode，并展示如何在智能体需要时批准新的访问权限。
进一步探索
- 沙箱：镜像、运行时、GPU 和生命周期。
- 策略：文件系统、网络和进程规则，以及用于审查变更的顾问和证明器。
- 提供方：仅在已批准端点生效的凭证，包括推理。
- 网关：沙箱、策略和访问的控制平面。
- Kubernetes：使用 Helm 部署网关。你的 CNI 必须强制执行
NetworkPolicy。 - 可扩展性：中间件、拦截器和计算驱动。
- 教程：策略和智能体的分步演练。
- 预发布和开发构建：试用即将发布的版本或最新提交，位于
main。
智能体技能
为你的编码智能体安装公开的 OpenShell 技能：
npx skills add NVIDIA/OpenShell
这些技能教会你的智能体驱动 OpenShell CLI、编写沙箱策略，以及调试网关和推理路由。它们位于skills/，无需检出 OpenShell 源码即可使用。
SDK
SDK 将应用连接到 OpenShell 网关。它们不会安装 CLI。尽可能让 SDK 和网关使用同一个 OpenShell 版本。
| 语言 | 安装 | 文档 |
|---|---|---|
| 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 issue。
- 路线图： OpenShell Roadmap以及RFC 看板
- 在云端试用： Brev Launchable
OpenShell 以智能体优先构建：它使用与它所赋能的相同的智能体驱动工作流来开发。参见CONTRIBUTING.md了解开发环境搭建和贡献流程，以及AGENTS.md了解仓库编码规范。
遥测
OpenShell 收集匿名遥测数据，仅限于运营类别和计数，以帮助改进项目。它不会收集沙箱名称、主机名、文件路径、提示词、凭据、提供商或模型名称，或用户内容。要禁用它，请在网关上设置OPENSHELL_TELEMETRY_ENABLED=false，或在 Helm 安装时设置server.telemetryEnabled=false。你也可以将遥测完全编译剔除。参见Telemetry了解详情，以及社区遥测报告了解已发布的使用趋势。
声明与免责声明
本软件会自动检索、访问外部材料或与之交互。这些检索到的材料不随本软件分发，仅受单独的条款、条件和许可证约束。您需自行负责查找、审阅并遵守所有适用的条款、条件和许可证，并针对您的具体使用场景核实任何检索到的材料的安全性、完整性和适用性。本软件按“原样”提供，不附带任何形式的保证。作者不对任何检索到的材料作出任何陈述或保证，也不对因您使用或无法使用本软件或任何检索到的材料而产生的任何损失、损害、责任或法律后果承担任何责任。使用本软件及检索到的材料，风险自负。
许可证
本项目依据Apache License 2.0许可。