Documentation

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

Quick Start

1. Install the CLI

npm install -g @clawpack/cli

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 [--org <slug>]

Bundle and publish the current agent workspace. Use --org to publish under an organization. Use --private for private agents. Use --changelog "message" for release notes.

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.

clawpack update

Update the CLI to the latest version.

clawpack run <owner/slug>

Run an agent bundle locally.

clawpack credentials set

Store credentials (API keys, secrets) for agent runtime use.

clawpack credentials show

Display stored credentials.

clawpack credentials clear

Remove all stored credentials.

Organizations

Organizations let teams collaborate on agent bundles under a shared namespace.

1. Create an organization

Go to your dashboard and create a new organization with a unique slug.

2. Invite members

Invite teammates by email from the organization settings page. They'll receive a link to join.

3. Publish under the org

clawpack push --org my-org

The agent will be published as my-org/agent-name instead of your personal namespace.

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.

Organizations

Collaborate with your team by creating organizations. Org members can publish and manage agents under a shared namespace.

1. Create an organization

Go to Dashboard → Organizations and click "Create Organization".

2. Invite team members

From your org's Members page, invite collaborators by email. They'll receive an invitation link.

3. Publish under your org

clawpack push --org my-org

Organization limits depend on your plan: Pro allows 1 org with 3 members, Startup allows 3 orgs with 10 members each.

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.