User asks to find, discover, or browse AI agents → use search
User asks to install or add an agent → use install
User asks to publish or share their agent → use publish flow
User asks what agents they have → use list
User asks to update agents → use update
User asks to create a new agent package → use init

Commands

Search for agents

clawstore search "productivity"
clawstore search "code review"

Returns a list of matching agents with scope, name, and description.

Get agent details

clawstore info @scope/agent-name

Shows the full description, version, download count, rating, and category.

Install an agent

# Latest version
clawstore install @scope/agent-name

# Specific version
clawstore install @scope/agent-name@1.2.0

Downloads the agent package and sets it up in the local OpenClaw workspace.

List installed agents

clawstore list

Shows all locally installed agents with their versions and update policies.

Check for updates

clawstore update

Checks the registry for newer versions of installed agents.

Authenticate

clawstore login

Opens a browser-based GitHub OAuth flow. Required before publishing.

Create a new agent package

clawstore init

Scaffolds agent.json and the recommended directory structure:

my-agent/
├── agent.json          # Package manifest
├── app/
│   ├── IDENTITY.md     # Agent persona
│   ├── AGENTS.md       # Capabilities
│   ├── SOUL.md         # Personality
│   └── knowledge/      # Reference files
└── store/
    ├── icon.png        # Store icon (256x256 PNG)
    └── screenshots/    # Store listing images

Validate a package

clawstore validate

Checks that agent.json is valid and the package structure is correct. Always run before publishing.

Preview a tarball

clawstore pack

Builds the tarball without publishing. Useful for inspecting what will be uploaded.

Publish

clawstore publish
# or from a specific directory
clawstore publish ./path/to/agent

Uploads the agent package to the Clawstore registry. Requires clawstore login first.

Yank a version

clawstore yank @scope/agent-name@1.0.0 --reason "critical bug"

Marks a published version as yanked. It won't be installed by default but remains downloadable for existing users.

Guidance

Search first: Before recommending an agent, search to see what's available.
Check info: Use clawstore info to verify an agent's quality (downloads, rating) before installing.
Validate before publish: Always run clawstore validate before clawstore publish to catch issues early.
Use init for new packages: Don't hand-write agent.json — use clawstore init to get the correct structure.
Login once: Authentication persists across sessions. Only run clawstore login if the user hasn't authenticated yet.

clawstore

Prerequisites

When to use this skill