镜像是ArkClaw企业版的“自定义实例蓝图”。企业管理员可基于火山官方公共镜像，通过预置职位人设、平台规范、内置插件、内置技能、初始化启动命令等，构建可复用的自定义镜像；企业员工在创建Claw实例时可一键选用有权限的镜像，复制一致的镜像能力，避免重复搭建。

说明

此功能正在“邀测”中，仅开通后可用，如有需要请联系客户经理申请。

## 操作说明 * 每个ArkClaw空间最多支持创建20个自定义镜像。 * 镜像与[模板](https://www.volcengine.com/docs/87732/2278510)的区别在于镜像包含完整的运行时配置且支持**YAML**构建，模板仅作为部署脚本使用。 * 企业管理员创建的自定义镜像对全部企业员工可见、可使用；企业员工可在Claw实例中修改自定义镜像的名称、描述信息。 ## 创建自定义镜像管理员可基于公共镜像，通过表单配置或YAML编排方式创建自定义镜像。 1. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧导航树中，选择“镜像管理”。 3. 单击页面右上角的“创建镜像”按钮。 4. 参考下表，选择任意一种方式配置镜像信息。

说明

非技术用户推荐表单配置方式，YAML配置方式适用于熟悉 Image Builder 流程的技术用户，可通过声明式 YAML 编排组件、脚本和测试步骤，快速构建自定义镜像。

表单配置 |**参数** |**说明** | |---|---| |配置方式 |选择自定义镜像的配置方式，此处选择**表单配置**。 | |名称 |输入自定义镜像的名称。 | |描述 |输入镜像的描述信息，建议在描述信息中介绍此镜像的适用场景和适用范围，以便后续识别、管理和使用。 | |镜像版本 |展示当前最新的公共镜像版本（仅展示），可单击查看版本基线详情。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f59f7e2906daae5bd57159dfc7d19a83.png) | |职位人设 |配置当前镜像的职位人设（SOUL.md）信息。

* **基于模板**：选择人设类型，直接使用当前镜像内置的人设配置，如：销售专家、运营专家、HR人力资源、财务专家等。

* **自定义**：根据用途输入自定义的信息定义职位人设，明确职位类型、做事风格、回复逻辑等。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3b835a4d60dbf65955a66f401216ea19.png) | |内置插件 |仅“配置方式”为“表单配置”时需配置此参数。

默认展示当前公共镜像的插件，您可根据实际需求勾选/取消勾选相关插件，如果公共镜像的插件不能满足需求，您可单击下拉框下方的“自定义插件”按钮，添加自定义插件。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_8342e8df8bf8dfa97d5bd165f107a16e.png)

说明

自定义插件来源支持NPX和下载地址两种，仅可选择任意一种方式。

NPX：需提供可通过NPX拉取的NPM包名称和插件名称。

下载地址：需提供公开可访问的资源下载地址（支持TOS等对象存储URL）和插件名称。

| |内置技能 |仅“配置方式”为“表单配置”时需配置此参数。选择镜像预装的Skills，支持添加平台已预置技能和企业专属技能，如需使用企业专属技能，请先创建企业专属技能空间并上传技能，具体操作请参见[技能管理](https://www.volcengine.com/docs/87732/2276808)。

**操作步骤**：

1. 在内置技能区域，单击右侧图标展开技能详情页面。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_ca84a855866c53d3c024a2e2b28c06e2.png)

2. 切换页签选择“预置技能”或“企业专属”技能，开启对应技能开关选中技能。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_044dde8b08bc63027cb8acc1971ae9fc.png) | |平台规范 |配置镜像的平台规范（AGENT.md），定义全局行为约束。

单击“查看并编辑”按钮，配置当前镜像的平台规范（AGENT.md）信息。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_78b5a24bbbb07ab63bae7d7f49e0c374.png) | |自定义初始化脚本 |仅“配置方式”为“表单配置”时需配置此参数。配置镜像启动时自动执行的`Linux Shell`命令。 | YAML配置 |**参数** |**说明** | |---|---| |配置方式 |选择自定义镜像的配置方式，此处选择**YAML 配置**。 | |镜像版本 |展示当前最新的公共镜像版本（仅展示），可单击查看版本基线详情。

![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f59f7e2906daae5bd57159dfc7d19a83.png) | |YAML配置 |配置当前镜像的职位人设（SOUL.md）、内置插件、内置技能、平台规范（AGENT.md）等信息。

**配置示例**：

```Python```
```name: DocTest```
```description: "YAML Image Creation Test"```
```plugins:```
``` - id: agent-identity-plugin```
``` name: agent-identity-plugin```
``` display-name: agent-identity-plugin```
``` source: ""```
``` blacklist: false```
``` type: built-in```
``` description: ""```
``` version: 0.8.3```
``` - id: dingtalk-connector```
``` name: dingtalk-connector```
``` display-name: DingTalk Channel```
``` source: ""```
``` blacklist: false```
``` type: built-in```
``` description: Official OpenClaw DingTalk channel plugin```
``` version: 0.8.20```
```skills:```
``` - name: byted-seedance-video-generate```
``` display-name: "U0001F4E6 byted-seedance-video-generate"```
``` description: Generate videos```
``` blacklist: false```
``` slug: ""```
``` type: built-in```
``` - name: byted-seedream-image-generate```
``` display-name: "U0001F4E6 byted-seedream-image-generate"```
``` description: Generate high-quality```
``` blacklist: false```
``` slug: ""```
``` type: built-in```
```soul: "IyBTT1VMCllvdSBhcmUgYSByZWxpYWJsZSBlbnRlcnByaXNlIGFzc2l****"```
```agents: "IyBBR0VOVApGb2xsb3cgdGhlIHBsYXRmb3JtIHJ1bGV****"```

| 5. 配置完成后，单击“确定”按钮，完成镜像创建。 ## 编辑自定义镜像管理员可修改已创建的自定义镜像的基本信息和使用范围。

说明

镜像创建后，其核心配置（职位人设、插件、技能等）已固化，编辑操作仅支持修改名称、描述。如需变更核心配置，建议创建新的自定义镜像。

1. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧导航树中，选择“镜像管理”。 3. 在镜像列表中，找到目标镜像，单击操作列的“编辑”按钮。 4. 在编辑弹窗中，修改镜像的名称、描述。 5. 修改完成后，单击“确定”按钮，完成编辑。 ## 删除自定义镜像信息管理员可删除不再使用的镜像自定义镜像。

注意

删除后镜像将不能使用，且不可恢复，之前已基于此镜像创建的Claw实例使用不受影响。

基于该镜像创建的 ArkClaw 实例将无法恢复出厂设置，请谨慎操作。

1. 登录[ArkClaw企业版控制台](https://console.volcengine.com/arkclaw/enterprise)。 2. 在左侧导航树中，选择“镜像管理”。 3. 在镜像列表中，找到目标镜像，单击操作列的“删除”按钮。 4. 在确认弹窗中，确认无误后单击“确定”按钮，完成删除操作。