跳转到内容
openma

在 E2B 沙箱上自托管

E2B 把每个 Session 放进一个托管的 Firecracker 微虚机里运行。它是 Node 自托管最简单的托管后端：一个 API key 即可，无需自建基础设施，并且提供提供商侧的内存快照用于挂起/恢复。

前置条件

Section titled “前置条件”
Terminal window
E2B_API_KEY=          # 必需
SANDBOX_IMAGE=        # 用作 Environment 镜像的 E2B 模板引用

对于 E2B 兼容端点，连接信息同样留在环境变量映射中：

Terminal window
E2B_API_URL=          # 或 E2B_SANDBOX_URL / E2B_DOMAIN，视部署而定
OMA_E2B_TEMPLATE=     # 显式模板覆盖

配置

Section titled “配置”

在独立的 Node 服务器上，直接选择该适配器：

Terminal window
SANDBOX_PROVIDER=e2b
E2B_API_KEY=...
SANDBOX_IMAGE=...

若要改为把驱动嵌入运行时宿主（Runtime Host）组合，使用 @open-managed-agents/managed-runtime-e2b 提供的 createE2BManagedRuntime / createE2BManagedRuntimeDriver：

const driver = createE2BManagedRuntimeDriver({
  leaseTtlMs: 90_000,
  environment: {
    E2B_API_KEY: process.env.E2B_API_KEY!,
    SANDBOX_IMAGE: process.env.SANDBOX_IMAGE!,
  },
});

工厂还接受按作用域求值的 environment 函数、显式 outputStore（null 关闭 S3 默认）、credentialEgress、sessionInputs、runtimeEnvironment、context，以及测试用的 provider 接缝。

能力

Section titled “能力”
Harness 通道ama_worker、openma_supervised
suspendResume支持（提供商内存快照）
工作区retained_runtime + checkpoint_restore，持久
输出final_collect，持久（配置后为 S3 存储）
进程检查点无
凭证出口默认 unsupported/snapshot