文档中心

ArkClaw 企业版

ArkClaw高级功能

管理我的镜像

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

操作说明

配置说明

每个员工默认可创建 10 个自定义镜像，如需提升配额请联系企业管理员申请。

镜像与 Claw 模板的区别在于：镜像包含完整的运行时配置且支持 YAML 构建，Claw模板仅作为部署脚本使用。

企业员工创建的镜像仅支持自己使用，若需要将镜像分享给企业其他员工使用，请联系企业管理员配置该镜像的下发范围。

功能说明

创建自定义镜像支持员工从头创建一个自定义镜像，通过表单配置或 YAML 编排方式，预置基础镜像、插件、技能、人设和配置文件等内容，作为创建 Claw 实例时的可选模板。

复制创建自定义镜像支持企业员工基于已有的自定义镜像快速生成一个新镜像。复制时，来源镜像的配置会自动带入新建流程，可以在此基础上按需修改，无需从零配置。复制创建的新镜像与来源镜像完全独立，后续对任意一方进行修改、发布或删除，均不会影响另一方。

Markdown （下文使用 MD）配置文件用于管理镜像中的系统设定、人设、身份信息和用户配置等内容。创建、复制创建自定义镜像时，可以查看并修改指定类型的 Markdown 配置文件，使镜像更符合企业内部的使用场景和管理要求。

查看我的镜像仅支持查看员工自己创建的镜像，由企业管理员下发的镜像（即创建 Claw 页面预设 Claw 模板中的来自镜像模板）仅支持用于创建 Claw。

查看我的镜像

打开浏览器，在浏览器地址栏中输入登录 ArkClaw 链接，按“回车”键。

切换至目标 ArkClaw 页面后，单击右上角的详情图标。

单击“我的镜像”按钮。

在我的镜像面板中，即可查看当前可用的镜像。

单击目标卡片上的“详情”按钮，即可查看该镜像详情。包含镜像版本、职位人设、内置插件、内置技能等。

（可选）单击目标卡片上的“使用镜像创建Claw”按钮，即可跳转至创建页面基于该镜像创建Claw实例。

创建自定义镜像

操作场景

当预设 Claw 模板无法满足需求时，例如需要为特定岗位、业务线或团队提供标准化的 Claw 使用环境，可以基于公共镜像，通过表单配置或 YAML 编排方式，将基础镜像、插件、技能、环境变量、人设和配置文件等内容打包为可复用的自定义镜像。

操作步骤

在我的镜像面板中，单击“去创建”按钮。

参考下表，选择任意一种方式配置镜像信息。

说明

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

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

表单配置

Yaml配置

参数	说明
配置类型	选择自定义镜像的配置类型，此处选择表单配置。
名称	输入自定义镜像的名称。
描述	输入镜像的描述信息，建议在描述信息中介绍此镜像的适用场景和适用范围，以便后续识别、管理和使用。
镜像版本	展示当前最新的公共镜像版本（仅展示），可单击查看版本基线详情。
MD配置	用于为自定义镜像补充或替换 Markdown 配置内容，您可根据配置需求选择不同方式管理当前镜像的 MD 内容。 MD 配置说明追加内容：在基础镜像原有 MD 配置内容中追加企业自定义的内容，若无可追加内容则无需修改，基础镜像的原有设定保持不变。适用于在继承基础镜像能力基线的前提下，补充企业特有的角色设定、规则或偏好。重写全部：系统会将基础镜像的 MD 配置内容加载到编辑框中，您可以直接修改，也可以全部删除后重新编写。保存后以编辑框中的最终内容为准，不再保留基础镜像的原有配置。适用于需要对 MD 配置进行全面定制的场景。注意选择此方式前，须确认自定义内容已覆盖原有配置中的关键规则，否则可能导致风格一致性和主动解决问题的能力下降，提示注入防护、隐私保护和敏感操作确认等规则也可能失效。 MD 内容说明职位人设（SOUL.md）：用于配置 Claw 的核心角色设定，包括职业定位、工作方式、行为原则和长期稳定的系统规则。该文件决定了 Claw 的整体角色风格和基础行为边界，企业管理员可通过此文件为镜像预置统一的人设配置。平台规范（AGENT.md）：由平台预置的系统级规范，包含提示注入防护、隐私保护和敏感操作确认等安全规则。
内置插件	仅“配置方式”为“表单配置”时需配置此参数。默认展示当前公共镜像的插件，您可根据实际需求勾选/取消勾选相关插件，如果公共镜像的插件不能满足需求，您可单击下拉框下方的“自定义插件”按钮，添加自定义插件。说明自定义插件来源支持NPX和下载地址两种，仅可选择任意一种方式。 NPX：需提供可通过NPX拉取的NPM包名称和插件名称。下载地址：需提供公开可访问的资源下载地址（支持TOS等对象存储URL）和插件名称。
内置技能	仅“配置方式”为“表单配置”时需配置此参数。选择镜像预装的Skills，支持添加企业专属技能、公开技能和平台预置技能。技能类型企业专属：来源于企业管理员上传的专属技能。公开技能：来源于“技能中心 > 技能广场”中的公开技能。预置技能：来源于平台统一预置的基础技能。操作步骤：在内置技能区域，单击“管理技能”按钮。在展开的技能详情页面，选择“企业专属”、“公开技能”或“预置技能”，并在对应页签下开启目标技能开关。
自定义初始化脚本	仅“配置方式”为“表单配置”时需配置此参数。配置镜像启动时自动执行的Linux Shell命令。

参数	说明
配置类型	选择自定义镜像的配置方式，此处选择YAML 配置。
镜像版本	展示当前最新的公共镜像版本（仅展示），可单击查看版本基线详情。
基础镜像	支持基于已有镜像导入json，用于持续迭代。
YAML配置	配置当前镜像的职位人设（SOUL.md）、内置插件、内置技能、平台规范（AGENT.md）等信息。配置示例： 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**"

配置完成后，单击“创建”按钮，完成镜像创建。

注意

镜像创建后，若更新镜像内已添加的技能，仅对后续基于该镜像创建的 Claw 实例生效，已有 Claw 实例不受影响。

复制自定义镜像

操作场景

复制创建适用于需要复用已有自定义镜像配置，但又不希望直接修改原镜像的场景。例如，基于某个部门的标准镜像为另一个部门创建相似配置的镜像，在已有镜像基础上微调插件、技能、人设或配置文件，为镜像配置变更创建一个新的独立版本用于灰度验证或场景隔离，以及保留原镜像稳定可用并探索新的配置组合。

复制创建不是对原镜像进行更新，也不是创建原镜像的版本分支，复制后的镜像是一个新的独立自定义镜像。原镜像与复制后的镜像相互独立，后续任一镜像发生编辑、发布或删除操作，均不会自动影响另一个镜像。

前提条件

已存在可复制的自定义镜像，即已完成创建自定义镜像操作。

操作步骤

在我的镜像面板中，单击目标 Agent 镜像卡片上的“详情”按钮。

选择 YAML 展示，并在 YAML 信息模块，单击“复制并创建”按钮。

在弹出的创建镜像弹框中，参考创建自定义镜像修改镜像配置，单击“确定”按钮，完成操作。

说明

系统会同时复制来源镜像的表单配置和 YAML 配置信息，您可选择其中任意一种方式配置自定义镜像。

编辑自定义镜像

操作场景

当需要调整已有自定义镜像的名称、描述、权限范围时，可以编辑自定义镜像。镜像创建后，其核心配置（职位人设、插件、技能等）已固化，编辑操作仅支持修改名称和描述。如需变更核心配置，请重新创建新的自定义镜像。

前提条件

已存在需要编辑的自定义镜像，即已完成创建自定义镜像操作。

操作步骤

在我的镜像面板中，找到目标镜像，单击“编辑”按钮。

在编辑弹窗中，修改镜像的名称、描述。

修改完成后，单击“确定”按钮，完成编辑。

删除自定义镜像

注意

删除后该镜像无法继续用于创建的 Claw 实例，且不可恢复。已基于该镜像创建的 Claw 实例将不再支持恢复出厂设置操作，请谨慎操作。

在我的镜像面板中，找到目标镜像，单击“删除”按钮。

在确认弹窗中，确认无误后单击“删除”按钮，完成删除操作。

最近更新时间：2026.08.13 19:28:16

这个页面对您有帮助吗？

有用

无用