MycoHive-Claw

OpenClaw Plugin for Multi-Agent Orchestration with LLM Intent Routing

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 categories:

• 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 incremental persistence with crash recovery and CRC validation
• Event Bus — Trie-prefix subscription matching + DLQ retry with exponential backoff
• Circuit Breaker — Failure protection for dispatch pipeline
• Workspace Loader — Dynamic agent capability discovery from filesystem
• Review Agent Isolation — session_mode: isolated for reviewer/qa/security/evaluator

Requirements

• OpenClaw (Plugin SDK compatible version)
• Node.js 18+ (for building)
• TypeScript 5.x (dev dependency included)

Installation

This is an OpenClaw plugin and must be installed on OpenClaw.

# Install via npm (recommended)
npm install mycohive-claw

# Install to OpenClaw (use the npm-installed path)
openclaw plugins install mycohive-claw

# Or install from GitHub directly
openclaw plugins install github:LiamLucas-m/MycoHive-Claw

# Restart OpenClaw gateway
openclaw gateway restart

Update

# Update npm package
npm update mycohive-claw

# Restart OpenClaw gateway
openclaw gateway restart

Uninstall

openclaw plugins uninstall mycohive-claw

Project Structure

src/
├── index.ts              # Plugin entry (createExtension)
├── setup-entry.ts        # Setup entry (setup)
├── router.ts             # Intent routing + dispatch with circuit breaker
├── intent-analyzer.ts    # LLM + keyword dual-engine intent analysis
├── context-tree.ts       # WAL-based incremental persistence + CRC
├── event-bus.ts         # Pub/sub + Trie matching + DLQ retry
├── circuit-breaker.ts   # Failure protection
├── tool-handlers.ts     # mycohive_* tool handlers
├── tools/mycohive-tools.ts  # Tool registration
├── workspace-loader.ts  # Agent workspace loader (SOUL/SKILL/RULES/CONFIG)
├── metrics.ts           # Metrics collection
├── rate-limiter.ts      # Rate limiting
├── result-cache.ts      # Result caching
├── token-counter.ts     # Token counting
├── logger.ts            # Logging
├── i18n.ts             # Internationalization
└── types.ts            # Shared type definitions

workspaces/              # 24 Agent workspace definitions (SOUL.md + SKILL.md + RULES.md + CONFIG.md)

License

MIT

中文

概述

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

架构

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

24 个 Agent

• 入口层: front_director, router
• 管理类: coordinator, planner, observer
• 架构类: architect
• 执行类: coder, frontend_dev, backend_dev, api_dev, data_engineer, scripter, researcher, writer, translator
• 审查类: reviewer, qa, security, evaluator
• 工具类: browser, scraper, deployer
• 自主产出类: builder, dreamer

核心特性

• LLM 意图路由 — 自然语言自动路由，无需 @xxx / !! 前缀
• Context Tree — WAL 增量持久化 + CRC 校验 + 崩溃恢复
• Event Bus — 前缀树订阅匹配 + DLQ 重试（指数退避）
• 熔断器 — 派发管道故障保护
• Workspace Loader — 文件系统动态 Agent 能力发现
• 审查类 Agent 隔离 — reviewer/qa/security/evaluator 使用独立 Session

系统要求

• OpenClaw（兼容 Plugin SDK 版本）
• Node.js 18+
• TypeScript 5.x

安装

这是 OpenClaw 插件，必须安装到 OpenClaw 上运行。

# 通过 npm 安装（推荐）
npm install mycohive-claw

# 安装到 OpenClaw（使用 npm 安装的路径）
openclaw plugins install mycohive-claw

# 或直接从 GitHub 安装
openclaw plugins install github:LiamLucas-m/MycoHive-Claw

# 重启 OpenClaw gateway
openclaw gateway restart

更新

# 更新 npm 包
npm update mycohive-claw

# 重启 OpenClaw gateway
openclaw gateway restart

卸载

openclaw plugins uninstall mycohive-claw

目录结构

src/                     # TypeScript 源码
├── index.ts             # 插件入口
├── setup-entry.ts       # 安装入口
├── router.ts            # 意图路由（含熔断器）
├── intent-analyzer.ts   # LLM + 关键词双引擎意图分析
├── context-tree.ts      # WAL 增量持久化 + CRC 校验
├── event-bus.ts         # 事件总线（前缀树 + DLQ 重试）
├── circuit-breaker.ts  # 熔断器
├── tool-handlers.ts     # mycohive_* 工具处理
├── tools/mycohive-tools.ts  # 工具注册
├── workspace-loader.ts  # Agent workspace 加载器
├── metrics.ts           # 指标收集
├── rate-limiter.ts      # 限流
├── result-cache.ts      # 结果缓存
├── token-counter.ts     # Token 计数
├── logger.ts            # 日志
├── i18n.ts              # 国际化
└── types.ts            # 类型定义

workspaces/              # 24 个 Agent 工作区定义（SOUL.md + SKILL.md + RULES.md + CONFIG.md）

License

MIT