OpenClaw 是开源 Agent 框架，支持 CLI 编程调用与 Gateway Web UI。我们已在各地域 ACR 预置 OpenClaw 镜像，您无需自行推送镜像或配置 ACR EE，选取下方镜像地址，通过 from_image + Template.build 构建模板后即可使用。本页说明镜像规格与构建用法：前置条件、镜像地址、构建 Template、Gateway 参数、环境与 Skill 能力约定；部署 Gateway、Agent CLI、自定义域名浏览器访问、安全模式与 Skill 扩展等场景教程见使用 OpenClaw Sandbox。
首次使用请先完成通过 SDK 使用云沙箱中的前置准备、API Key 创建和 SDK 配置。
前置条件
已完成 SDK 接入（E2B API Key、
api_url、domain）已安装依赖：
pip install e2b==2.31.0 e2b-code-interpreter==2.8.1已准备模型 API Key，创建沙箱时通过
envs注入 — 镜像内不预置中国站：百炼控制台 获取 API Key（
sk-开头）国际站：OpenAI Platform 获取
OPENAI_API_KEY
镜像地址
按地域选取 FROM_IMAGE：
Region | 镜像 |
cn-beijing |
|
cn-shenzhen |
|
ap-southeast-1 |
|
cn-hongkong |
|
cn-shanghai |
|
cn-hangzhou |
|
推荐构建规格：cpu_count=2，memory_mb=4096。
构建 Template
自定义模板需先将镜像构建为 Template，只需执行一次。完成后保存模板名称，后续创建 Sandbox 时直接复用。
以下以北京地域为例：
import time
from e2b import Template, default_build_logger
FROM_IMAGE = "fc-e2b-registry.cn-beijing.cr.aliyuncs.com/runtime/openclaw:v0.0.44"
TEMPLATE_NAME = f"openclaw-{int(time.time())}"
OPTS = {
"api_key": "<你的 E2B API Key>",
"api_url": "https://api.cn-beijing.e2b.fc.aliyuncs.com",
"domain": "cn-beijing.e2b.fc.aliyuncs.com",
}
build = Template.build(
Template().from_image(FROM_IMAGE),
name=TEMPLATE_NAME,
cpu_count=2,
memory_mb=4096,
on_build_logs=default_build_logger(),
**OPTS,
)
print(f"template: {build.name}") # 保存，后续可复用构建完成后控制台模板状态应为 ready。同一模板名称可多次创建 Sandbox，无需每次重新构建。
Template name 命名限制
name 不得使用系统保留前缀 openclaw-v（例如 openclaw-v0.0.37、openclaw-v037-test），否则会报错：
400: invalid template name '...': must not be a system reserved name openclaw-v*推荐使用 my-openclaw-{timestamp} 等自定义名称。以 openclaw- 开头但不含openclaw-v 的名称（如 openclaw-1783153993）通常可用。
Gateway 参数
参数 | 说明 |
| 无需完整配置文件即可启动 |
| 绑定 |
| 启用 Token 鉴权 |
| 鉴权 Token（通过 URL |
| 监听端口（默认 |
环境概览
项目 | 规格 |
操作系统 | Debian |
OpenClaw 路径 |
|
自带 Node | v22.x（ |
默认用户 / 工作目录 |
|
Skill 能力约定
作用域 | 路径 | Source 标识 |
Workspace |
|
|
Managed |
|
|
Bundled | 随 OpenClaw 安装自带 |
|
Skill 扩展完整示例见使用 OpenClaw Sandbox。
相关文档
使用 OpenClaw Sandbox（部署 Gateway、Agent CLI、自定义域名浏览器访问、安全模式、Skill 扩展）