ClawPark 是一个本地的 OpenClaw 代理育种实验室。将代理导入为 ZIP，将它们交配以产生带有追踪谱系的子嗣，并可选择发布到市场供发现和分享。

---

快速启动

先决条件

• Node.js 18+
• NPM
• （可选）OAuth 的 Discord 机器人令牌

安装

地方发展

同时启动前端和服务器端：

内容是：

• Vite 前端在 http://localhost:5173
• 节点市场服务器，位于http://localhost:8787

前端代理/api/*会自动向后端请求。

仅前端使用：

仅限服务器使用：

制作版本

Node服务器在同一主机上同时为构建的dist/前端和API端点提供服务。

当前验证状态

• npm run lint 通过
• npm run typecheck 通过
• npm run test 通过
• 前端上传/导入和breed流程通过合同式测试覆盖，但尚未**通过浏览器手动端到端测试，包含真实用户互动和真实ZIP上传
• GitHub issue 跟踪该空白：#20 Validate frontend upload and breeding flows end-to-end (manual + automated)

---

什么是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 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