MycoHive Claw

Name: MycoHive Claw
Rating: 3.5 (1 reviews)
Author: LiamLucas-m

By LiamLucas-m 👁 28 views ▲ 0 votes

OpenClaw Plugin for Multi-Agent Orchestration with LLM Intent Routing

GitHub

Install

npm install
npm

Configuration Example

plugins:
  mycohive:
    enabled: true
    config:
      workspace_dir: ~/.openclaw/mycohive/workspaces
      config_dir: ~/.openclaw/mycohive/config
      data_dir: ~/.openclaw/mycohive/data

README

# MycoHive-Claw

> OpenClaw Plugin for Multi-Agent Orchestration with LLM Intent Routing

[English](#english) | [中文](#中文)

---

## English

### Overview

MycoHive-Claw is an OpenClaw plugin that implements a **corporate-style multi-agent collaboration system** with 24 specialized agents. It features **LLM-driven intent analysis** that automatically routes user requests to the appropriate agents — no manual `@agent` or `!!` prefixes needed.

### Architecture

```
Entry Layer → Router (LLM Intent Analysis)
                    ↓
              Coordinator (Task Decomposition)
                    ↓
        ┌──────────┴──────────┐
        ↓         ↓         ↓
  Management   Execution    Review
  (planner,   (coder,      (reviewer,
   observer)   frontend,     qa,
               backend...)   security)
```

**24 Agents** organized in 7 layers:
- **Entry**: `front_director`, `router`
- **Management**: `coordinator`, `planner`, `observer`
- **Architecture**: `architect`
- **Execution**: `coder`, `frontend_dev`, `backend_dev`, `api_dev`, `data_engineer`, `scripter`, `researcher`, `writer`, `translator`
- **Review**: `reviewer`, `qa`, `security`, `evaluator`
- **Tool**: `browser`, `scraper`, `deployer`
- **Autonomous**: `builder`, `dreamer`

### Key Features

- **LLM Intent Routing** — Natural language auto-routing without `@xxx` / `!!` prefixes
- **Context Tree** — WAL-based persistence with crash recovery
- **Event Bus** — Trie-prefix subscription matching + DLQ retry mechanism
- **Circuit Breaker** — Failure protection for dispatch pipeline
- **Workspace Loader** — Dynamic agent capability discovery from filesystem

### Requirements

- **OpenClaw** (Plugin SDK compatible version)
- **Node.js 18+** (for building)
- **TypeScript 5.x** (dev dependency included)
- **SQLite 3** (for data persistence)

### Installation

```bash
# Build the plugin
npm install
npm run build

# Install to OpenClaw
./install.sh

# Restart OpenClaw
openclaw restart
```

### Plugin Configuration

Add to your `openclaw.yaml`:

```yaml
plugins:
  mycohive:
    enabled: true
    config:
      workspace_dir: ~/.openclaw/mycohive/workspaces
      config_dir: ~/.openclaw/mycohive/config
      data_dir: ~/.openclaw/mycohive/data
```

### CLI Tools

```bash
# System diagnosis
./shared-state/scripts/mycohive-doctor.sh

# Message trace
./shared-state/scripts/msg-ops.sh trace <msg_id>

# Uninstall
./install.sh --uninstall
```

### Development

```bash
# Type check
npm run typecheck

# Run tests
npm test

# Watch mode
npm run dev
```

### Project Structure

```
src/
├── index.ts              # Plugin entry (createExtension)
├── setup-entry.ts        # Setup entry (setup)
├── router.ts             # Intent analysis + dispatch
├── intent-analyzer.ts    # LLM + rules dual-engine
├── context-tree.ts       # WAL-based persistence
├── event-bus.ts         # Pub/sub + DLQ retry
├── circuit-breaker.ts   # Failure protection
├── tool-handlers.ts     # mycohive_* tools
└── tools/mycohive-tools.ts  # Tool registration

workspaces/              # 24 Agent workspace definitions
shared-state/scripts/    # Shell scripts for DB/shell operations
config/                 # Org chart, routing rules, skill registry
tests/                  # Vitest unit tests
```

### License

MIT

---

## 中文

### 概述

MycoHive-Claw 是一个 OpenClaw 插件，实现了**企业级多 Agent 协作系统**，包含 **24 个专业 Agent**。通过 **LLM 驱动的意图分析**自动将用户请求路由到合适的 Agent，无需手动指定 `@agent` 或 `!!` 前缀。

### 架构

```
入口层 → 路由器（LLM 意图分析）
                ↓
          协调者（任务分解）
                ↓
    ┌───────────┴───────────┐
    ↓           ↓           ↓
  管理       执行         审查
(planner,  (coder,      (reviewer,
 observer)  frontend,    qa,
             backend...) security)
```

### 主要特性

- **LLM 意图路由** — 自然语言自动路由，无需 `@xxx` / `!!` 前缀
- **Context Tree** — WAL 持久化 + 崩溃恢复
- **Event Bus** — 前缀树订阅匹配 + DLQ 重试机制
- **熔断器** — 派发管道故障保护
- **Workspace Loader** — 文件系统动态 Agent 能力发现

### 系统要求

- **OpenClaw**（兼容 Plugin SDK 版本）
- **Node.js 18+**
- **TypeScript 5.x**
- **SQLite 3**

### 安装

```bash
# 构建插件
npm install
npm run build

# 安装到 OpenClaw
./install.sh

# 重启 OpenClaw
openclaw restart
```

### 目录结构

```
src/                     # TypeScript 源码
workspaces/              # 24 个 Agent 工作区定义
shared-state/scripts/    # Shell 脚本（DB/系统操作）
config/                  # 组织架构、路由规则、技能注册表
tests/                   # Vitest 单元测试
```

### License

MIT

tools