ClawDock CLI

The command-line tool for ClawDock — the agent registry. Push, pull, and run OpenClaw agent bundles.

Install

npm install -g clawdock

Quick Start

# 1. Set up runtime credentials (one-time)
clawdock credentials set --provider github-copilot --api-key ghu_xxx --model github-copilot/claude-sonnet-4

# 2. Pull and run any agent
clawdock run hugo/caramelo

Commands

Registry

| Command | Description | |---------|-------------| | clawdock login | Authenticate with your registry access token | | clawdock whoami | Show current user | | clawdock init | Create a manifest.json in the current directory | | clawdock push [path] | Bundle and publish an agent | | clawdock pull <owner/slug[@version]> | Download and extract a bundle | | clawdock search <query> | Search the registry | | clawdock list | List your published bundles |

Runtime

| Command | Description | |---------|-------------| | clawdock credentials set | Configure provider/model/runtime for running agents | | clawdock credentials show | Show stored runtime credentials | | clawdock credentials clear | Remove stored credentials | | clawdock run <owner/slug[@version]> | Pull + launch an agent locally |

clawdock run

Pulls an agent bundle and launches it with a local runtime (OpenClaw by default).

# Uses stored credentials
clawdock run hugo/caramelo

# Override model
clawdock run hugo/caramelo --model github-copilot/claude-opus-4

# Use a different runtime
clawdock run hugo/caramelo --runtime nullclaw@latest

# Skip pull (use cached workspace)
clawdock run hugo/caramelo --no-pull

Agents are cached at ~/.clawdock/agents/<owner>/<slug>/workspace/.

Supported Runtimes

| Runtime | Default | Install | |---------|---------|---------| | openclaw@latest | ✅ | npm install -g openclaw (auto-installed if missing) | | nullclaw@latest | | github.com/pigeonflow/brain-arch-v2 |

Configuration

All config lives in ~/.clawdock/config.json:

{
  "apiKey": "cd_registry_token",
  "registry": "https://clawhub-one.vercel.app",
  "runtime": {
    "provider": "github-copilot",
    "apiKey": "ghu_xxx",
    "model": "github-copilot/claude-sonnet-4",
    "runtime": "openclaw@latest"
  }
}

Environment variables:

• CLAWDOCK_API_KEY — override runtime API key
• CLAWDOCK_REGISTRY — override registry URL

License

MIT