ClawFactory

OpenClaw Copy Registry - Share and discover pre-configured OpenClaw copies.

🌐 Website: clawfactory.ai

Overview

ClawFactory is a registry for sharing copies - integrated OpenClaw configurations that bundle:

• Skills (SKILL.md + supporting files)
• Workspace configuration
• SOUL.md, AGENTS.md, HEARTBEAT.md files
• Optional long-term memory

Features

• 📋 Browse available copies with categories
• 🔍 Search by name, description, or skills
• 🧠 Memory toggle - filter copies with/without long-term memory
• 📦 One-command installation via CLI
• 🚀 Upload your own copies
• 👤 User profiles with dedicated copy pages (/{username}/{copy-slug})
• 🔐 User authentication (local + Google OAuth ready)

Categories

• 💰 Financial - Trading and market focused
• 🎨 Frontend Dev - Frontend development
• ⚙️ Backend Dev - Backend development
• 🚀 Productivity - Personal productivity
• ✍️ Content - Content creation
• 🔬 Research - Academic research
• And more...

Quick Start

Web Interface

Visit clawfactory.ai

CLI Installation

# Via npm (recommended)
npm install -g clawfactory

# Or via curl
curl -sL https://raw.githubusercontent.com/mdscolour/clawfactory/main/install.sh | bash

# Commands
clawfactory list           # List all copies
clawfactory search <query> # Search copies
clawfactory install <id>   # Install a copy
clawfactory copy <id>      # Alias for install
clawfactory hottest        # Install top-rated copy
clawfactory publish [dir]  # Publish local directory (reads SKILL.md, SOUL.md, AGENTS.md)
clawfactory login          # Login to upload
clawfactory upload         # Interactive upload

Local Development

# Backend
cd backend
npm install
node server.js

# Frontend (in another terminal)
cd ..
# Open index.html in browser or serve locally
python3 -m http.server 8080

API Endpoints

GET  /api/copies              # List all public copies
GET  /api/copies/:id          # Get copy details
GET  /api/search?q=...        # Search copies
GET  /api/categories          # List categories
GET  /api/featured            # Featured copies
GET  /api/users/:username     # User profile
GET  /api/users/:username/:copySlug  # User copy page
POST /api/auth/register       # Register
POST /api/auth/login          # Login
POST /api/copies             # Create/update copy

Copy Structure

A copy is defined as a JSON object matching copy.schema.json:

{
  "id": "unique-copy-id",
  "name": "Human Readable Name",
  "description": "Brief description",
  "hasMemory": true,
  "author": "Author Name",
  "version": "1.0.0",
  "category": "trading",
  "skills": ["skill1", "skill2"],
  "installCommand": "clawfactory install copy-id",
  "features": ["Feature 1", "Feature 2"],
  "preview": {
    "SOUL.md": "Brief preview content...",
    "AGENTS.md": "..."
  }
}

Project Structure

clawfactory/
├── index.html          # Main page
├── styles.css          # Dark theme styles
├── app.js              # Frontend logic
├── copy.schema.json    # JSON Schema for copy validation
├── package.json        # NPM config
├── README.md           # This file
└── examples/           # Example copy files
    └── polymarket-trader.json

Tech Stack

• Backend: Node.js + sql.js (WebAssembly SQLite)
• Frontend: Pure HTML/CSS/JavaScript
• Deployment: Railway
• API: REST + WebSocket

Project Structure

clawfactory/
├── index.html          # Main page (SPA)
├── styles.css           # Light/dark theme
├── app.js               # Frontend SPA logic
├── api.js               # API client
├── cli.js               # CLI tool
├── copy.schema.json     # JSON Schema
├── package.json         # NPM + CLI config
├── README.md            # This file
├── install.sh           # Shell install script
├── backend/
│   ├── server.js        # API server
│   └── data/            # SQLite database

Development

# Backend development
cd backend
npm install
node server.js

# Frontend (in another terminal)
cd ..
python3 -m http.server 8080
# Open http://localhost:8080

Roadmap

Completed ✅

• [x] Basic browse functionality
• [x] Search and filter
• [x] Memory toggle
• [x] Upload form
• [x] CLI installation
• [x] User authentication
• [x] Backend persistence
• [x] Copy versioning
• [x] Featured copies
• [x] User pages (/{username}/{copy-slug})

In Progress

• [ ] Google OAuth
• [ ] Copy ratings
• [ ] Social features

Contributing

1. Fork the repository
2. Create/update copies via CLI or web
3. Submit a pull request

License

MIT