ClawMagic Plugin Install from Marketplace

ClawMagic Marketplace plugins ship as .zip packages containing a claw.plugin.json manifest, an ActionSpec bundle, and bundled runtime code. You can install them through the portal UI, the ClawMagic CLI, or the marketplace API.

• ClawMagic server installed and running — the CLI should be available as clawmagic in your terminal.
• Plugins directory exists at data/plugins/ inside your ClawMagic project root (created automatically on first run).
• A ClawMagic Marketplace account for purchasing or claiming free plugins.
• Pro or Agency membership for paid plugins (free plugins work on any tier).

The fastest way to install a plugin. No terminal required.

Step 1: Browse the marketplace

1. Open the ClawMagic portal in your browser and go to Dashboard → Browse Marketplace.
2. Search or filter to find the plugin you want.
3. Click the plugin card to open its detail page.

Step 2: Install the plugin

1. Click Install (free plugins) or complete checkout (paid plugins).
2. The portal downloads the ZIP, extracts it, validates the manifest, and places the plugin in data/plugins/<plugin-id>/.
3. The plugin appears in your Your Plugins list as installed and enabled.

Installed plugins are available immediately — no server restart needed. The plugin loader picks up new plugins on the next agent request.

Download a plugin .zip from the marketplace website and install it using the ClawMagic CLI.

Step 1: Download the plugin

1. Go to the ClawMagic Marketplace and find the plugin you want.
2. Click the plugin to open its detail page.
3. Click Download (free plugins) or complete checkout (paid plugins). The .zip file downloads to your computer.

Step 2: Install with the CLI

Use the clawmagic plugins install command, passing the path to the downloaded ZIP:

# Install from downloaded ZIP
clawmagic plugins install ~/Downloads/my-plugin.zip

# Verify it appears in the plugin list
clawmagic plugins list

The CLI extracts the ZIP, validates the claw.plugin.json manifest, runs a security scan, and places the plugin in data/plugins/<plugin-id>/.

Step 3: Verify the install

# List installed plugins with status
clawmagic plugins list

# Test the plugin loads correctly
clawmagic plugins test <plugin-id>

Alternative: Manual extraction

If you prefer to extract manually instead of using the CLI command:

# 1. Create the plugin directory
mkdir -p data/plugins/my-plugin

# 2. Extract the ZIP into it
unzip ~/Downloads/my-plugin.zip -d data/plugins/my-plugin

# 3. Verify the manifest exists
cat data/plugins/my-plugin/claw.plugin.json

# 4. Confirm it loads
clawmagic plugins list

The directory name under data/plugins/ should match the plugin id field in claw.plugin.json.

Every marketplace plugin ZIP follows this structure:

my-plugin.zip
├── claw.plugin.json        # ClawMagic plugin manifest (required)
├── actionspec.json          # Action specification bundle
├── skill.json               # Skill hints for agent routing
├── README.md                # Plugin documentation
├── plugin/                  # Bundled runtime code
│   ├── index.js             # Entry point
│   └── ...
├── openclaw.plugin.json     # OpenClaw compatibility manifest (optional)
└── skills/
    └── my-plugin/
        └── SKILL.md         # Operational guidance

ClawMagic discovers plugins by looking for claw.plugin.json in each subdirectory of data/plugins/. The manifest defines the plugin ID, name, version, type, entry point, permissions, and supported actions.

The manifest tells ClawMagic everything it needs to load and run the plugin:

{
  "id": "my-plugin",
  "name": "My Plugin",
  "version": "1.0.0",
  "type": "CONNECTOR",
  "entry": "plugin/index.js",
  "permissions": ["network", "storage"],
  "install": {
    "postInstall": "npm install --production"
  },
  "support": {
    "docs": "https://example.com/docs",
    "issues": "https://example.com/issues"
  }
}

For repeatable installs and agent-driven workflows, use the ClawMagic Marketplace API to browse, purchase, download, and install plugins programmatically. This is the same flow documented in the Agent Marketplace docs.

Step 1: Get an API key

Create a scoped API key from an authenticated session:

POST /v1/apikeys
Authorization: Bearer mpk_live_...
Content-Type: application/json

{
  "name": "clawmagic-agent-key",
  "scopes": ["deliveries:read", "deliveries:write"]
}

# Response (save the key — shown once):
{
  "id": "key_abc123",
  "token": "cmk_live_...",
  "scopes": ["deliveries:read", "deliveries:write"]
}

Step 2: Browse and purchase

# Browse plugins (public, no auth required)
GET /v1/plugins?q=seo&limit=10

# Purchase / claim a free plugin
POST /v1/checkout/create
Authorization: Bearer cmk_live_...
Content-Type: application/json

{
  "pluginId": "plugin_id_here",
  "quantity": 1
}

# Free plugins finalize immediately:
{
  "entitlementId": "ent_abc123",
  "providerStatus": "FREE_CLAIM",
  "downloadToken": "dtk_..."
}

Step 3: Download the package

# Request a signed download URL
POST /v1/agent/deliveries/request
Authorization: Bearer cmk_live_...
Content-Type: application/json

{
  "entitlementId": "ent_abc123"
}

# Response:
{
  "downloadUrl": "https://storage.../my-plugin.zip?sig=...",
  "sha256": "a1b2c3d4...",
  "fileName": "my-plugin-1.0.0.zip"
}

# Download and verify
curl -o my-plugin.zip "$downloadUrl"
sha256sum my-plugin.zip  # must match response sha256

Step 4: Install into ClawMagic

# Install using the CLI
clawmagic plugins install ./my-plugin.zip

# Verify
clawmagic plugins list

Step 5: Report install status

Report the result back to the marketplace so install counts stay accurate:

POST /v1/agent/install-report
Authorization: Bearer cmk_live_...
Content-Type: application/json

{
  "entitlementId": "ent_abc123",
  "status": "SUCCESS",
  "pluginVersion": "1.0.0",
  "runtime": "clawmagic"
}

Use "status": "FAILED" with an optional error field if the install did not succeed.

# List all installed plugins
clawmagic plugins list

# Disable a plugin (keeps files, stops loading)
clawmagic plugins disable <plugin-id>

# Re-enable a disabled plugin
clawmagic plugins enable <plugin-id>

# Uninstall a plugin (removes files)
clawmagic plugins uninstall <plugin-id>

# Update a plugin to a new version
clawmagic plugins install ~/Downloads/my-plugin-2.0.0.zip

Plugin state is managed in data/plugins/. Installing a new version of an existing plugin replaces the previous version. Disabled plugins remain on disk but are not loaded by the agent.

ClawMagic Marketplace plugins can be installed into either ClawMagic or OpenClaw. Pick the guide that matches your runtime:

• ClawMagic Plugin Install — You are here. Install plugins into a ClawMagic server instance.
• OpenClaw Plugin Install — Install the same marketplace plugins into OpenClaw (theclaw).

• Agent Marketplace — Full API reference for automated browse, purchase, download, and install.
• Plugin Packaging — How marketplace plugins are structured and validated.
• Plugin Development — Build your own plugins with ActionSpec, skill hints, and manifests.
• Browse Marketplace — Find plugins to install.