OpenAI E2B 沙箱

完整实现见Cookbook的应用管理与Webhook管理。

• 应用管理：应用直接创建并连接E2B沙箱。
• Webhook管理：由处理器根据OpenAI事件启动或重连。

两种模式比较见沙箱生命周期。

开始之前

设置 E2B_API_KEY，应用请求使用 OPENAI_API_KEY。OPENAI_EXECUTOR_API_KEY 使用环境密钥，只将它作为 CODEX_API_KEY 传入沙箱。

Webhook 管理

控制器验证OpenAI webhook，为各会话创建独立E2B工作沙箱。凭证、端点注册和签名验证见部署并连接处理器。

持久保存会话与沙箱映射。连接请求到来时，恢复暂停工作沙箱，或替换已删除的沙箱。暂停保留文件，替换不会。为控制器和工作沙箱设置运行超时；停用控制器时删除OpenAI侧webhook。

应用管理

使用E2B SDK或API：

1. 创建自托管会话，保存环境ID。
2. 创建与会话工作目录一致的隔离E2B沙箱，并安装Codex CLI。
3. 用环境ID和环境密钥在沙箱启动执行器。
4. 按运行与继续会话发送输入并检查轮次结果。
5. 结束后分别删除会话与停止E2B沙箱。

沙箱寿命和执行器命令超时分别配置。命令没有超时，不代表过期沙箱会继续运行。

参考

• E2B文档。
• E2B Python SDK。
• E2B TypeScript SDK。