Packaging Standard

Required Package Layout

claw.plugin.json            # Required — ClawMagic manifest
openclaw.plugin.json         # Optional — OpenClaw compatibility manifest
plugin/
  index.js                   # Entry point (add register(api) for OpenClaw)
  ...code-or-assets...
docs/ (optional)

ClawMagic-only: claw.plugin.json is sufficient. Dual-compatible (ClawMagic + OpenClaw): also include openclaw.plugin.json with id and configSchema (maps secrets to JSON Schema properties), and add export function register(api) to your entry point. ClawMagic ignores both additions.

Shopify Connector Example

{
  "id": "shopify-orders-sync",
  "name": "Shopify Orders Sync Connector",
  "version": "1.2.0",
  "type": "CONNECTOR",
  "platform": "Shopify",
  "tasks": [
    "order-sync",
    "inventory-sync"
  ],
  "entry": {
    "kind": "http_api",
    "path": "plugin/server.js"
  },
  "permissions": {
    "network": [
      "*.myshopify.com",
      "api.clawmagic.com"
    ],
    "secrets": [
      "SHOPIFY_API_KEY",
      "SHOPIFY_API_SECRET"
    ],
    "storage": [
      "read",
      "write"
    ]
  },
  "install": {
    "installPathHint": "plugins/{slug}",
    "postInstall": [
      "registerPlugin",
      "runHealthCheck"
    ]
  },
  "support": {
    "email": "support@connectorvendor.dev"
  },
  "checksums": {
    "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}

WordPress Task Skill Example

{
  "id": "wordpress-seo-audit-task",
  "name": "WordPress SEO Audit Task",
  "version": "0.9.1",
  "type": "TASK",
  "platform": "WordPress",
  "tasks": [
    "seo-audit",
    "reporting"
  ],
  "entry": {
    "kind": "script_bundle",
    "path": "plugin/run-audit.sh"
  },
  "permissions": {
    "network": [
      "*.wordpress.com"
    ],
    "secrets": [
      "WP_TOKEN"
    ],
    "storage": [
      "read"
    ]
  },
  "install": {
    "installPathHint": "plugins/{slug}",
    "postInstall": [
      "registerPlugin"
    ]
  },
  "support": {
    "email": "support@taskvendor.dev"
  }
}

Memory Pack Example

{
  "id": "fb-ads-playbook-memory",
  "name": "FB Ads Playbook Memory",
  "version": "1.0.3",
  "type": "MEMORY_PACK",
  "platform": null,
  "tasks": [
    "memory-enrichment"
  ],
  "entry": {
    "kind": "memory_pack",
    "path": "plugin/memory/index.json"
  },
  "permissions": {
    "network": [],
    "secrets": [],
    "storage": [
      "read"
    ]
  },
  "install": {
    "installPathHint": "plugins/{slug}",
    "postInstall": [
      "updateMemory",
      "runHealthCheck"
    ]
  },
  "support": {
    "email": "support@memoryvendor.dev"
  }
}

Human Install Steps (MVP)

1. Purchase plugin and open Account → Entitlements.
2. Click Download and save the zip.
3. Verify SHA256 checksum shown in entitlement metadata.
4. Unzip into your local plugin directory and follow docs/install notes.
5. If issues occur, contact support.email from manifest.