strands-agents/box

这是什么？

核心功能

• 01通过操作系统隔离限制智能体的文件、程序和网络访问。
• 02使用 Dogwood 编写的默认拒绝 permit 与 forbid 规则进行判断。
• 03Shell、Python、网络和 MCP 调用共享同一策略引擎和事件历史。
• 04按请求方法和路径检查出站连接与 HTTP 请求。
• 05注入 API 凭证或 AWS SigV4 签名，智能体无法接触真实密钥。
• 06以 OTLP JSON 格式记录策略决定。

适用场景

• 运行不应读取密钥或随意访问外部主机的编程类智能体。
• 限制智能体可调用的外部 API 及允许使用的 HTTP 方法。
• 在让智能体完成授权请求的同时，把 API 密钥挡在其进程之外。
• 通过策略决定日志审计智能体的操作尝试。

快速上手

1. 1

   运行 README 中的官方下载脚本

2. 2

   检查已安装的版本

   ./box-core/box --version
3. 3

   克隆代码仓库

   git clone https://github.com/strands-agents/box.git
4. 4

   从源码构建 box 二进制文件

   cargo build --release -p strands-box -p strands-box-containment

使用前须知

• !目前为预览版，仅支持在搭载 Apple 芯片的 macOS 上本地运行。
• !入门指南还需要 Node.js 22.21 或更高版本，以及在 us-west-2 区域访问 Amazon Bedrock 上的 Claude Opus 5。

收录于专题

标签

常见问题

box 是什么？

面向 AI 智能体的开源沙箱引擎，限制其可执行、读写和访问网络的范围，默认拒绝。 Strands Box 为 AI 智能体提供操作系统级沙箱，并通过 Dogwood 语言编写的语义策略控制其行为。文件、程序和网络的直接访问权限在 box.toml 中配置，policy.dw 中的规则则根据操作参数、先前动作和经过的时间决定是否允许。策略引擎默认拒绝未被 permit 规则允许的操作，forbid 规则优先级更高。

box 可以免费使用吗？用的什么许可证？

box 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

box 还在维护吗？

活跃维护中。box 最近一次提交是在 2026年11月6日。

box 适合用来做什么？

运行不应读取密钥或随意访问外部主机的编程类智能体。 限制智能体可调用的外部 API 及允许使用的 HTTP 方法。 在让智能体完成授权请求的同时，把 API 密钥挡在其进程之外。 通过策略决定日志审计智能体的操作尝试。

box 怎么安装和运行？

运行 README 中的官方下载脚本 检查已安装的版本: ./box-core/box --version 克隆代码仓库: git clone https://github.com/strands-agents/box.git 从源码构建 box 二进制文件: cargo build --release -p strands-box -p strands-box-containment

在哪里获取 box？

源代码和安装说明在 GitHub 上：https://github.com/strands-agents/box