📦 Sandbox Manager — 沙盒管理器

沙箱管理 Skill 百度 Agent Sandbox 沙箱创建和管理技能，支持快速创建、连接、管理沙箱实例。

核心功能 ✅ 快速创建沙箱实例（支持多种模板） ✅ 查询沙箱状态和信息 ✅ 连接已有沙箱实例 ✅ 沙箱生命周期管理（创建、启动、停止、销毁） ✅ 自动配置 API Key 和环境

沙箱模板说明 模板名称 | 用途 | 特性 code_test | 代码执行沙箱 | 支持多语言代码执行、终端操作 browser_use | 浏览器自动化沙箱 | 支持浏览器操作、网页测试 aio | All-In-One 全栈沙箱 | 浏览器 + 代码执行 + 终端 coding_agent | 编码助手沙箱 | 内置 Zulu、Ducc 等 DevOps 工具

快速开始

• 首次使用 – 配置 API Key

获取 API Key： 访问 OneTool 沙箱管理页面 → 创建团队或个人空间 → 进入空间后在『沙箱』模块点击『API Key 管理』 → 获取你的 API Key

配置 API Key： # Agent 会自动将 API Key 写入 ~/.env 文件 # 格式如下： E2B_API_KEY= E2B_DOMAIN=agent-sandbox.baidu-int.com

• 安装依赖

pip3.9 install e2b==1.11.2+baidu --index=https://pip.baidu-int.com/simple/ pip3.9 install e2b-code-interpreter==1.5.2 --index=https://pip.baidu-int.com/simple/ pip3.9 install load_dotenv==0.1.0 --index=https://pip.baidu-int.com/simple/

使用方式 方式一：通过 Agent 自然语言创建 直接对 Agent 说： “创建一个沙箱，模板使用 code_test” “帮我创建一个浏览器沙箱” “创建一个 aio 沙箱，时长 2 小时” Agent 会自动：检查 API Key 配置 → 安装必要依赖 → 创建沙箱实例 → 返回沙箱访问地址和 ID

方式二：通过命令行创建 cd ~/.openclaw/workspace/skills/sandbox-manager python3.9 scripts/create_sandbox.py --template code_test --timeout 3600

核心命令 创建沙箱 from e2b_code_interpreter import Sandbox from dotenv import load_dotenv load_dotenv() sbx = Sandbox( timeout=3600, template="code_test", metadata={ "agent-sandbox/creator": "caojiao", "agent-sandbox/name": "my-sandbox" } ) print(f"沙箱ID: {sbx.sandbox_id}") print(f"管理页面: https://8080-{sbx.sandbox_id}.agent-sandbox.baidu-int.com/")

连接已有沙箱 from e2b_code_interpreter import Sandbox sbx = Sandbox(sandbox_id="al7hwm9s") result = sbx.commands.run("ls -la") print(result.stdout)

查询沙箱信息 info = sbx.get_info() print(f"沙箱ID: {info.sandbox_id}") print(f"模板: {info.template_id}") print(f"过期时间: {info.end_at}") print(f"日志链接: {info.metadata.get('logURL')}")

销毁沙箱 sbx.kill() # 立即销毁

沙箱能力

• 代码执行

result = sbx.run_code(language="python", code="print('Hello, World!')") result = sbx.commands.run("git clone ...")

• 文件操作

sbx.files.write("test.txt", "Hello, Sandbox!") content = sbx.files.read("test.txt") files = sbx.files.list(path=".", depth=2)

• 服务暴露

沙箱内启动的服务自动暴露： http://{port}-{sandboxId}.agent-sandbox.baidu-int.com 示例： sbx.commands.run("python -m SimpleHTTPServer 8080", background=True) 访问地址：http://8080-{sandboxId}.agent-sandbox.baidu-int.com

API 参考 Sandbox 参数 参数 | 类型 | 说明 | 默认值 timeout | int | 沙箱存活时间（秒），最大 86400（1天） | 600 template | str | 沙箱模板名称 | 必填 sandbox_id | str | 已有沙箱ID（用于连接） | 可选 metadata | dict | 沙箱元数据 | 可选 envs | dict | 环境变量 | 可选 request_timeout | int | 请求超时时间（秒） | 600

常用方法 sbx.commands.run(cmd) sbx.files.read(path) sbx.files.write(path, content) sbx.files.list(path) sbx.run_code(language, code) sbx.get_info() sbx.kill()

注意事项 沙箱存活时间：最大 1 天（86400 秒），超时自动销毁 计费：不同规格沙箱产生不同费用，注意运行时长 权限注入：需提供 COMATE_AUTH_TOKEN 才能访问 iCode 等内部服务 网络访问：沙箱出站流量受限（白名单机制） 数据持久化：沙箱销毁后数据丢失，重要数据需提前保存

相关链接 沙箱管理平台 沙箱使用文档 API Key 管理 用户交流群：群号 12143597 联系人：苏琳 (sulin01@baidu.com) 杨文才 (yangwencai@baidu.com)

创建时间：2026-04-29 创建人：caojiao 的数字助手 雀雀