✨ OpenSpace: Make Your Agents: Smarter, Low-Cost, Self-Evolving ✨

One Command to Evolve All Your AI Agents: OpenClaw, nanobot, Claude Code, Codex, Cursor and etc.

The Problem with Today's AI Agents

Today's AI agents — OpenClaw, nanobot, Claude Code, Codex, Cursor, etc. — are powerful, but they have a critical weakness: they never Learn, Adapt, and Evolve from real-world experience — let alone Share with each other.

❌ Massive Token Waste - How to reuse successful task patterns instead of reasoning from scratch and burning tokens every time?
❌ Repeated Costly Failures - How to share solutions across agents instead of repeating the same costly exploration and mistakes?
❌ Poor and Unreliable Skills - How to maintain skill reliability as tools and APIs evolve — while ensuring community-contributed skills meet rigorous quality standards?

🎯 What is OpenSpace?

🚀 🚀 The self-evolving engine where every task makes every agent smarter and more cost-efficient.

https://github.com/user-attachments/assets/c50f70ab-f6db-47bf-9498-3210c0f0abae

OpenSpace plugs into any agent as skills and evolves it with three superpowers:

🧬 Self-Evolution

Skills that learn and improve themselves automatically

✅ AUTO-FIX — When a skill breaks, it fixes itself instantly
✅ AUTO-IMPROVE — Successful patterns become better skill versions
✅ AUTO-LEARN — Captures winning workflows from actual usage
✅ Quality monitoring — Tracks skill performance, error rates, and execution success across all tasks.

Skills that continuously evolve — turning every failure into improvement, every success into optimization.

🌐 Collective Agent Intelligence

Turn individual agents into a shared brain

✅ Shared evolution: One agent's improvement becomes every agent's upgrade
✅ Network effects: More agents → richer data → faster evolution for every agent
✅ Easy sharing — Upload and download evolved skills with one simple command
✅ Access control — Choose public, private, or team-only access for each skill

One agent learns, all agents benefit — collective intelligence at scale.

💰 Token Efficiency

Smarter agents, dramatically lower costs

✅ Stop repeating work → Reuse successful solutions instead of starting from zero each time
✅ Tasks get cheaper → As skills improve, similar work costs less and less
✅ Small updates only → Fix what's broken, don't rebuild everything
✅ Real savings: 4.2× better performance with 46% fewer tokens on real-world tasks, delivering measurable economic value. (GDPVal)

Do more, spend less — agents that actually save you money over time.

The Difference

❌ Current Agents

Skills degrade silently as tools evolve
Failed patterns repeat with no learning mechanism
Knowledge remains trapped in individual agents

✅ OpenSpace-Powered Agents

Multi-layer monitoring catches problems and auto-triggers repairs
Successful workflows become reusable, shareable skills
When one agent learns something useful, all agents get that knowledge instantly

📊 OpenSpace: Turn Your Agent into a Money-Making Coworker

🎯 Real-World Results That Matter On 50 professional tasks (📈 GDPVal Economic Benchmark) across 6 industries, OpenSpace agents earn 4.2× more money than baseline (ClawWork) agents using the same backbone LLM (Qwen 3.5-Plus). While cutting 46% of costly tokens through skill evolution.

💼 These Aren't Toy Problems

Building payroll calculators from complex union contracts
Preparing tax returns from 15 scattered PDF documents
Drafting legal memoranda on California privacy regulations
Creating compliance forms and engineering specifications

📈 Consistent Wins Across All Fields

Compliance work: +18.5% higher earnings
Engineering projects: +8.7% better performance
Professional documents: 56% fewer tokens needed
Every category improved — no exceptions

OpenSpace doesn't just make agents smarter — it makes them economically viable. Real work, real money, measurable results.

Use Case for Autonomous System Development with OpenSpace

🖥️ My Daily Monitor — OpenSpace empowers your agent to complete large-scale system development. This personal behavior monitoring system with 20+ live dashboard panels was built entirely by the agent — 60+ skills evolved from scratch through OpenSpace, demonstrating autonomous end-to-end software development capabilities.

📋 Table of Contents

⚡ Quick Start
📈 Benchmark: GDPVal
📊 Showcase: My Daily Monitor
🏗️ Framework
- 🧬 Self-Evolution Engine
- 🌐 Cloud Skill Community
🔧 Advanced Configuration
📖 Code Structure
🤝 Contribute & Roadmap
🔗 Related Projects

⚡ Quick Start

🌐 Just want to explore? Browse community skills, evolution lineage at open-space.cloud — no installation needed.

git clone https://github.com/HKUDS/OpenSpace.git && cd OpenSpace
pip install -e .
openspace-mcp --help   # verify installation

[!TIP] Slow clone? The assets/ folder (~50 MB of images) makes the default clone large. Use this lightweight alternative to skip it:
git clone --filter=blob:none --sparse https://github.com/HKUDS/OpenSpace.git
cd OpenSpace
git sparse-checkout set '/*' '!assets/'
pip install -e .

Choose your path:

Path A — Plug OpenSpace into your agent
Path B — Use OpenSpace directly as your AI co-worker

🤖 Path A: For Your Agent

Works with any agent that supports skills (SKILL.md) — Claude Code, Codex, OpenClaw, nanobot, etc.

① Add OpenSpace to your agent's MCP config:

{
  "mcpServers": {
    "openspace": {
      "command": "openspace-mcp",
      "toolTimeout": 600,
      "env": {
        "OPENSPACE_HOST_SKILL_DIRS": "/path/to/your/agent/skills",
        "OPENSPACE_WORKSPACE": "/path/to/OpenSpace",
        "OPENSPACE_API_KEY": "sk-xxx (optional, for cloud)"
      }
    }
  }
}

[!TIP] Credentials (API key, model) are auto-detected from your agent's config; you usually don't need to set them manually.

② Copy skills into your agent's skills directory:

cp -r OpenSpace/openspace/host_skills/delegate-task/ /path/to/your/agent/skills/
cp -r OpenSpace/openspace/host_skills/skill-discovery/ /path/to/your/agent/skills/

Done. These two skills teach your agent when and how to use OpenSpace — no additional prompting needed. Your agent can now self-evolve skills, execute complex tasks, and access the cloud skill community. You can also add your own custom skills — see openspace/skills/README.md.

[!NOTE] Cloud community (optional): Register at open-space.cloud to get a OPENSPACE_API_KEY, then add it to the env block above. Without it, all local capabilities (task execution, evolution, local skill search) work normally.

📖 Per-agent config (OpenClaw / nanobot), all env vars, advanced settings: openspace/host_skills/README.md

👤 Path B: As Your Co-Worker

Use OpenSpace directly — coding, search, tool use, and more — with self-evolving skills and cloud community built in.

[!NOTE] Create a .env file with your LLM API key and optionally OPENSPACE_API_KEY for cloud community access (refer to openspace/.env.example).

# Interactive mode
openspace

# Execute task
openspace --model "anthropic/claude-sonnet-4-5" --query "Create a monitoring dashboard for my Docker containers"

Add your o

OpenSpace

Install / Use

README