文档中心

ArkClaw 企业版

管理员管理ArkClaw

镜像管理

自定义镜像是 ArkClaw 企业版的“自定义实例蓝图”，用于将 ArkClaw 的基础镜像、插件、技能、人设与配置文件等能力封装为可复用的镜像模板。企业管理员可以创建、复制、编辑和管理自定义镜像，企业员工可基于可见的自定义镜像创建或更新 Claw 实例。

操作说明

配置说明

ArkClaw 空间默认可创建 200 个自定义镜像，每个员工 Claw 默认可创建 10 个自定义镜像，如需提升配额请联系客户经理申请。

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

自定义镜像的可见范围由管理员创建时配置的“权限范围”决定（默认“全量开放”，即对全部企业员工可见、可使用）；管理员可随时通过“管理下发人员”调整可见范围。企业员工可在 Claw 实例中修改自定义镜像的名称、描述信息。

功能说明

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

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

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

创建自定义镜像

操作场景

当企业需要为员工提供统一的 Claw 实例初始配置时，可以创建自定义镜像。自定义镜像可预置基础镜像、插件、技能、环境变量、人设和配置文件等内容，适用于为不同部门、岗位或业务线提供标准化 Claw 使用环境，将常用插件、技能和配置沉淀为可复用模板，以及统一管理员工创建 Claw 实例时可选择的镜像范围。

前提条件

已完成用户/部门导入操作。如需按部门下发镜像，需提前配置部门结构，详细操作请参考管理用户组、管理部门。

说明

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

操作步骤

在左侧导航树中，选择“镜像管理”。

单击“创建镜像”按钮，参考下表，选择任意一种方式配置镜像信息。

说明

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

表单配置

YAML 配置

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

参数	说明
配置方式	选择自定义镜像的配置方式，此处选择 YAML 配置。
镜像版本	展示当前最新的公共镜像版本（仅展示），可单击查看版本基线详情。说明企业管理员可在 ArkClaw 控制台“运维管理 > 批量运维”中“版本管理”页签下查看最新公共镜像的版本并更新至最新版本。
权限范围	配置该镜像的下发范围，默认为“全量开放”。全量开放：镜像对全部员工可见、可使用，允许所有人使用。受控访问：对指定的部门、用户组或用户开放此镜像，仅有权限的员工可见、可使用。说明当生效范围为「全员、部门、用户组」时，后续新增成员会自动继承该权限规则。全量禁止：镜像对所有人均不可见，不允许任何人使用。
YAML 信息	选择已创建的自定义镜像，直接导入该镜像的 YAML 配置信息。
YAML 配置	配置当前镜像的职位人设（SOUL.md）、内置插件、内置技能、平台规范（AGENT.md）等信息。配置示例： 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**"

配置完成后，单击“确定”按钮，完成镜像创建，企业管理员可随时修改镜像权限，具体操作请参见管理下发人员。

注意

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

复制自定义镜像

操作场景

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

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

前提条件

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

操作步骤

在左侧导航树中，选择“镜像管理”，在镜像列表中，单击待复制镜名称。

在镜像详情页，单击右上角“复制镜像”按钮，参考创建自定义镜像修改镜像配置，单击“确定”按钮，完成操作。

说明

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

编辑自定义镜像

操作场景

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

前提条件

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

操作步骤

在左侧导航树中，选择“镜像管理”。

在镜像列表中，找到目标镜像，单击操作列的“编辑”按钮。

在编辑弹窗中，修改镜像的名称、描述和权限范围信息。

修改完成后单击“确定”按钮，完成操作。

管理下发人员

操作场景

自定义镜像创建后仅有权限的员工可见。当自定义镜像仅适用于部分员工、部门或项目成员时，可以通过管理下发人员控制镜像可见范围。例如，为数据分析团队下发数据分析镜像，为研发团队下发研发辅助镜像，或在灰度验证阶段仅向指定员工开放新镜像。

下发人员配置仅影响员工是否可以查看和使用该镜像，不会修改镜像本身的配置内容。已获得下发权限的员工可以在创建 Claw 实例时选择该镜像；未获得下发权限的员工无法在可选镜像列表中查看该镜像。

说明

移除下发人员后，已基于该镜像创建的 Claw 实例不受影响仍可正常使用，但后续无法使用该镜像创建新的 Claw 实例。

前提条件

已存在需要管理下发范围的自定义镜像，即已完成创建自定义镜像操作。

操作步骤

在左侧导航树中，选择“镜像管理”。

在镜像列表中，单击目标镜像名称。

在“下发人员”页签，单击“管理下发人员”按钮。

管理下发人员，完成后单击“确定”按钮，完成操作。

添加下发人员：在管理下发人员页面选择权限范围，如果是“受控访问”还需选择目标员工或部门。

移除下发人员：在管理下发人员页面，单击目标员工或部门操作列的“移除”按钮。

删除自定义镜像信息

操作场景

当自定义镜像配置不再适用、存在重复镜像，或已由新的镜像替代时，可以删除该自定义镜像。删除前，建议确认该镜像是否仍被员工使用，避免影响后续创建 Claw 实例的流程。

注意

删除镜像后的影响如下：

镜像将不能使用，且不可恢复，之前已基于此镜像创建的 Claw 实例可正常使用。

基于该镜像创建的 Claw 实例将无法恢复出厂设置，相关说明见 Claw 实例恢复出厂设置。

操作步骤

在左侧导航树中，选择“镜像管理”。

在镜像列表中，找到目标镜像，单击操作列的“删除”按钮。

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

最近更新时间：2026.08.13 11:42:40

这个页面对您有帮助吗？

有用

无用