Clawpark

ClawPark

ClawPark is a local agent breeding lab for OpenClaw agents. Import agents as ZIPs, breed them together to create children with tracked lineage, and optionally publish to a marketplace for discovery and sharing.

---

Quick Start

Prerequisites

• Node.js 18+
• npm
• (Optional) Discord bot token for OAuth

Installation

npm install

Local Development

Start both frontend and server:

export MARKETPLACE_SESSION_SECRET="change-me"
npm run dev

This starts:

• Vite frontend at http://localhost:5173
• Node marketplace server at http://localhost:8787

The frontend proxies `/api/*` requests to the backend automatically.

**For frontend only**:

npm run dev:web

**For server only**:

npm run server:dev

Production Build

npm run build
npm run server:start

The Node server serves both the built `dist/` frontend and the API endpoints from the same host.

Current validation status

• npm run lint passes
• npm run typecheck passes
• npm run test passes
• The frontend upload/import and breed flows are covered by contract-style tests, but they have not yet been manually browser-tested end-to-end with real user interaction and real ZIP uploads
• GitHub issue tracking that gap: #20 Validate frontend upload and breeding flows end-to-end (manual + automated)

---

What is ClawPark?

ClawPark lets you:

1. Import — Load local OpenClaw agent ZIPs (including IDENTITY.md, SOUL.md, TOOLS.md, and skills)
2. Browse — View agents in your Nursery with their traits, skills, and tools
3. Breed — Select two agents and create a child with inherited traits
4. Explore — View lineage showing where each trait came from
5. Share — Optionally publish agents to marketplace (Discord-authenticated)
6. Discuss — Talk to parents before breeding to shape the child's doctrine

All data is local by default. Marketplace publishing is optional.

---

Architecture Ov