clawtree

🌳 ClawTree

The OpenClaw skill that grows your skills.

Audit → Gap Analysis → Talent Tree → Knowledge Graph → Evolve

What it does

clawtree is a meta-skill for the OpenClaw ecosystem: it manages, recommends, and evolves your skill collection using a talent-tree model, a semantic knowledge graph, and a persistent Gardener memory layer that survives across agent restarts.

/inception "web scraping"              → full audit + gap analysis + 3 install variants
/tree show                             → ASCII talent tree with live XP bars
/tree branch add {"name":"crypto",...} → add your own custom branch
/graph search "monitoring"             → semantic search (offline, no API key)
/graph path <slug>                     → shortest path to any skill (Dijkstra)
/fleet sync                            → merge all agent trees into shared fleet tree
/slots add * on_evolve flush_memory    → auto-flush on every evolution
/remember                              → flush memory before context compaction

Quick install

clawhub install clawtree

Or manually:

git clone https://github.com/Gzeu/clawtree
cp -r clawtree/skills/clawtree ~/path/to/your/openclaw/skills/

Architecture

clawtree/
├── 🔍 Inception Engine       audit + gap + 3 variants automatically
├── 🌳 Talent Tree            DAG of skills with XP + auto-evolution
│   ├── AUTO mode              agent recommends and installs at threshold
│   ├── MANUAL mode            full user control
│   ├── HYBRID mode            auto-recommend, manual approve (default)
│   └── Custom branches        via config.json or branches/*.json
├── 🧠 Knowledge Graph        semantic search + Dijkstra pathfinding
│   ├── Xenova/all-MiniLM      offline embeddings, 23 MB, no API key
│   └── Mermaid renderer       flowchart auto-generated in reports/
├── 💾 Gardener Memory        XP survives restarts via MEMORY.md
│   ├── Summary Layer          MEMORY.md — always loaded at session start
│   └── Detail Layer           memory/YYYY-MM-DD.md — lazy daily logs
├── 🌍 Fleet Tree (V3)        multi-agent shared talent tree
│   ├── fleetRegistry          register/list agents globally
│   ├── sharedTree             ~/.clawtree/fleet-tree.json (max-wins merge)
│   └── fleetSync              push/pull between personal and fleet
└── 🔧 Conditional Slots (V3) event-driven rule engine
    ├── Triggers               on_use | on_install | on_evolve | on_chain | *
    └── Actions                notify | auto_install | unlock_branch | flush | emit

File structure

skills/clawtree/
├── index.ts                        command router
├── skill.json                      ClawHub manifest (triggers + lifecycle)
├── SKILL.md                        OpenClaw manifest
├── config.example.json             default config + custom_branches example
├── src/
│   ├── tree/       (8 files)       SkillTree, Manager, Evolver, Recommender,
│   │                              Renderer, Persistence, ConfigLoader, BranchLoader
│   ├── memory/     (4 files)       Gardener, SummaryIndex, DetailLayer, MemoryFlush
│   ├── graph/      (6 files)       KnowledgeGraph, SemanticSearch, Pathfinder,
│   │                              Mermaid, Persistence, Enricher
│   ├── safety/     (2 files)       PermissionsGate, InjectionHeuristics
│   ├── audit/      (1 file)        localClawhub (Inception Engine)
│   ├── fleet/      (4 files)       FleetRegistry, SharedTree, FleetSync, GardenerAgent
│   └── slots/      (3 files)       ConditionalSlots, SlotEngine, SlotPersistence
├── tests/          (9 suites)      tree, pathfinder, safety, memory, recommender,
│                                  integration, fleet, slots, branches
├── branches/       (optional)      drop custom branch .json files here
└── docs/
    ├── architecture.md             full system architecture
    ├── talent-tree.md              branch reference, XP rules, modes
    ├── knowledge-graph.md          edge types, semantic search, pathfinding
    ├── memory.md                   Gardener two-layer memory system
    ├── fleet.md                    Fleet Tree: multi-agent shared tree
    ├── slots.md                    Conditional Slots: event-driven rules
    └── custom-branches.md          User-defined branches guide

All commands

Talent Tree — Branches

Custom Branches

Extend the talent tree without touching core code. Add a custom_branches key to your config.json:

{
  "custom_branches": [
    {
      "name":  "crypto-trading",
      "label": "💹 Crypto Trading",
      "nodes": [
        { "slug": "binance-api", "name": "Binance API", "description": "Real-time spot data", "tier": 1 }
      ]
    }
  ]
}

Or drop a .json file in branches/. See docs/custom-branches.md for the full guide.

Safety

ClawTree's PermissionsGate checks every skill before install:

• Skills requesting shell + filesystem + network simultaneously require explicit user confirmation
• Unknown permission strings are blocked by default

InjectionHeuristics scans all user queries and skill metadata for 10 prompt-injection patterns before executing any command.

OpenClaw lifecycle hooks

"lifecycle": {
  "onSessionStart": "gardener.boot",
  "onMemoryFlush":  "gardener.flush"
}

Your XP state is automatically restored at session start and saved before context compaction. No manual /remember needed for normal operation.

Docs

• docs/architecture.md — full system architecture
• docs/talent-tree.md — branch reference, XP rules, modes
• docs/knowledge-graph.md — graph model, edge types, semantic search
• docs/memory.md — Gardener two-layer memory
• docs/fleet.md — Fleet Tree: multi-agent shared tree
• docs/slots.md — Conditional Slots: event-driven rules
• docs/custom-branches.md — User-defined branches guide
• CHANGELOG.md — full release notes

Contributing

See CONTRIBUTING.md. Open a New Branch Idea issue to propose new skill branches.

After your first contribution, we’ll add you to the contributors list. ❤️

Roadmap

• V1 — Gardener Memory (XP survives restarts)
• V2 — Knowledge Graph (semantic search + Dijkstra + Mermaid)
• V3 — Fleet Tree (multi-agent shared tree + Conditional Slots)
• ClawHub publish automation via CI
• User-defined branches via config.json
• Fleet Web UI (dashboard for multi-agent view)

License

MIT © 2026 Gzeu — contributions welcome 🌳