操作场景
本文介绍如何通过 ClawPro 管控端配置 Agent 类型与镜像。管理员可定义用户创建 Agent 时可选择的类型及其运行镜像，并维护镜像版本更新策略，从而实现对 Agent 运行环境的灵活管控。
支持以下三种管理任务：
扩展可用类型：平台预置类型不满足业务需求时，添加兼容现有内核或完全自研的 Agent 类型。
调整用户可选范围：控制类型的用户可见状态、用户端首选类型及应用范围。
维护镜像与版本：切换类型的启用镜像、设置版本更新模式、导入自定义镜像，并查看版本更新记录。
注意事项
镜像：每个类型同时仅启用一个，公共镜像不支持删除。
用户可见：关闭后该类型不在用户端展示，设为首选后不可再关闭。
首选类型：用户端创建 Agent 时的默认选中类型，仅支持已开启用户可见的类型。
适用范围：本文配置仅影响新建或重装 Agent 时使用的镜像版本，不会自动升级或重启已有 Agent（已有实例可通过一键更新或批量更新单独发起升级）。
前提条件
已使用管理员账号登录 ClawPro 管控端。
导入自定义镜像前，已在腾讯云云服务器控制台 创建镜像，且镜像大小不超过50GiB。
操作步骤
登录 ClawPro 管控端，在左侧导航栏选择 Agent 启动配置 > Agent 类型，进入 Agent 类型页面。以下操作均在该页面完成：
添加自定义 Agent 类型
1. 在 Agent 类型页面中，单击右上角的+ 添加自定义 Agent 类型。
2. 在弹出的添加自定义 Agent 类型弹窗中，填写以下字段：
类型名称：Agent 类型的唯一标识，最多15个字符，仅支持英文字母、数字、连字符和下划线。
兼容内核：选择与目标类型一致的内核。可选：
兼容 OpenClaw / Hermes Agent / DeepSeek Harness：与对应内核完全兼容，管控台功能与对应内核保持一致。
自定义内核 / 不兼容上述已知类型：完全自研，与上述已知内核均不兼容，部分功能不可用。
说明：
自定义内核的 Agent 类型存在以下限制，建议在添加前验证管控台功能可用性：
用户端需要登录终端配置模型、通道和技能，不支持管控台快捷配置。
管控端的 Agent 工具库、记忆管理、网盘管理、运维观测、AI Agent 安全、会话管理等功能不可用。
3. 单击添加，新增类型出现在 Agent 类型列表中，表示添加成功。
配置用户可见、首选类型与应用范围
1. 在列表中找到目标 Agent 类型，打开或关闭用户可见开关。
2. 单击目标类型的设为首选，将该类型设为用户端默认选中的 Agent 类型。
3. 单击应用范围列的编辑图标，打开应用范围选择器。
说明：
应用范围与用户可见是两个独立配置项。应用范围用于限定 Agent 类型的适用用户，用户可见用于控制该类型是否在用户端展示。
4. 按需选择以下一种方式：
全部用户：将 Agent 类型的应用范围设置为全部用户。
按组织：在 搜索组织… 输入框中搜索并勾选目标组织，支持多选。
5. 单击确认完成设置。
切换启用镜像
1. 在列表中找到目标 Agent 类型，单击切换。
2. 在弹出的切换镜像窗口中，查看当前用户可见镜像。
3. 在候选列表中选择目标镜像，可按需切换公共镜像和自定义镜像页签，或单击刷新更新列表。如下图所示：
4. 单击确认切换，返回 Agent 类型列表，核对目标类型的当前启用镜像是否已变为所选镜像。
设置 Agent 版本策略
1. 在列表中找到目标 Agent 类型，在 Agent 版本列单击版本模式下拉框。
2. 按需选择：
自动更新：无需指定具体版本，新建或重装 Agent 时使用当前启用镜像的最新可用版本，已有 Agent 不会自动升级。
指定版本：需在请选择版本下拉框中指定目标版本。新建或重装时使用该版本，已有 Agent 不会自动变更。
管理自定义镜像
1. 在列表中找到目标 Agent 类型，在镜像列中，按需操作：
为新建的 Agent 类型选择镜像：单击去选择
切换已有 Agent 类型的镜像：单击切换
2. 在弹出的切换镜像弹窗中，切换至自定义镜像，单击右上角的导入自定义镜像。
3. 弹出导入自定义镜像弹窗，如下图所示：
阅读自定义镜像说明后，填写以下参数：
参数 | 是否必选 | 说明 | 示例 |
选择镜像 | 是 | 从腾讯云已有镜像中选择，镜像大小不超过50GiB | my-agent-image |
Agent 类型 | 是 | 镜像所属的 Agent 类型，按当前类型选择 | OpenClaw |
Agent 版本 | 是 | 自定义镜像的版本号，格式如2026.4.2，按类型校验 | 2026.4.2 |
4. 填写完成后，单击导入。
5. 导入完成后，自定义镜像出现在列表中。
如需启用该镜像，选择该镜像并单击确认切换。
如需修改镜像信息，单击该镜像行的编辑，修改 Agent 类型或 Agent 版本后单击保存。
如需移除镜像，单击该镜像行的删除，删除后该镜像从列表中移除。
注意：
删除自定义镜像不会删除您在腾讯云控制台中创建的镜像，您可按需重新导入。
查看版本更新记录并推送更新提醒
1. 在 Agent 类型页面中，单击右上角的版本更新记录。
2. 按 Agent 类型筛选记录，查看各镜像的版本演进、当前最新版本和更新时间。
3. 如需提醒用户更新，单击对应类型的推送最新版本。该操作只发送更新提醒，不直接执行 Agent 实例升级。如下图所示：
