镜像是ArkClaw企业版的“自定义实例蓝图”。您可以在我的镜像中查看管理员创建的自定义镜像，也可基于火山官方公共镜像，通过预置职位人设、平台规范、内置插件、内置技能、初始化启动命令等，构建可复用的自定义镜像。同时，您也可以在[创建Claw实例](https://www.volcengine.com/docs/87732/2430993)时可一键选用有权限的镜像，复制一致的镜像能力，避免重复搭建。 ## 查看我的镜像 1. 打开浏览器，在浏览器地址栏中输入登录ArkClaw链接，按“回车”键。 2. 切换至目标ArkClaw页面后，单击右上角的详情图标。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_20772b9a8eea532e16f923d8e116a388.png) 3. 单击“我的镜像”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_883ca25ed6a500dc4dc7bc22cff8b398.png) 4. 在我的镜像面板中，即可查看当前可用的镜像信息。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a0961883ff02182ca452620a37282ac7.png) ## 创建自定义镜像您可以基于公共镜像，通过表单配置或YAML编排方式创建自定义镜像。 1. 单击我的镜像面板中的“去创建”按钮。 2. 参考下表，选择任意一种方式配置镜像信息。

说明

表单配置和YAML两种配置方式相互映射，可随时切换，修改任一方均会同步更新另一方。

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

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

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

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

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

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

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

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

说明

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

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

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

| |内置技能 |仅“配置方式”为“表单配置”时需配置此参数。选择镜像预装的Skills，支持添加已预置技能和公开技能。

**操作步骤**：

1. 在内置技能区域，单击“管理技能”按钮。

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

2. 在展开的技能详情页面，选择“预置技能”或“公开技能”页签，开启对应技能开关选中技能。

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

**配置示例**：

```Python```
```name：企业版通用开发镜像＃必填，镜像名称（4-64字符）```
```description：预装常用开发工具、技能插件，统一团队开发环境＃可选，镜像描述（0-200字符）```
```name: DocTest #必填，镜像名称（4-64字符）```
```description: "YAML Image Creation Test" #可选，镜像描述（0-200字符）```
```# 可选，插件配置列表```
```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配置（base64编码，最大5KB）```
```soul-md:" c291bC1tZGFyayBLomNvZGVkIGNVbn****"```
```# 可选，Agent配置（base64编码，最大5KB）```
```agent-md: "YwdlbnQgbWQgYmFzZTYOIGVuY29kZWQgY29udG****"```
```# 可选，实例启动脚本（base64编码，最大12KB）```
```build-script: "aW5pdCBzY3JpcHQgYmFzZTYOIGVuY****"```

| 3. 配置完成后，单击“创建”按钮，完成镜像创建。 ## 编辑自定义镜像镜像创建后，其核心配置（职位人设、插件、技能等）已固化，编辑操作仅支持修改名称和描述。如需变更核心配置，建议创建新的自定义镜像。 1. 在我的镜像面板中，找到目标镜像，单击“编辑”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_64e1b2ce37badde193f326c3d1061c91.png) 2. 在编辑弹窗中，修改镜像的名称、描述。 3. 修改完成后，单击“确定”按钮，完成编辑。 ## 删除自定义镜像

注意

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

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

1. 在我的镜像面板中，找到目标镜像，单击“删除”按钮。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_88ced440a718c3234fa74e0d205bf859.png) 2. 在确认弹窗中，确认无误后单击“删除”按钮，完成删除操作。