Skip to main content

​
Concepts

Understand the core concepts of ClawAgora: templates, agents, instances, and the marketplace.

​
Templates

Templates are the foundation of ClawAgora. A template defines a pre-configured OpenClaw workspace that can be used to create new instances.

​
What is a Template?

Think of a template as a “blueprint” or “starter kit” for your AI agent workspace. It includes:
  • Pre-installed dependencies and tools
  • Configuration files
  • Default prompts and instructions
  • Environment setup

​
Template Features

  • Pre-configured environments - Start with all the tools you need
  • Version control - Templates can be updated while preserving your data
  • Sharing - Publish templates to the marketplace for others to use
  • Customization - Extend and modify templates to fit your needs

​
Using Templates

# List available templates
clawagora template list

# Use a template to create an instance
clawagora instance create --template my-template

​
Agents

Agents are AI assistants that run within your instances. They can perform tasks, answer questions, and interact with tools based on their configuration.

​
What is an Agent?

An agent is like a digital worker that lives in your instance. It has:
  • Access to tools and APIs
  • Memory of past conversations
  • Instructions on how to behave

​
Agent Lifecycle

  1. Created - Agent is instantiated from a template
  2. Stopped - Agent is paused but data is preserved
  3. Running - Agent is active and processing requests
  4. Deleted - Agent and all its data are removed

​
Managing Agents

# Start an agent
clawagora instance start <instance-id>

# Stop an agent
clawagora instance stop <instance-id>

# View logs
clawagora instance logs <instance-id> --follow

​
Instances

An instance is a running environment where your agent operates. It’s the compute resource that powers your AI workspace.

​
What is an Instance?

An instance is like a virtual computer that runs your agent. It provides:
  • Compute resources (CPU, memory)
  • Persistent storage
  • Network access
  • Isolation from other instances

​
Instance Specifications

SpecDescription
OCPUsVirtual CPU cores allocated to your instance
MemoryRAM available for your agent
StoragePersistent disk space for data and files

​
Marketplace

The ClawAgora Marketplace is where users can discover, share, and sell workspace templates.

​
Marketplace Features

  • Discover - Browse thousands of community templates
  • Rate & Review - Share feedback on templates you’ve used
  • Sell - Monetize your templates (coming soon)
  • Free & Paid - Choose from free or premium templates

​
Becoming a Seller

To sell templates on the marketplace:
  1. Verify your account
  2. Create high-quality templates
  3. Set your pricing
  4. Publish and promote

​
How They Relate

The relationship between templates, agents, and instances:
  1. Template → A blueprint that defines what your workspace looks like
  2. Agent → The AI worker that runs in your instance
  3. Instance → The actual running compute resource
Flow: You start with a template, which creates an agent when you create an instance. The instance provides the resources, and the agent provides the intelligence. 
Template → Agent → Instance
Example workflow:
  1. Choose a template (e.g., “Developer Assistant”)
  2. Create an instance using that template
  3. The instance runs an agent based on the template
  4. Interact with your agent to get work done