概述

AX 提供预置模版，帮助您免去准备容器镜像、启动命令和服务端口等工作，快速创建并访问 AI 应用。

不同预置模版可以对应不同的应用类型和访问方式。创建并发布后，AX 会根据所选模版自动生成默认 Endpoint，您无需手动配置代码运行参数或首次访问入口。

说明

当前版本仅提供 OpenClaw 预置模版。该模版属于 Web 应用，系统会为其生成 WebUI 类型 Endpoint，因此需要通过浏览器打开 Endpoint 访问地址；“在线测试”仅适用于接口类型的应用。

前提条件

开始操作前，请确认已完成以下准备工作：

• 已开通 AX，并进入目标工作空间。
• 当前账号具有创建和管理 AI 应用的权限。
• 如所选模版需要调用模型，已创建可用的模型代理，并在模型代理中配置所需模型。
• 如果需要使用 API Key 保护应用访问，已在 权限管理 > 调用凭证 中创建 API Key。

如果应用还需要使用 MCP Server、Skill、VPC 内资源或 CFS 文件系统，请提前准备对应资源。首次体验时，可以暂不配置这些可选能力。

操作步骤

1. 进入 AI 应用创建页

1. 登录 AX 控制台，选择目标工作空间。
2. 在左侧导航栏选择 核心资源 > AI 应用。
3. 单击 创建 AI 应用。

2. 选择预置模版并填写基本信息

1. 在创建方式中选择 预置模版。
2. 在 预置镜像 区域选择 openclaw-latest。
3. 在 AI 应用名称 中输入应用名称。
4. 按需填写 描述，说明应用用途或使用场景。

当前版本仅支持 openclaw-latest。后续 AX 增加其他预置模版后，可根据业务场景选择相应模版；具体运行配置和访问方式以所选模版为准。

3. 配置运行资源

在 资源配置 区域，建议保留 使用平台推荐配置。每个预置模版可以提供与自身运行要求匹配的 CPU、内存、磁盘、执行超时时间和最小实例数，适合首次创建和功能验证。

当前可用模版的推荐配置如下。不同模版或模版版本的推荐值可能不同，请以控制台实际展示为准。

如果取消勾选 使用平台推荐配置，可以根据实际负载自定义资源：

• 对访问时延敏感的业务，建议将最小实例数设置为 1。
• 提高 CPU 和内存规格通常能够提升复杂任务的处理能力，但也会增加资源消耗。
• 执行超时时间不应短于应用完成一次典型任务所需的时间。

4. 配置入站访问凭证

在 入站访问凭证 区域选择访问 AI 应用时的身份认证方式。

如需使用 API Key：

1. 在 入站身份认证 中选择 API Key。
2. 在 API Key 下拉列表中选择已创建的调用凭证。
3. 如果列表中没有目标凭证，进入 权限管理 > 调用凭证 创建 API Key，返回创建页后单击刷新按钮。

警告

“不鉴权”仅适用于受控环境中的临时验证，不建议用于生产环境。

5. 配置模型和其他高级能力

展开 高级配置，根据所选模版的依赖配置模型和其他平台能力。当前可用模版需要调用模型，建议关联模型代理并选择默认模型。

关联模型代理和默认模型

1. 在 关联平台资源 > 模型代理 中选择已创建的模型代理。
2. 在 默认模型 中选择应用默认调用的模型。

AX 会分别通过 AX_MODEL_PROXY_NAME 和 AX_MODEL_NAME 环境变量，将模型代理和默认模型信息注入应用运行环境。如果列表中没有目标资源：

1. 单击字段右侧的刷新按钮重新加载。
2. 检查模型代理是否已创建。
3. 检查模型代理中是否已配置可用模型。

按需配置其他能力

6. 创建并发布 AI 应用

1. 检查页面中的必填项是否均已配置。
2. 单击页面底部的 创建并发布。
3. 创建请求提交成功后，页面返回 AI 应用列表。
4. 在列表中查看应用状态。平台将依次完成构建和部署两个环节。

1构建中 -> 等待运行（构建成功）-> 部署中 -> 运行中
2   |                              |
3   +-> 构建失败                   +-> 部署失败

应用创建和启动需要一定时间。根据所处阶段（构建阶段、部署阶段），列表中可能显示以下状态：

7. 访问或测试 AI 应用

预置模版创建并发布后，AX 会自动生成一个指向当前应用版本的默认 Endpoint，无需再手动创建首次访问入口。应用的验证方式取决于 Endpoint 类型：

当前版本提供的 openclaw-latest 属于 Web 应用，默认生成 WebUI 类型 Endpoint。请按以下步骤访问：

1. 在 AI 应用列表中找到刚创建的应用。
2. 确认应用已完成部署，然后单击应用名称进入详情页。
3. 选择 版本与访问 页签。
4. 在 Endpoint 列表中找到系统自动生成的默认 Endpoint。
5. 确认 Endpoint 的 类型 为 WebUI，并且已关联当前发布版本。

6. 根据访问环境选择地址：

   • 从公网浏览器访问时，使用 公网访问地址。
   • 从已接入相同 VPC 的环境访问时，可以使用 内网访问地址。

说明

WebUI Endpoint 面向浏览器页面访问，不属于“在线测试”支持的接口类型。仅当所选模版生成 API 类型 Endpoint 时，才使用“在线测试”。

验证结果

完成以上操作后，通过以下检查项确认应用创建成功：

• AI 应用已出现在列表中，且未显示部署失败或构建失败。
• 应用详情页能够正常打开。
• 版本与访问 > Endpoint 中存在系统自动生成的默认 Endpoint。
• 默认 Endpoint 已关联当前发布版本，类型与所选模版匹配。
• WebUI 类型应用可以通过匹配当前网络环境的访问地址打开页面；API 类型应用可以通过在线测试获得正常响应。
• 应用能够正常访问，且已配置的模型和扩展能力符合预期。

以上检查均通过后，表示已使用预置模版完成 AI 应用创建和验证。

配置说明

不同 Endpoint 类型的区别

常见问题

创建页面中没有可用的预置模版怎么办？

请确认已选择 预置模版，而不是“自定义代码创建”。如果预置镜像区域为空，请刷新页面；问题仍然存在时，请联系平台管理员检查预置模版是否已在当前区域发布。当前版本正常情况下会展示 openclaw-latest。

创建完成后应该打开访问地址还是使用在线测试？

请进入 版本与访问 > Endpoint 查看默认 Endpoint 类型：

• 类型为 WebUI 时，直接在浏览器中打开访问地址。
• 类型为 API 时，进入“在线测试”进行会话测试或接口测试。

OpenClaw 中模型代理访问不通？

请确认是否开启了模型代理入站鉴权，若开启了鉴权，需自行在 OpenClaw 中配置模型代理对应的访问凭证。