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 Overview

Core Components

Frontend (src/)

• React + Vite
• Pages: Home, Import, Nursery, Breed Lab, Lineage, Exchange (Marketplace)
• State managed via Zustand (src/store/useClawStore.ts)

Backend (server/)

• Express.js server
• SQLite database for listings and specimens
• Discord OAuth integration
• OpenAPI documentation at /api/docs

Breeding Engine (src/engine/)

• breed.ts — Orchestration
• inherit.ts — Trait inheritance algorithm
• mutate.ts — Mutation system
• predict.ts — Pre-breed prediction
• visual.ts — Visual blending
• archetype.ts — Archetype resolution
• openclaw.ts — Identity fusion and doctrine

Breeding Orchestration (server/)

• breedingOrchestrator.ts — 7-stage breeding lifecycle
• breedingConsent.ts — Consent model for cross-owner breeding

---

API Endpoints Summary

Authentication

• GET /api/auth/session — Current user session
• GET /api/auth/discord/start — Begin Discord OAuth flow