All Products
Search

This Product

    Function Compute:OpenClaw Template

    Document Center

    Function Compute:OpenClaw Template

    Last Updated:Sep 20, 2026

    OpenClaw is an open-source agent framework that supports CLI-based programmatic invocation and a Gateway Web UI. We have pre-built OpenClaw images in Container Registry (ACR) across all regions, so you don't need to push images or configure ACR EE yourself. Simply select an image address below and build a template using from_image + Template.build to get started. This page covers image specifications and build usage: prerequisites, image addresses, building a Template, Gateway parameters, and environment and Skill capability notes. For scenario tutorials such as deploying Gateway, Agent CLI, custom-domain browser access, security mode, and Skill extension, see Use OpenClaw Sandbox.

    If this is your first time, complete the prerequisites, API Key creation, and SDK setup described in Use FC Agent Sandbox with the SDK.

    Prerequisites

    • Completed SDK integration (E2B API Key, api_url, domain)

    • Installed dependencies: pip install e2b==2.31.0 e2b-code-interpreter==2.8.1

    • Prepared a model API Key to inject via envs when creating a sandbox — the images do not include pre-configured keys

    Image Addresses

    Select FROM_IMAGE by region:

    Region Image
    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

    Recommended build specifications: cpu_count=2, memory_mb=4096.

    Build Template

    A custom template requires building the image into a Template first — this only needs to be done once. Save the template name for reuse when creating sandboxes later.

    The following example uses the Beijing region:

    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": "<your 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}")   # Save for later reuse

    After the build completes, the template status in the console should be ready. You can create multiple sandboxes from the same template name without rebuilding each time.

    Template Name Restrictions

    The name must not use the system-reserved prefix openclaw-v (e.g., openclaw-v0.0.37, openclaw-v037-test), otherwise the following error will occur:

    400: invalid template name '...': must not be a system reserved name openclaw-v*

    Custom names such as my-openclaw-{timestamp} are recommended. Names starting with openclaw- that do not contain openclaw-v (e.g., openclaw-1783153993) are generally acceptable.

    Gateway Parameters

    Parameter Description
    --allow-unconfigured Start without a complete configuration file
    --bind lan Bind to 0.0.0.0 (required for E2B port proxy)
    --auth token Enable token authentication
    --token Authentication token (passed via URL ?token=)
    --port Listening port (default 18789)

    Environment Overview

    Item Specification
    Operating System Debian
    OpenClaw Path /home/user/.openclaw/bin/openclaw
    Bundled Node v22.x (/home/user/.openclaw/tools/node/bin/node)
    Default User / Working Directory user / /home/user

    Skill Capability Notes

    Scope Path Source Identifier
    Workspace /home/user/.openclaw/workspace/skills/<name>/SKILL.md openclaw-workspace
    Managed /home/user/.openclaw/skills/<name>/SKILL.md openclaw-managed
    Bundled Shipped with the OpenClaw installation openclaw-bundled

    For complete Skill extension examples, see Use OpenClaw Sandbox.

    Related Documents