OpenClaw 模板 - Function Compute

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	`fc-e2b-registry.cn-beijing.cr.aliyuncs.com/runtime/openclaw:v0.0.44`
cn-shenzhen	`fc-e2b-registry.cn-shenzhen.cr.aliyuncs.com/runtime/openclaw:v0.0.44`
ap-southeast-1	`fc-e2b-registry.ap-southeast-1.cr.aliyuncs.com/runtime/openclaw:v0.0.44`
cn-hongkong	`fc-e2b-registry.cn-hongkong.cr.aliyuncs.com/runtime/openclaw:v0.0.44`
cn-shanghai	`fc-e2b-registry.cn-shanghai.cr.aliyuncs.com/runtime/openclaw:v0.0.44`
cn-hangzhou	`fc-e2b-registry.cn-hangzhou.cr.aliyuncs.com/runtime/openclaw:v0.0.44`

推薦構建規格：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 參數

參數	說明
`--allow-unconfigured`	無需完整設定檔即可啟動
`--bind lan`	綁定 `0.0.0.0`（E2B 連接埠代理必需）
`--auth token`	啟用 Token 鑒權
`--token`	鑒權 Token（通過 URL `?token=` 傳遞）
`--port`	監聽連接埠（預設 `18789`）

環境概覽

專案	規格
作業系統	Debian
OpenClaw 路徑	`/home/user/.openclaw/bin/openclaw`
內建 Node	v22.x（`/home/user/.openclaw/tools/node/bin/node`）
預設使用者 / 工作目錄	`user` / `/home/user`

Skill 能力約定

範圍	路徑	Source 標識
Workspace	`/home/user/.openclaw/workspace/skills/<name>/SKILL.md`	`openclaw-workspace`
Managed	`/home/user/.openclaw/skills/<name>/SKILL.md`	`openclaw-managed`
Bundled	隨 OpenClaw 安裝內建	`openclaw-bundled`

Skill 擴充完整樣本見使用 OpenClaw Sandbox。

Function Compute：OpenClaw 模板