操作场景
本文介绍企业管理员如何在 ClawPro 管控端创建、配置和维护 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。
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. 在已应用模型区域管理实例模型。如下图所示：
单击添加主模型、添加备选模型或添加模型，选择模型厂商和模型名称，确认添加。
单击模型行的编辑图标，替换当前模型。
对备选模型单击设为主模型，将其切换为主模型。
单击模型行的删除图标，删除该模型绑定。
注意：
切换主模型或删除主模型会重启 Gateway 服务，期间 Agent 短暂不可用。
删除主模型时，系统会自动将最早的备选模型提升为主模型；删除最后一个模型后，实例将没有可用模型，需重新添加。
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 无需续费，已销毁或超过恢复期限的 Agent 无法续费。
对已到期的 Agent 进行续费，可以恢复原有实例及其数据，但不会自动开机。如需继续使用，请确认实例状态并按需开机。
迁移与移交 Agent
迁移和移交用于用户组织调整、离职交接等场景。操作只改变实例归属或所属组织，不改变实例开关机状态。
1. 在 Agent 列表页面中勾选目标实例，单击组织迁移/移交用户。如下图所示：
按场景选择操作：
随用户迁移到新组织：将所选实例随当前用户迁移到该用户已加入的目标组织。
移交给其他用户：将所选实例移交给指定接手用户，并随接手用户迁移到目标组织。
2. 在弹窗中确认待迁移或待移交的实例、目标组织和接手用户。
迁移要求所选实例属于同一用户，且目标组织是该用户已加入的组织。
移交支持选择其他用户，可搜索用户 ID 或组织名称。
可单击查看配置对比，预览实例当前配置与目标组织配置的差异。
说明：
单次迁移最多500台实例；单次移交最多5000台实例。
迁移或移交后，系统会按新组织异步同步实例资产（技能、规范、MCP、模型等），通道配置不在同步范围。
实例原有配置是否保留，以配置对比和实际同步结果为准，后续配置以新组织策略为准。
如实例已关机，迁移或移交后仍保持关机。
3. 单击确认迁移或确认移交。
列表中的用户 ID 或组织更新为目标用户和目标组织；实例开关机状态保持不变；配置对比中无非预期差异。
删除 Agent
1. 在 Agent 列表页面中找到目标 Agent，单击操作列的删除。
2. 根据弹窗提示完成确认后，单击确认删除即可。
注意：
删除 Agent 后，对应的云服务器及实例内数据将被清除，且无法恢复。请在操作前确认不再需要该 Agent，并提前备份重要数据。
创建中、加载中、待处理、升级中、升级失败或销毁中的 Agent 暂不支持删除。
删除 Agent 不会影响企业共享的模型、通道和技能配置。关联的个人网盘将进入回收站，保留15天后删除。
批量处理与任务跟踪
在 Agent 列表页面中勾选需要操作的云端 Agent，单击批量处理，选择对应操作。
发起批量操作
批量更新版本：选择批量更新，核对目标版本并确认。仅支持运行中的 Agent 升级至当前生效的官方镜像版本，不支持降级。已是最新版本的实例无需重复更新。
批量配置模型：选择批量配置模型，为同一类型的运行中 Agent 统一设置主模型及备选模型，确认后提交。新配置将替换原有模型配置，未选择的旧模型不会保留。
批量关机、开机：选择对应操作并确认。批量关机仅适用于运行中的 Agent，批量开机仅适用于已关机的 Agent。
批量调整配置：选择批量调整配置，按页面提示设置目标配置并提交。正在调整或执行其他操作的实例将被跳过。
批量删除：选择批量删除，核对实例后输入删除并确认。删除操作不可撤销，请提前备份重要数据。
注意：
批量更新期间，Agent 将暂时无法使用。更新会备份并恢复 ~/.openclaw 状态目录，其他用户文件不在备份范围内，请提前备份重要数据。
批量更新还要求 Agent 类型支持升级、模型配置可用、磁盘空间充足，且实例没有其他操作正在进行。
单次批量更新、配置模型、调整配置或删除最多支持 5,000 台实例。
查看批量任务执行结果
1. 批量操作提交后，可在 Agent 列表上方的批量任务执行区域查看任务进度。
2. 单击任务对应的详情，查看各实例的执行结果。如果存在执行失败的实例，可根据失败原因进一步处理。
说明：
批量任务默认展示最近7天的记录。任务显示已完成，并不代表所有实例均执行成功，请以各实例的执行结果为准。
相关操作
基础使用指南
管控端功能介绍
用户端功能介绍
