⚡ Clamper

   _____ _                                 
  / ____| |                                
 | |    | | __ _ _ __ ___  _ __   ___ _ __ 
 | |    | |/ _` | '_ ` _ \| '_ \ / _ \ '__|
 | |____| | (_| | | | | | | |_) |  __/ |   
  \_____|_|\__,_|_| |_| |_| .__/ \___|_|   
                           |_|              
  AI Agent Toolkit for OpenClaw

Transform your OpenClaw agent into a production-ready AI assistant with structured memory, 50+ curated skills, a real-time dashboard, and workspace scaffolding — in 3 commands.

🚀 Quick Start

npm install -g clamper-ai
clamper init
clamper status

That's it. Your workspace is ready.

📦 What You Get

• 🧠 Structured Memory — Three-layer system: daily notes, knowledge graph, and curated long-term memory (MEMORY.md)
• 📋 Soul File — SOUL.md defines your agent's personality, tone, and behavior
• 📚 50+ Curated Skills — Pre-built skills covering productivity, development, marketing, data analysis, social media, email, and more
• 📊 Web Dashboard — Real-time agent monitoring with dark Bloomberg-terminal UI
• 💬 Live Chat — Talk to your agent from the dashboard (Pro)
• ✅ Task Manager — Read/write tasks/QUEUE.md from the browser (Pro)
• 🔄 Sync — Push agent state (memory, skills, metrics) to the cloud dashboard
• 🔧 Doctor — Diagnostics to verify your setup is healthy
• 📝 Activity Logging — Track what your agent does with clamper log

🆓 Free vs Pro

| Feature | Free | Pro ($10/mo) | |---------|------|------------| | Workspace scaffolding | ✅ | ✅ | | Three-layer memory system | ✅ | ✅ | | 40+ curated skills | ✅ | ✅ | | Dashboard (read-only) | ✅ | ✅ | | Dashboard live chat | ❌ | ✅ | | Task editing from dashboard | ❌ | ✅ | | File management | ❌ | ✅ | | Premium skills (10+) | ❌ | ✅ | | Priority support | ❌ | ✅ |

→ Get Pro

🛠 CLI Commands

clamper init

Scaffold a new workspace with memory structure, skills, and config files.

clamper init           # Interactive setup
clamper init --yes     # Accept all defaults
clamper init --force   # Overwrite existing files

clamper status

Check workspace health — memory files, skills, config.

clamper status

clamper sync

Sync agent state to the Clamper cloud dashboard. Requires CLAMPER_API_KEY.

export CLAMPER_API_KEY="clk_..."
clamper sync            # Push current state
clamper sync --quiet    # Silent mode (for cron/heartbeat)

clamper log

Log agent activity for tracking and analytics.

clamper log "Deployed website update"
clamper log "Fixed auth bug" --tag=bugfix

clamper doctor

Run full diagnostics — Node.js version, OpenClaw detection, file permissions.

clamper doctor

clamper dashboard

Launch the web dashboard locally in your browser.

clamper dashboard              # Default port 8080
clamper dashboard --port=3000  # Custom port

clamper upgrade

View Pro benefits or activate a Pro key.

clamper upgrade                    # See benefits & pricing
clamper upgrade --key=clk_pro_...  # Activate Pro

clamper update

Check for new versions and update templates.

clamper update

🏗 Architecture

your-workspace/
├── AGENTS.md              # Agent behavior & boot protocol
├── SOUL.md                # Personality & tone definition
├── LEARNINGS.md           # Rules, patterns & mistake log
├── MEMORY.md              # Long-term curated memory
├── HEARTBEAT.md           # Proactive background task config
├── memory/
│   ├── daily/             # Daily conversation logs
│   └── knowledge/         # Extracted facts & patterns
├── skills/
│   └── [50+ skills...]    # Installed skill modules
└── tasks/
    └── QUEUE.md           # Task queue (tracks in-progress & done)

🔑 Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CLAMPER_API_KEY | For sync/dashboard | Your API key from clamper.tech/dashboard |

🧩 Included Skills (50+)

Skills cover a wide range of use cases out of the box:

Productivity — CEO Advisor, ADHD Assistant, Daily Briefing, Ask a Human Development — Developer, Code Mentor, CSV Pipeline, Comfy AI Marketing — Social media posting, Bluesky, SEO, content creation Data — Data analysis, PDF extraction, Google Sheets integration Creative — Image generation, video toolkit, SVG drawing, assets from video Utilities — Catbox upload, weather, system monitoring, email (IMAP/SMTP) Fun — Tarot readings, D&D 5e, Digimon, 4chan reader

Browse all skills after install with clamper status.

🔧 Requirements

• Node.js ≥ 18
• OpenClaw installed and running
• Zero npm dependencies — uses Node.js builtins only

🔗 Links

• Website: clamper.tech
• Dashboard: clamper.tech/dashboard
• OpenClaw: openclaw.ai
• Discord: OpenClaw Community

📄 License

MIT © Clamper