需要为团队提供统一的 Agent 模板、办公助手和实例管理入口时，可以在 Agent 集群上部署 AgentWay。管理员先准备服务和模板，使用者再通过 AgentWay 控制台创建自己的 Agent 实例。
开始前准备
准备项 | 检查内容 |
Agent 集群 | 已创建节点池，节点就绪，具有可用计算资源。 |
管理权限 | 当前账号能够查看目标集群并部署组件。 |
网络 | 节点能访问制品和镜像仓库，Agent 能访问业务需要的模型、工具和存储。 |
模型配置 | 已准备模型服务地址、实际可用的模型名称和调用凭证。 |
访问方式 | 管理员和使用者所在网络可以访问相应的控制台及 Agent 实例入口。 |
模型名称应使用模型服务实际支持的标识，不能只填写便于展示的名称。凭证保存在服务或模板的配置中，不放进用户任务描述。
第一步：一键部署
1. 登录 Agent Runtime 控制台，在集群总览选择目标地域，进入目标集群详情。
2. 查看访问方式中的 AgentWay，进入部署操作。已部署时直接使用现有入口，无需重复安装。
3. 在部署页面核对目标集群并完成配置，提交一键部署。
4. 等待部署完成，再打开该集群的 AgentWay 控制台入口。
5. 登录 AgentWay，确认能够进入 Agent 实例页面。
部署尚未完成或没有生成访问地址时，先查看部署状态和错误信息，检查资源与镜像访问条件。
第二步：为团队准备模板
管理员在 AgentWay 中准备应用模板，配置运行环境、镜像、模型以及需要的工具。首次使用可选择办公助手教程中的 OpenClaw 模板。
发布模板供团队使用前，核对以下内容：
模板使用目标 Agent 集群的运行资源，镜像能正常拉取和启动。
模型服务地址、模型名称与凭证对应，具备所需的调用额度。
工具只获得业务所需权限，文件写入约定的工作目录。
需要保留的文件使用持久化工作区，并明确实例删除后的数据处理方式。
使用者可以选到模板，并具有创建实例的权限。
第三步：验证使用者能够完成任务
1. 使用准备好的模板创建一个测试 Agent 实例，等待实例运行。
2. 打开该实例的访问地址，确认使用者所在网络能够访问。
3. 按办公助手快速入门提交一段虚构会议记录，检查是否生成准确的纪要和待办，再在同一会话追加修改。
4. 如果业务需要执行代码或读写文件，另行检查工具执行记录、进程结果和保存的文件。
AgentWay 控制台用于管理实例；实例访问地址用于打开具体助手，两者需要分别验证。实例显示运行中、页面能够打开、业务任务成功是三个不同的检查结果。
日常管理与配置变更
在 Agent 实例 中查看实例状态、所有者和访问入口。出现异常时，先确定受影响的是单个实例还是整个服务，再检查实例日志、节点容量、模型和工具配置。
修改模板、模型或工具配置后，先创建测试实例验证，再安排团队使用。不要默认模板变更会立即更新已有实例；已有实例需单独核对配置和使用结果。
排查问题
现象 | 处理方式 |
AgentWay 部署未完成 | 检查组件状态、节点容量、镜像拉取与网络。 |
控制台打不开 | 检查服务地址、访问网络、域名和证书。 |
能登录但看不到模板 | 检查模板是否已发布以及当前账号权限。 |
实例运行中但助手打不开 | 检查该实例的访问地址、路由、证书和访问凭证。 |
助手无法回复 | 检查模型名称、服务地址、凭证及调用额度。 |
工具执行失败 | 检查执行权限、依赖网络、工作目录和工具日志。 |
