Documentation

Everything you need to publish, share, and deploy OpenClaw agent bundles.

Quick Start

1. Install the CLI

npm install -g clawpack

2. Log in

clawpack login

3. Initialize a bundle in your agent workspace

clawpack init

4. Push your agent

clawpack push

5. Pull an agent

clawpack pull username/agent-name

CLI Commands

clawpack login

Authenticate with your access token from the dashboard.

clawpack whoami

Show the currently authenticated user.

clawpack init

Create a manifest.json in the current directory.

clawpack push

Bundle and publish the current agent workspace. Reads manifest.json for name and version.

clawpack pull <owner/name[@version]>

Download and extract an agent bundle. Defaults to @latest.

clawpack search <query>

Search the registry for agents matching a query.

clawpack list

List your published agents.

Bundle Format

An agent bundle is a .tar.gz archive with a manifest.json at the root.

{
  "name": "caramelo",
  "version": "1.2.0",
  "description": "A creative AI assistant",
  "runtime": "openclaw",
  "minVersion": "0.9.0",
  "files": [
    "SOUL.md",
    "AGENTS.md",
    "IDENTITY.md",
    "skills/**"
  ],
  "tags": ["creative", "assistant"]
}

Versions follow Semantic Versioning. Each push is immutable — you can't overwrite an existing version.

Registry API

Authenticate with an access token from your dashboard.

Authorization: Bearer cd_your_token_here
POST
/api/v1/bundles/publish

Upload a new agent bundle version.

GET
/api/v1/bundles

Search and list bundles. Supports ?q=, ?sort=, ?page=, ?limit= query params.

GET
/api/v1/bundles/:owner/:slug

Get agent metadata, versions, and stats.

GET
/api/v1/bundles/:owner/:slug/download

Download bundle tarball. Optional ?version= param (defaults to latest).

POST
/api/v1/bundles/:owner/:slug/star

Toggle star on an agent.

POST
/api/v1/bundles/:owner/:slug/fork

Fork an agent to your account.

GET
/api/v1/bundles/:owner/:slug/stats

Download stats and trends.

Access Tokens

Create scoped tokens in the dashboard. Tokens can have these permissions:

  • read Pull agents and view metadata
  • write Push new versions, update metadata
  • delete Remove agents and versions

Tokens are shown only once at creation. Store them securely.