模板

概述#

模板库为你提供一组精选的 Agent 配置模板——包括官方维护的和社区贡献的。每个模板封装了经过验证的模型设置、技能、工具和工作区文件，可一键部署到任何兼容的 Agent。

每次部署都会经过安全流水线：兼容性校验确保模板与目标 Agent 平台匹配；试运行预览展示即将发生的变更；部署后检查确认 Agent 运行正常。如果出现异常，自动回滚会恢复之前的配置。

前置条件#

使用反馈#

打开模板页面后，你将看到：

• -模板卡片网格，显示名称、作者、分类和可见性（官方或社区）
• -模板详情页，包含变量定义、兼容性要求和部署历史
• -部署预览面板，以 diff 形式展示应用模板后目标 Agent 的变更内容
• -部署后状态指示，显示成功或失败，失败时提供一键回滚选项

Web 端操作#

从侧边栏「生产力」分组进入模板页面。

模板库

模板库以卡片网格展示所有可用模板。使用可见性切换在官方和社区模板间筛选，支持按名称或关键词搜索、按分类过滤。每张卡片展示模板名称、简介、作者和部署按钮。

模板详情

点击模板卡片进入详情页。你可以查看完整描述、变量列表（含类型和默认值）、兼容性要求（支持的平台和最低 Agent 版本），以及历次部署记录。

部署预览

部署前，点击「部署」打开预览面板。填入必填变量——值会自动进行类型转换（字符串、数字、布尔值）。预览通过试运行生成一份 diff 视图，对比 Agent 当前配置与应用模板后的结果。确认无误后再执行部署。

部署后检查

部署完成后，ClawButler 自动对目标 Agent 执行健康检查。成功状态表示 Agent 已使用新配置正常运行。如果检测到异常（Agent 不健康或配置错误），部署会被标记为失败，并提供一键回滚以恢复上一版本。

CLI 端操作#

列出所有可用模板，支持分类和可见性过滤

$ ap template list

查看指定模板的完整详情，包括变量和兼容性信息

$ ap template show <id>

部署前检查模板与目标 Agent 的兼容性

$ ap template validate <id> --agent <agent_id>

使用 dry-run 预览部署变更（去掉 --dry-run 即为正式部署）

$ ap template deploy <id> --agent <agent_id> --dry-run

常见问题#