OpenAI Blaxel 沙箱

完整实现见 Cookbook 的应用管理与Webhook管理示例。共用执行器安装及连接要求见自托管沙箱。

选择资源创建模式：

• 应用管理：由应用启动和停止沙箱。
• Webhook管理：部署处理器，由OpenAI事件启动或重新连接沙箱。

两者比较见沙箱生命周期。

开始之前

准备OpenAI项目API密钥、Blaxel API密钥与工作区，以及Codex CLI包。

设置 BL_API_KEY、BL_WORKSPACE，应用请求使用 OPENAI_API_KEY。OPENAI_EXECUTOR_API_KEY 使用独立环境密钥，只将此密钥作为 CODEX_API_KEY 传入沙箱。

在资源创建代码选择区域；需要下文Agent Drive持久化时，使用 us-was-1。

1. 配置 Blaxel 环境

创建自托管会话，保存环境ID。用Blaxel SDK或API创建工作目录匹配的隔离沙箱，安装Codex CLI，再以环境ID和环境密钥启动执行器。

Blaxel Node镜像使用Alpine Linux，需用 apk 安装 ripgrep。只向执行器进程传入 CODEX_API_KEY。设置 keep_alive=True，防止执行器运行期间沙箱缩容到零；为初始化、执行器及沙箱设置有限超时，避免遗留资源无限运行。

常规使用可构建已安装Codex和ripgrep的镜像，缩短连接前等待。

2. 运行会话

Blaxel执行器连接后，用运行与继续会话的HTTP示例发送输入并读取结果流。结束后分别删除会话和停止提供商沙箱。

先启动沙箱再提交输入。轮次等待环境连接，事件流通过 agent.session.environment.connected 报告连接。

以 agent.session.turn.completed 判断轮次成功。失败或取消后也可能出现 agent.session.idle，不能把空闲当作成功证明。

可选：跨会话持久保存文件

使用 Blaxel Agent Drive，在各沙箱挂载同一驱动器，跨沙箱、跨会话保存和共享文件。它要求 us-was-1，不会迁移对话历史或会话状态。

参考

• Blaxel沙箱文档。
• Blaxel Python SDK。
• Blaxel TypeScript SDK。