一、操作场景
注意：说明：
注意：部分功能受站点功能开关、Agent 类型及实例状态等条件影响，具体可用操作以管控端页面展示为准。
二、操作影响
执行以下操作前，请了解其对 Agent 运行、配置、数据和费用的影响。
| 操作 | 影响 |
| 创建 | 创建 Agent 后将产生相应的云资源费用。你可以在创建完成后前往 账单详情 查看。 |
| 关机或重启 | 关机后，Agent 将暂停提供服务，需重新开机才能使用。重启期间服务会暂时中断，重启完成后恢复。 |
| 终端 | 通过终端执行的命令会直接作用于实例。修改系统配置或删除文件等操作可能影响 Agent 的正常运行，请谨慎操作。 |
| 批量更新版本 | 更新期间 Agent 将暂时无法使用。系统仅备份 OpenClaw 状态目录中的数据，其他用户文件不在备份范围内，建议提前备份重要数据。 |
| 重新安装 | 重新安装会清除实例原有的配置和数据，且无法恢复。 安装完成后，需要重新配置模型与通道。企业共享的配置不受影响。 |
| 调整配置 | 升级实例规格或选择关机后扩容时，运行中的 Agent 服务会暂时中断。调整配置将产生额外费用，操作完成后前往 账单详情 查看。 |
| 迁移或移交 | 操作完成后，Agent 的归属用户或所属组织将发生变化，相关配置会根据目标组织的策略进行同步。操作不会改变实例原有的开关机状态。 |
| 续费 | 续费将产生相应费用，并延长实例的到期时间。如果实例已到期但仍在可恢复期内，续费可以恢复原实例，但不会自动开机。 |
| 删除 | 删除 Agent 后无法恢复原实例。 关联的个人网盘将进入回收站，并在保留15天后删除。企业共享配置不会受到影响。 |
| 批量处理 | 批量操作将在后台执行。任务完成后，请查看各实例的执行结果，确认是否存在执行失败的实例。 |
三、前提条件
·已使用管理员账号登录 ClawPro 管控端。
·执行具体操作前，已确认实例状态、Agent 类型、计费模式及依赖条件满足对应章节说明。
四、查看 Agent 状态与实例信息
1. 登录 ClawPro 管控端，在左侧导航栏选择 运维与观测 > Agent 列表。
查看企业 Agent 的运行状态。支持通过搜索、状态筛选等方式快速定位目标 Agent，也可导出实例列表。如下：
2. 单击目标 Agent 的实例 ID，可查看实例规格、计费、网络配置，以及已应用模型、通道和技能等信息。如需进一步管理云服务器，可单击去腾讯云控制台管理。如下：
五、创建并分配 Agent
1. 在 Agent 列表页面，单击创建 Agent。
创建 Agent 会产生底层云资源费用，费用明细可在创建完成后前往 账单详情 查看。
2. 在弹出的创建 Agent 弹窗中，依次设置以下参数。如下：
2.1 在归属步骤设置以下参数：
| 参数 | 是否必选 | 说明 |
| 归属用户 | 是 | Agent 归属的用户。创建后，用户可在其用户端使用和管理该 Agent。 |
| 所属组织 | 条件 | 仅当用户属于多个组织时需要设置，决定 Agent 使用的模型、通道与技能配置。 |
| 购买时长 | 条件 | 仅当所选用户的资源配置为包年包月时显示。默认时长1个月并自动续费。手动指定时长后，该 Agent 采用手动续费，到期后不会自动续费。 |
2.2 单击下一步，在基础信息步骤设置以下参数：
| 参数 | 是否必选 | 说明 |
| Agent 名称 | 是 | 新建 Agent 的显示名称。 |
| Agent 类型 | 是 | Agent 的内核类型，可选范围由管理员在 Agent 类型中配置。 |
| 角色身份 | 否 | 为 Agent 预置角色。仅 OpenClaw 类型生效；未选择时使用通用助手。 |
| 项目 | 否 | 按页面提示选择关联项目。项目与资产管理的完整操作请参见对应文档。 |
2.3 单击下一步，在配置（选填）步骤设置可预置的配置项。
页面会展示当前可预置的配置项，未展示的项可在创建后配置。
| 配置项 | 是否必选 | 说明 |
| 已应用模型 | 否 | 添加主模型、备选模型或单个模型，具体以页面显示为准。创建后可在 Agent 详情中调整。 |
| 已接入通道 | 否 | 添加通道并填写凭证。创建后可在 Agent 详情中调整。 |
| 已安装技能 | 否 | 添加企业技能。创建后可在 Agent 详情中查看。 |
3. 单击确认创建，列表中出现新建的 Agent，状态由创建中变为运行中，归属用户可在其用户端看到并使用该 Agent。
六、Agent 开关机、重启与终端访问
1. 在 Agent 列表页面中找到目标 Agent，可根据实例状态执行以下操作：
·关机：运行中的 Agent，可在操作列单击关机，并在弹窗中确认。
·开机：已关机的 Agent，可在操作列单击开机，并在弹窗中确认。
·重启 Agent：运行中的 Agent，可在操作列选择更多 > 重启 Agent。默认仅重启 Agent Gateway 服务；如需重启实例，可勾选重启云服务器后确认。
·进入终端：运行中的 Agent，可在操作列单击终端，通过新打开的浏览器页面访问实例终端。
注意：终端操作会直接影响实例运行，请谨慎执行修改配置、删除文件等命令。
七、管理实例级模型、通道与技能
模型和通道的添加、编辑、删除仅支持运行中的实例。模型和通道配置仅作用于当前实例，不修改企业在模型配置或通道配置中维护的配置。
1. 在 Agent 列表页面单击目标 Agent 的实例 ID，打开 Agent 详情。
2. 在已应用模型区域管理实例模型。如下：
·单击添加主模型、添加备选模型或添加模型，选择模型厂商和模型名称，确认添加。
·单击模型行的编辑图标，替换当前模型。
·对备选模型单击设为主模型，将其切换为主模型。
·单击模型行的删除图标，删除该模型绑定。
3. 在已接入通道区域管理实例通道。如下：
·单击添加通道，选择通道类型并填写所需凭证，单击确认添加。
·单击已有通道的编辑凭证，修改后保存。
·单击已有通道的删除图标，删除该通道。
·添加 Microsoft Teams 通道时，按页面提示生成并复制 Teams Messaging Endpoint。将 Endpoint 填写到 Azure Bot 或 Teams App 的 Messaging endpoint 中。
注意：通道变更会重启 Gateway，期间 Agent 可能短暂不可用。
4. 在已安装技能区域查看当前实例已安装的技能及数量。
此处仅展示已安装技能。技能的新增、移除或版本调整，请在 Agent 配置 > 技能配置 中处理。
5. 单击右上角的刷新图标，可重新加载详情数据。
八、重新安装 Agent
仅 OpenClaw 类型、运行中或已关机的实例支持重新安装。重新安装与批量更新版本的目的和影响不同，请按场景选择：
| 对比项 | 批量更新版本 | 重新安装 |
| 目的 | 升级到当前生效镜像版本 | 重装系统，恢复初始环境 |
| 入口 | 批量处理 > 批量更新 | 更多 > 重新安装 Agent |
| 版本 | 当前生效镜像，仅升不降 | 最新镜像 |
| 配置和数据 | 保留 ~/.openclaw 状态目录中的配置和数据；实例内其他用户文件不在备份范围 | 清除实例配置和数据；企业共享配置不受影响 |
| 适用范围 | 支持批量，已下线的 LightClaw ACE 除外 | 单实例，仅 OpenClaw 类型 |
| 典型场景 | 日常版本升级 | 故障恢复或彻底重置 |
1. 单击操作列的更多，选择重新安装 Agent。如下：
2. 阅读影响说明，输入重装，单击确认重新安装。
注意：重新安装会使用最新镜像，清除当前所有配置且无法恢复。企业共享的模型、通道、技能配置不受影响。
3. 安装完成后，重新配置模型与通道。
九、调整实例配置
仅云端、运行中或已关机、无其他操作正在进行的实例可调整配置。
1. 在 Agent 列表页面中找到目标 Agent，单击操作列的更多，选择调整配置。
2. 在弹出的调整配置弹窗中选择调整类型，并设置目标配置。如下：
·实例规格升配：选择高于当前规格的目标规格，不支持降配。
·系统盘容量扩容：输入大于当前容量的目标容量，可输入范围以页面提示为准。实例运行中时，可选择在线扩容或关机后扩容。
3. 单击校验，确认校验结果为可调整。若结果为不可调整，按页面提示处理后再重试。
4. 单击开始调整，阅读影响提示并确认。不同调整方式的影响如下：
| 调整方式 | 实例运行状态 | 扩容后处理 |
| 实例规格升配 | 运行中的实例将先关机，升配完成后自动开机。 | 无需额外处理。 |
| 在线扩容 | 实例保持运行，不影响开关机状态。 | 登录终端检查分区和文件系统是否完成扩展，未完成时需手动处理。 |
| 关机后扩容 | 运行中的实例将先关机，扩容完成后自动开机。 | 公共镜像通常在开机后自动扩展分区和文件系统；自定义镜像需登录终端检查，未完成时手动处理。 |
5. 在列表中查看实例的调整状态，并确认调整后的配置信息。
实例先显示调整配置中，完成后恢复为原开关机状态；Agent 详情中的实例规格或系统盘容量已更新。
十、续费与恢复到期 Agent
包年包月的 Agent 支持续费。你可以在到期前续费，也可以在到期后的可恢复期内，通过续费恢复原有实例。
1. 在 Agent 列表页面中找到目标 Agent，单击操作列的更多 > 续费。如果 Agent 已到期且仍可恢复，选择续费并恢复。
2. 在续费弹窗中，选择所需的续费时长，确认续费后的到期时间。
3. 单击确认续费，完成后可在 Agent 列表或详情中查看新的到期时间。
注意：说明：
十一、迁移与移交 Agent
迁移和移交用于用户组织调整、离职交接等场景。操作只改变实例归属或所属组织，不改变实例开关机状态。
1. 在 Agent 列表页面中勾选目标实例，单击组织迁移/移交用户。如下：
按场景选择操作：
·随用户迁移到新组织：将所选实例随当前用户迁移到该用户已加入的目标组织。
·移交给其他用户：将所选实例移交给指定接手用户，并随接手用户迁移到目标组织。
2. 在弹窗中确认待迁移或待移交的实例、目标组织和接手用户。
·迁移要求所选实例属于同一用户，且目标组织是该用户已加入的组织。
·移交支持选择其他用户，可搜索用户 ID 或组织名称。
·可单击查看配置对比，预览实例当前配置与目标组织配置的差异。
注意：说明：
3. 单击确认迁移或确认移交。
列表中的用户 ID 或组织更新为目标用户和目标组织；实例开关机状态保持不变；配置对比中无非预期差异。
十二、删除 Agent
1. 在 Agent 列表页面中找到目标 Agent，单击操作列的删除。
2. 根据弹窗提示完成确认后，单击确认删除即可。
十三、批量处理与任务跟踪
在 Agent 列表页面中勾选需要操作的云端 Agent，单击批量处理，选择对应操作。
十四、发起批量操作
·批量更新版本：选择批量更新，核对目标版本并确认。仅支持运行中的 Agent 升级至当前生效的镜像版本，不支持降级。已是最新版本的实例无需重复更新。
·批量配置模型：选择批量配置模型，为同一类型的运行中 Agent 统一设置主模型及备选模型，确认后提交。新配置将替换原有模型配置，未选择的旧模型不会保留。
·批量关机、开机：选择对应操作并确认。批量关机仅适用于运行中的 Agent，批量开机仅适用于已关机的 Agent。
·批量调整配置：选择批量调整配置，按页面提示设置目标配置并提交。正在调整或执行其他操作的实例将被跳过。
·批量删除：选择批量删除，核对实例后输入删除并确认。删除操作不可撤销，请提前备份重要数据。
十五、查看批量任务执行结果
1. 批量操作提交后，可在 Agent 列表上方的批量任务执行区域查看任务进度。
2. 单击任务对应的详情，查看各实例的执行结果。如果存在执行失败的实例，可根据失败原因进一步处理。
注意：说明：
注意：批量任务默认展示最近7天的记录。任务显示已完成，并不代表所有实例均执行成功，请以各实例的执行结果为准。
十六、相关操作
·基础使用指南
·管控端功能介绍
·用户端功能介绍