概述

本文档详细说明如何在AgentWorks控制台中创建一个 Agent 实例。创建流程分为两步：

1. 配置信息 — 填写实例的各项配置参数
2. 确认订单 — 核对配置与费用后提交创建

前置条件

在创建实例前，请确保已完成以下准备工作：

• 已开通百度智能云账号并完成实名认证
• 已创建所需的 VPC 和子网（或使用默认私有网络）

• 已创建安全组并配置好访问规则

  • 如需要访问OpenClaw，安全组需要开通18789端口
• 如需通过 API 网关访问，请提前创建好网关实例和 Agent 服务
• 如需通过 API 网关绑定模型服务，请提前在 API 网关中创建好 Model 服务

操作入口

1. 登录 AgentWorks 控制台
2. 在左侧导航栏选择 Agent 管理 > Agent 列表
3. 点击页面左上角的 「创建实例」 按钮
4. 进入创建 Agent 实例页面

第一步：配置Agent信息

付费及地域

1. 选择付费方式

选项	说明
按量付费	先使用后付费，按小时计费，适合短期测试或弹性使用场景
包年包月	预付费模式，支持月/年购买，长期使用更优惠

2. 选择当前地域

目前仅支持华北 - 北京

注意事项：

• 地域一旦选定，创建后不可更改
• 不同地域之间的内网不互通
• 建议选择距离业务用户最近的地域以降低访问延迟

3. 可用区

根据所选地域，选择具体的可用区。可用区选项会根据地域动态变化。

基础配置

1. 设置Agent 名称

为实例设置一个名称，创建后不支持修改

命名规则：

• 小写字母开头，支持小写字母、数字、-、.，长度2-64
• 示例：agent-demo、agent-prod-01

2. 有序后缀

开启后，批量创建实例时自动追加从 0001 开始的递增编号。例如：

• 名称设为 my-agent，购买 3 台
• 生成实例名：my-agent0001、my-agent0002、my-agent0003

有序后缀范围为 0001 - 9999，最多支持一次创建 9999 台同名实例。

3. 选择Agent 规格

选择Agent实例的计算规格，目前支持以下规格：

• du.e1.c2m4.50（系统盘50Gib）
• du.e1.c4m8.100（系统盘100Gib）
• du.e1.c8m16.200（系统盘200Gib）

4. 选择镜像

请根据实际需求选择，目前仅提供公共镜像，默认选择最新的公共镜像

目前支持的公共镜像版本：24.04 LTS amd64（64bit）

建议：优先选择最新版本的公共镜像，可获得最新功能和安全补丁。

网络配置

私有网络

1. 设置所在网络：选择 VPC 和子网

VPC：选择实例所在的私有网络，如果您没有创建私有网络，可以选择默认私有网络。

子网：选择 VPC 下的子网。请确保子网中有足够的可用 IP。

2. 安全组：选择安全组类型和具体安全组

类型	说明
普通安全组	适用于一般场景，规则数量有限制
企业安全组	适用于大规模部署，支持更多规则条目

注意事项：如需要访问OpenClaw，则所选择的安全组需要开通18789端口

重要提示：安全组是在服务器外部做防护。如果服务器本身有防火墙（如 Linux 的 iptables），则需要在防火墙中做相应设置。请在实例创建后，根据实际访问需求添加或修改访问规则。

Agent访问方式

• 方式一：通过API网关访问

选择已有 API 网关和 Agent服务，将会为您自动创建托管路由，该方式不提供Agent访问公网能力，如需访问公网请前往SNAT自行配置

配置项：

字段	是否必填	说明
网关实例	必填	选择API网关实例，该网关实例vpc需和Agent实例vpc保持一致
Agent服务	必填	选择网关中创建好的Agent服务
路径Path	必填	此处仅作路径展示，暂不支持用户修改，该Agent API由DuClaw企业版自动创建，请勿自行在 API 网关侧操作

• 方式二：直接通过公网地址访问 Agent 的场景

购买弹性公网 IP，该方式自动支持Agent访问公网

1. 设置公网IP名称

购买弹性公网IP，支持直接通过公网地址访问 Agent。 EIP 名称支持大小写字母、数字、中文以及-_/.特殊字符，必须以字母或者中文开头

2. 购买公网带宽

公网带宽支持以下购买方式：

• 按使用流量计费：根据用户实际传输的数据量计费，流量使用没有上限，但可限定最大峰值带宽。
• 按使用带宽计费：根据用户选择的固定带宽值进行计费，最大可购买500Mbps的带宽。

模型配置

配置 Agent 实例使用的大语言模型连接方式。

• 方式一：API网关

选择通过网关接入Agent所使用的模型服务，该方式需要先创建一个API网关实例，同时需要设置好后端模型以及Model服务，具体操作可以查看最佳实践。

配置项：

字段	是否必填	说明	示例
网关实例	必填	选择API网关实例，该网关实例vpc需和Agent实例vpc保持一致，同时该网关需要支持私网访问	—
Model服务	必填	选择网关中创建好的Model服务	—
模型名称	必填	模型的显示名称	glm-5
上下文窗口	必填	模型支持的上下文长度（Token）	198000
最大 Token	必填	单次生成最大 Token 数	131072
消费者授权	必填	支持新建或者绑已有消费者，用于网关鉴权，新建消费者将在 API 网关中创建消费者并自动授权该Model服务，请勿自行在 API 网关侧修改该消费者信息	—

• 方式二：自定义接入点

直接配置模型 API 地址，适用于使用第三方或自建模型服务的场景。

配置项：

字段	是否必填	说明	示例
模型名称	必填	模型的显示名称	glm-5
模型 ID	可选	不填时使用模型名称	—
API Key	必填	模型服务的认证密钥	sk-xxxxxxxx
Base URL	必填	模型 API 地址	https://api.example.com/v1
上下文窗口	必填	模型支持的上下文长度（Token）	198000
最大 Token	必填	单次生成最大 Token 数	131072

• 方式三：星点

通过星点模型服务接入，配置项与自定义接入点相同。

• 方式四：千帆平台

通过百度千帆大模型平台接入，配置项与自定义接入点相同。

Skill 空间绑定

绑定 Skill 空间后，Agent 实例可以使用对应空间内的所有 Skill。

操作方式：

1. 点击下拉框，展开空间列表
2. 可通过搜索框按名称或 Key 过滤
3. 点击空间名称进行选择/取消选择
4. 已选空间以标签形式展示在输入框中，点击标签上的 × 可移除

管理设置

设置登录凭证：设置实例的管理员登录密码

字段	说明
管理员名称	固定为 root，不可修改
密码	设置登录密码
确认密码	再次输入密码确认

密码规则：

• 长度：8 - 32 位字符
• 支持大写字母、小写字母、数字和特殊符号，符号仅限()`~!@#$%^&*-_+=|{}[]:;'"<>,.?/，以上四种字符类型中必须包含三项。

支付设置

1. 设置购买时长

预付费实例支持设置购买时长，支持1-9月，1-5年。

2. 预付费实例支持开启自动续费，若Agent访问方式选择通过公网IP访问，则支持合并开通续费EIP。
3. 设置购买数量

字段	说明
数量范围	1 - 100 台
默认值	1

第二步：确认订单

费用确认

在创建实例页面右侧固定栏会实时显示配置费用，点击「明细」可查看完整费用明细和合计金额。

提交订单

确认无误后点击 「确认下单」 按钮，进入管理控制台的实例列表处，可查看实例的状态。

• 创建时，实例状态为创建中。
• 创建成功后，实例状态显示为运行中。

常见问题

Q：创建实例后可以修改地域吗？

A：不可以。地域在创建时确定，如需更换地域，需要删除实例后在目标地域重新创建。

Q：忘记了实例密码怎么办？

A：可通过控制台的「重装系统」功能重置密码，但此操作会清除实例内的所有数据，请提前做好备份。

Q：一次最多可以创建多少台实例？

A：单次最多创建 100 台实例。

Q：如果需要修改模型配置怎么办？

A：可通过控制台的「重装系统」功能重置模型配置，但此操作会清除实例内的所有数据，请提前做好备份。