Build Workflows

1. Complete onboarding: node clawmagic.mjs onboard
2. Configure at least one AI provider key (OpenAI, Anthropic, Google, Mistral, or any supported provider).
3. Start the server: npm run dev:server
4. Run a prompt: node clawmagic.mjs agent "Research the latest AI news"
5. Or use the portal UI at http://localhost:5173 for interactive chat.

1. Create a folder in plugins/installed/<your-plugin-id>/
2. Add a plugin.json manifest with id, name, version, entry, and permissions.
3. Implement your plugin entry point (e.g. src/index.ts) with hooks and tools.
4. Optionally add actionspec.json for deterministic tool selection and skill.json for skill routing hints.
5. Scaffold ActionSpec templates: npm run spec:scaffold -- --plugin <your-plugin-id>
6. Test with the agent: node clawmagic.mjs agent "Use the <your-plugin-id> plugin"

See /docs/plugin-development for ActionSpec details and /docs/plugin-packaging for marketplace packaging.

1. Set marketplace connection: CLAWMARKETPLACE_API_KEY=cmk_xxx
2. Browse plugins via the agent or API: GET /v1/plugins
3. Purchase through the marketplace (Stripe checkout or free claim).
4. Request delivery: POST /v1/agent/deliveries/request
5. Download the signed package, verify SHA-256 checksum.
6. Install to plugins/installed/ (safe unzip with zip-slip protection).
7. Report result: POST /v1/agent/install-report

# Or use the agent-sdk for automated install:
pnpm --filter @clawmagic/agent-sdk install:plugin -- \
  --entitlement ent_123 \
  --target ./plugins/installed

1. Create a marketplace account and authenticate: POST /v1/auth/start
2. Check submission eligibility (paywall: $10 baseline, +$10 per 5 submissions).
3. Package your plugin as a ZIP with claw.plugin.json at root.
4. Ensure manifest/listing parity: slug, version, type, and platform must match.
5. Submit via UI or agent endpoint: POST /v1/agent/submissions (scope: submissions:write).
6. Track review status: GET /v1/submissions/:id/status (24-48 hour SLA).
7. After approval, your plugin is listed and available for purchase.

See /docs/submission-and-review for review rules and checklist.

The wallet system bridges ClawMagic and the Marketplace. Sellers earn commissions from plugin sales; buyers can use wallet balance for purchases.

1. Check wallet balance: GET /v1/me/wallet
2. Wallet credits accumulate from plugin sales (minus platform fee).
3. Use wallet balance toward marketplace purchases.
4. Track earnings via affiliate dashboard: GET /v1/me/affiliate-dashboard
5. Referral codes earn additional commission: share via GET /v1/me/referral-code

Payouts are processed outside the system for security and tax compliance. Contact support to schedule payout of your wallet balance.

1. Get your personal referral code: GET /v1/me/referral-code
2. Share in plugin pages, social channels, and partner agent workflows.
3. Attribution is captured through checkout: POST /v1/checkout/create with referralCode
4. Track clicks and conversions: GET /v1/me/affiliate-dashboard
5. Commission earned goes to your wallet balance.