常见问题

这里说明目录里每种 provider 状态代表什么，以及下一步怎么做。命令里的尖括号要换成你自己的值。密钥不要写进仓库。

alicloud-express

状态是「可安装构建」时，用极速版把这个目录做成平台模板。

abx template install alibaba-agent-sandbox/awesome-templates//<name>
abx create --template <name>

<name> 就是目录名，例如 browser-automation。安装会构建镜像并注册。创建时用的就是这个名字，不需要另外找一串模板 id。

CLI 只加载极速版。abx --provider 换成别的 provider 会得到 E8001。

状态是「已有模板 id 才能创建」时，这个目录不会自动出现在容器版集群里。模板 id 是 sandbox-manager 上已经登记的名字。

查看集群里有哪些 id，用你们集群的 sandbox-manager 控制台或它的模板列表接口。确认 id 之后：

await Sandbox.create(
    provider="alicloud-container",
    template="<集群里的模板 id>",
)

环境变量是 ABX_ALICLOUD_CONTAINER_DOMAIN 和 ABX_ALICLOUD_CONTAINER_API_KEY。不要把极速版的 ABX_SANDBOX_API_KEY 填到这里。

同样要先有 CubeAPI 上的模板 id。默认地址是 http://127.0.0.1:3000。id 来自 Cube 自己的模板或镜像登记，不是本目录的文件夹名。

await Sandbox.create(provider="cubesandbox", template="<Cube 上的模板 id>")

可选密钥是 ABX_CUBESANDBOX_API_KEY。没设置时不发送认证头。Cube 上没有交互终端，声明了 terminal 的模板不能在这里开 PTY。

E2B 的模板 id 是账号里已经构建好的名字。公开的有 base、code-interpreter-v1、desktop，以及 E2B 文档里的 opencode、amp、droid。本仓库的目录名不会自动变成这些 id。

列出你账号里的 id：

export ABX_E2B_API_KEY="<你的 E2B 密钥>"
# 旧名 E2B_API_KEY 和极速版密钥都不会被这个 provider 读取

await Sandbox.create(provider="e2b", template="<E2B 模板 id>")

要得到一个新 id，用 E2B 自己的 Template.build，不要用 abx template install。

状态是「需要先推送镜像」时，OpenSandbox 认的是镜像地址，不是本目录的名字。先构建并推到它能拉到的仓库，再把地址传给创建接口。

docker build -t registry.example.com/agent-sandbox/<name>:1 .
docker push registry.example.com/agent-sandbox/<name>:1

await Sandbox.create(
    provider="opensandbox",
    template="registry.example.com/agent-sandbox/<name>:1",
)

短名字 code-interpreter、desktop、playwright、vscode 已经对应 Docker Hub 上的官方镜像，不用再推一次。desktop 这类镜像创建后容器只保持运行，桌面或编辑器进程要按 OpenSandbox 示例再启动。

密钥是 ABX_OPENSANDBOX_API_KEY，地址是 ABX_OPENSANDBOX_BASE_URL。

模板 README 里的「中文版 / English」是页内锚点。标题里的中文现在会保留成锚点，刷新后即可在同一页跳转。