USER MANUAL · PRODUCTIVITY

Templates

Browse verified agent configuration templates, preview changes before deploying, and roll back if anything goes wrong.

/templates

Overview#

The Templates gallery gives you a curated library of agent configuration templates — both official (maintained by ClawButler) and community-contributed. Each template packages a proven set of model settings, skills, tools, and workspace files that you can deploy to any compatible agent in one click.

Every deployment goes through a safety pipeline: compatibility validation ensures the template matches your agent's platform, a dry-run deploy preview shows exactly what will change before anything is applied, and post-deploy checks verify the agent is healthy after the update. If something goes wrong, automatic failure rollback restores the previous configuration.

Prerequisites#

Prerequisites

At least one connector synced (see Connectors)
At least one agent discovered (see Agents)

Expected Results#

After navigating to the Templates page, you will see:

-Template gallery grid with cards showing name, author, category, and visibility (official or community)
-Template detail page with variable definitions, compatibility requirements, and deployment history
-Deploy preview panel showing a diff of what will change on the target agent before applying
-Post-deploy status indicating success or failure, with a rollback option if the deployment caused issues

Web Operations#

Navigate to the Templates page from the sidebar under Productivity.

Template Gallery

The gallery displays all available templates in a card grid. Use the visibility toggle to switch between official and community templates. Search by name or keyword, and filter by category to narrow results. Each card shows the template name, a short description, author, and a deploy button.

Template Detail

Click a template card to open its detail page. Here you can review the full description, the list of variables (with types and default values), compatibility requirements (supported platforms, minimum agent version), and a history of previous deployments.

Deploy Preview

Before applying a template, click Deploy to open the preview panel. Fill in any required variables — values are type-coerced automatically (strings, numbers, booleans). The preview runs a dry-run that generates a diff view comparing the agent's current configuration with the result of applying the template. Review the changes carefully before confirming.

Post-Deploy Checks

After deployment, ClawButler runs automated health checks on the target agent. A success status confirms the agent is running with the new configuration. If the checks detect a failure (agent unhealthy or configuration errors), the deployment is flagged and you are offered a one-click rollback to restore the previous state.

CLI Operations#

List all available templates with optional category and visibility filters

Terminal

$ ap template list

View full details of a specific template including variables and compatibility

Terminal

$ ap template show <id>

Check whether a template is compatible with a target agent before deploying

Terminal

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

Preview deployment changes with dry-run (omit --dry-run to apply)

Terminal

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

FAQ#

Q: What is the difference between official and community templates?

A: Official templates are maintained and tested by the ClawButler team. Community templates are contributed by users and reviewed before publication. Both go through compatibility validation before deployment.

Q: Can I roll back a template deployment?

A: Yes. If post-deploy checks fail, you are offered an automatic rollback. You can also manually revert via Config Versions, which keeps a snapshot of every configuration change.

Q: What happens to my custom agent settings when I deploy a template?

A: The deploy preview shows a full diff so you can see exactly which settings will be overwritten. Template variables allow you to customize key parameters before applying. Any settings not covered by the template remain unchanged.