沙箱 (Sandbox)

Box Runtime 给内置 Agent 一个统一的执行环境：跑命令、读写文件、运行长驻进程。日常 Agent 应用（数据处理、文件操作、运行用户代码、托管 stdio MCP）都依赖它。Docker、nsjail 和 E2B 后端提供沙箱隔离；显式选择的 Host 后端用于可信本地开发，不提供隔离。 启用 Box 后，内置 Agent 会自动获得六个工具，无需在流水线里逐项开启。

​

内置工具

exec 在所选 Box 后端中运行；其余五个直接读写映射到 /workspace 的工作区目录。选择 Host 时，命令也直接运行在 Box Runtime 主机上。

​

沙箱作用域

在流水线 AI 配置中可选择沙箱在不同消息间如何共享。默认”每个会话”足够大多数场景使用。

​

生命周期

这些生命周期行为也适用于 Host。回收时会终止该会话的托管进程树并移除临时会话目录；映射到 box.local.host_root 的持久工作区不会被当作临时目录删除。Runtime 关闭或显式删除会话时也会执行清理。

​

快速开始

可信的 Linux / macOS 本地开发可以直接选择 Host，不需要安装 Docker：

1. 写入 config.yaml：
   box:
     enabled: true
     backend: 'host'
     local:
       host_root: './data/box'
   
2. 启动 LangBot：Box Runtime 自动启用
3. 在流水线里选择内置 Agent + 支持函数调用的模型

之后 Agent 会自动获得六个工具。详细配置见沙箱配置。

​

关闭 Box

设置 box.enabled: false。所有依赖沙箱的能力（内置工具、Skill 创建/编辑/激活、stdio MCP）会一并停用；http/sse 模式的 MCP 不受影响。

​

下一步

• 沙箱配置 — 后端、安全预设、挂载、环境变量
• 运行时与扩展关系 — 沙箱、Skills、MCP、插件如何分工