E2B Sandbox

当任务需在 E2B sandbox 中运行，而非直接在 OpenClaw 主机上执行时，请使用此技能。

凭证

该技能需要环境变量 E2B_API_KEY。 请在使用前通过 Vault 或环境变量完成配置。

MCPorter 原生配置

仅需注册一次本地 MCP 服务器：

node /home/charl/.openclaw/workspace/skills/e2b-sandbox/scripts/register-mcporter.mjs

该操作将在以下路径写入一条 e2b-sandbox 条目：

~/.openclaw/workspace/config/mcporter.json

随后验证注册结果：

mcporter list e2b-sandbox --schema

主要用法

完成注册后，优先使用 MCP 工具，而非 Shell 封装脚本。

预期的工具名称如下：

• e2b-sandbox.create_sandbox
• e2b-sandbox.list_sandboxes
• e2b-sandbox.get_info
• e2b-sandbox.exec
• e2b-sandbox.host
• e2b-sandbox.set_timeout
• e2b-sandbox.snapshot
• e2b-sandbox.kill

示例低层级调用：

mcporter call e2b-sandbox.create_sandbox --args '{"label":"codex-lab","template":"base","timeoutMs":3600000}'
mcporter call e2b-sandbox.exec --args '{"sandbox":"codex-lab","cmd":"python3 --version"}'
mcporter call e2b-sandbox.host --args '{"sandbox":"codex-lab","port":3000}'

Shell 辅助脚本（备用方案）

为便于调试，或在需要直接调用脚本的环境中，仍保留了一个封装脚本：

/home/charl/.openclaw/workspace/skills/e2b-sandbox/scripts/run-e2b.sh help

注意事项

• Sandbox ID 与标签记录于 ~/.openclaw/workspace/.state/e2b-sandboxes.json。
• 对于耗时较长的任务，建议使用标签（label）命名 sandbox，以便后续步骤可清晰、一致地引用同一 sandbox。
• MCP 服务器为本地运行，底层使用 E2B Node SDK。
• 本辅助工具适用于一次性命令执行。若任务需要长期交互式 PTY 会话，或需基于特定模板的定制化流程，请先阅读 references/e2b-notes.md。
• 若任务依赖自定义镜像或预安装技术栈，请先创建 sandbox / template，再对其执行 snapshot 以供复用。

按需延伸阅读

当遇到以下情形时，请阅读 references/e2b-notes.md：

• 状态文件（state-file）行为说明
• 超时（timeout）与 snapshot 使用建议
• 端口暴露（port exposure）相关提醒
• MCP 工具与 Shell 辅助脚本的适用场景对比