Claude Flow
Claude Code 多智能体编排平台,部署 100+ 专业 AI 智能体协同工作,通过蜂群拓扑(层级/网状/环形/星形)协调自主工作流,内置自学习、向量记忆和原生 MCP 集成 Skill: Claude Flow Owner: cn-big-cabbage Summary: Claude Code 多智能体编排平台,部署 100+ 专业 AI 智能体协同工作,通过蜂群拓扑(层级/网状/环形/星形)协调自主工作流,内置自学习、向量记忆和原生 MCP 集成 Tags: latest:0.1.1 Version history: v0.1.1 | 2026-06-16T10:07:46.605Z | auto - Added _meta.json file to the project. - Updated SKILL.md to version 0.1.1, specifying required binaries (node, npx) in metadata. - Removed skill-card.md from the repository. v0.1.0 | 2026-04-22T00:41:
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
0.1.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 0.1.1release · observed Jun 16, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17dbd0j0kazk5ay31x9kv1z3n84f04v:claude-flow- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/snapshot"
Documentation
CLAWHUB
36,388 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: claude-flow
description: Claude Code 多智能体编排平台,部署 100+ 专业 AI 智能体协同工作,通过蜂群拓扑(层级/网状/环形/星形)协调自主工作流,内置自学习、向量记忆和原生 MCP 集成
version: 0.1.1
metadata:
openclaw:
requires:
bins:
- node
- npx
emoji: 🌊
homepage: https://github.com/ruvnet/claude-flow
---
# Claude-Flow — Claude Code 多智能体编排平台
Claude-Flow(现更名为 Ruflo)是专为 Claude Code 设计的企业级多智能体编排框架,将 Claude Code 变成强大的多智能体开发平台。通过 MCP 原生集成,可在 Claude Code 会话中直接协调 100+ 专业智能体(coder、tester、reviewer、architect、security 等),智能体通过蜂群拓扑自组织,支持层级(Queen/Worker)或网状(P2P)协作模式,并具备持续自学习能力。
## 核心使用场景
- **复杂软件工程任务**:自动分解大型任务,分配给专业智能体并行处理
- **代码审查与安全审计**:同时运行 reviewer、security、tester 智能体进行全面检查
- **架构设计**:architect 智能体协调 researcher、analyst 智能体完成技术选型
- **自动化测试**:tester 智能体批量生成和执行测试,optimizer 智能体分析结果
- **文档生成**:documenter 智能体并发处理多个模块的文档
## AI 辅助使用流程
1. **一键安装** — AI 执行 `npx ruflo@latest init --wizard` 完成 Claude Code MCP 集成
2. **选择智能体** — AI 根据任务选择合适的专业智能体类型
3. **启动蜂群** — AI 启动智能体蜂群,自动设置 Queen/Worker 拓扑
4. **监控协调** — AI 实时查看智能体状态和任务分配
5. **收集成果** — 智能体协作完成后,Queen 整合所有工作成果
6. **知识复用** — 成功模式自动存入向量记忆,未来同类任务直接复用
## 关键章节导航
- [安装指南](guides/01-installation.md) — npx 安装、MCP 配置、Claude Code 集成
- [快速开始](guides/02-quickstart.md) — 启动智能体、蜂群模式、对话驱动编排
- [高级用法](guides/03-advanced-usage.md) — 自定义智能体、多模型切换、向量记忆、插件
- [故障排查](troubleshooting.md) — MCP 连接、智能体超时、记忆数据库
## AI 助手能力
使用本技能时,AI 可以:
- ✅ 安装 Claude-Flow 并配置 Claude Code MCP 集成
- ✅ 启动和配置专业智能体(coder、tester、reviewer 等)
- ✅ 组建蜂群,设置 Queen/Worker 层级拓扑
- ✅ 分解复杂任务并分配给最合适的智能体
- ✅ 监控智能体状态和任务进度
- ✅ 查询和利用智能体向量记忆中存储的成功模式
- ✅ 切换不同 LLM 提供商(Claude/GPT/Gemini/Ollama)
## 核心功能
- ✅ **100+ 专业智能体** — 涵盖 coder、tester、reviewer、architect、security 等角色
- ✅ **蜂群协调** — 层级(Queen/Worker)、网状(P2P)、环形、星形拓扑
- ✅ **容错共识** — Raft、Byzantine、Gossip 三种共识算法
- ✅ **自学习记忆** — HNSW 向量搜索 + SQLite 持久化,成功模式自动复用
- ✅ **MCP 原生集成** — 310+ MCP 工具,直接在 Claude Code 中使用
- ✅ **多 LLM 支持** — Claude/GPT/Gemini/Cohere/Ollama,自动故障切换
- ✅ **WASM 优化引擎** — 简单任务跳过 LLM 调用(<1ms),Token 压缩 30-50%
- ✅ **安全防护** — 内置提示注入防护、路径遍历防护、命令注入拦截
- ✅ **插件系统** — 自定义 Worker、Hook、Provider,IPFS 市场分发
## 快速示例
```bash
# 一键安装(推荐)
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
# 或通过 npx
npx ruflo@latest init --wizard
# 启动 Claude Code MCP 服务器
npx ruflo@latest mcp start
# 查看可用智能体
npx ruflo@latest agent list
# 启动蜂群处理复杂任务
npx ruflo@latest swarm start --topology hierarchical --agents coder,tester,reviewer
```
在 Claude Code 对话中直接使用:
```
# 直接描述任务,Claude-Flow 自动路由到合适智能体
帮我审查 src/auth/ 目录的安全性,需要代码审查、安全扫描和测试覆盖率检查
```
## 安装要求
| 依赖 | 版本要求 |
|------|---------|
| Node.js | >= 18.0 |
| Claude Code | 最新版 |
| npm/npx | 任意版本 |
| Anthropic API Key | 必需(用于 Claude) |
## 项目链接
- GitHub:https://github.com/ruvnet/claude-flow
- npm:https://www.npmjs.com/package/claude-flow
- Discord:https://discord.com/invite/dfxmpwkG2D_meta.json
{
"ownerId": "kn7c5ry95ff7x22mt3fx6j0q3d81p8t3",
"slug": "claude-flow",
"version": "0.1.1",
"publishedAt": 1781604466605
}guides/01-installation.md
# 安装指南
## 适用场景
- 在 Claude Code 中安装和配置 Claude-Flow
- 通过 MCP 将 Claude-Flow 集成到 Claude Code 工作流
- 配置 Anthropic API 密钥
---
## 方式一:一键安装脚本(推荐)
> **AI 可自动执行**
```bash
# 完整安装(MCP + 诊断工具)
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash -s -- --full
# 或仅基础安装
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash
```
---
## 方式二:npx 安装
```bash
# 交互式向导安装
npx ruflo@latest init --wizard
# 或直接初始化(接受默认配置)
npx ruflo@latest init
```
---
## 方式三:全局 npm 安装
```bash
npm install -g claude-flow
# 或
npm install -g ruflo
# 验证
claude-flow --version
ruflo --version
```
---
## 配置 Anthropic API 密钥
```bash
export ANTHROPIC_API_KEY="sk-ant-..."
# 或写入 .env 文件
echo 'ANTHROPIC_API_KEY=sk-ant-...' >> .env
```
---
## 在 Claude Code 中配置 MCP
### 自动配置(推荐)
```bash
# 在 Claude Code 会话中执行
claude mcp add claude-flow --scope user npx ruflo@latest mcp start
```
### 手动配置
在 `~/.claude/settings.json` 中添加:
```json
{
"mcpServers": {
"claude-flow": {
"command": "npx",
"args": ["ruflo@latest", "mcp", "start"],
"env": {
"ANTHROPIC_API_KEY": "your-key"
}
}
}
}
```
**安装后必须重启 Claude Code** 使 MCP 生效。
---
## 验证安装
```bash
# 检查版本
npx ruflo@latest --version
# 检查 Claude Code MCP 集成
claude mcp list # 应显示 claude-flow
# 查看可用智能体
npx ruflo@latest agent list
# 系统诊断
npx ruflo@latest hooks intelligence --status
```
---
## 完成确认检查清单
- [ ] 安装命令执行成功
- [ ] `ANTHROPIC_API_KEY` 环境变量已配置
- [ ] Claude Code 重启后 MCP 工具可用
- [ ] `npx ruflo@latest agent list` 显示可用智能体列表
---
## 下一步
- [快速开始](02-quickstart.md) — 启动智能体、蜂群模式、在 Claude Code 中使用guides/02-quickstart.md
# 快速开始 ## 适用场景 - 在 Claude Code 中使用 Claude-Flow 智能体 - 组建蜂群处理复杂任务 - 查看和管理智能体状态 --- ## 在 Claude Code 中直接使用(最简单) 安装完成后,Claude-Flow 通过 MCP 集成到 Claude Code。**你不需要学习所有命令**,直接在对话中描述任务即可: ``` 帮我审查 src/auth/ 目录的代码安全性 帮我为 payments 模块写完整的测试套件 重构 database.ts,提高性能并改善错误处理 ``` Claude-Flow 会自动路由到合适的专业智能体(security、tester、refactor 等)。 --- ## 查看可用智能体 ```bash # 列出所有可用智能体 npx ruflo@latest agent list # 查看特定智能体详情 npx ruflo@latest agent info coder npx ruflo@latest agent info security ``` 常用智能体类型: | 智能体 | 职责 | |--------|------| | `coder` | 代码编写和实现 | | `tester` | 测试编写和执行 | | `reviewer` | 代码审查 | | `architect` | 技术架构设计 | | `security` | 安全扫描和审计 | | `documenter` | 文档生成 | | `optimizer` | 性能优化 | | `researcher` | 技术调研 | --- ## 手动启动单个智能体 ```bash # 启动 coder 智能体处理特定任务 npx ruflo@latest agent spawn coder \ --task "实现用户认证模块,包含 JWT 刷新机制" # 启动 security 智能体审计代码 npx ruflo@latest agent spawn security \ --task "审计 src/api/ 目录的安全性" \ --files "src/api/" ``` --- ## 启动蜂群(多智能体协作) ```bash # 层级蜂群(Queen 协调 Worker) npx ruflo@latest swarm start \ --topology hierarchical \ --agents coder,tester,reviewer,security \ --task "实现并测试用户注册和登录 API" # 网状蜂群(P2P 协作,适合研究任务) npx ruflo@latest swarm start \ --topology mesh \ --agents researcher,architect,documenter \ --task "设计微服务架构方案" # 查看蜂群状态 npx ruflo@latest swarm status ``` --- ## 常见任务模式 ### 全链路代码实现 ```bash # 让多个智能体协作完成从设计到测试的完整流程 npx ruflo@latest swarm start \ --topology hierarchical \ --agents architect,coder,tester,reviewer \ --task "设计并实现一个 RESTful API 用于用户管理(CRUD),包含完整测试" ``` ### 代码质量审查 ```bash # 并行运行审查、安全、测试三个智能体 npx ruflo@latest swarm start \ --topology mesh \ --agents reviewer,security,tester \ --task "全面审查 src/ 目录的代码质量、安全性和测试覆盖率" ``` ### 紧急 Bug 修复 ```bash # 单个 coder 智能体快速处理 npx ruflo@latest agent spawn coder \ --task "修复 payment.ts 中的竞态条件 bug,错误出现在 processPayment 函数" ``` --- ## 查看学习记忆 Claude-Flow 会记住成功的任务模式,可以查询: ```bash # 查看记忆系统状态 npx ruflo@latest hooks intelligence --status # 搜索历史成功模式 npx ruflo@latest memory search "authentication" ``` --- ## MCP 工具列表 在 Claude Code 中,Claude-Flow 暴露 310+ MCP 工具: ``` # 在 Claude Code 中查询可用工具 /mcp list # 常用工具(自动调用,无需手动触发) claude_flow_agent_spawn — 启动智能体 claude_flow_swarm_start — 启动蜂群 claude_flow_memory_search — 搜索历史模式 claude_flow_task_status — 查看任务状态 ``` --- ## 完成确认检查清单 - [ ] Claude Code 中 Claude-Flow MCP 工具可用(`/mcp list` 可见) - [ ] `npx ruflo@latest agent list` 显示可用智能体 - [ ] 简单任务通过对话自动路由到合适智能体 - [ ] 蜂群模式成功启动并完成任务 --- ## 下一步 - [高级用法](03-advanced-usage.md) — 自定义智能体、多模型切换、向量记忆管理
guides/03-advanced-usage.md
# 高级用法
## 多 LLM 提供商切换
Claude-Flow 支持在不同 LLM 提供商之间切换,并自动故障切换:
```bash
# 配置多个提供商
npx ruflo@latest config set provider anthropic --api-key $ANTHROPIC_API_KEY
npx ruflo@latest config set provider openai --api-key $OPENAI_API_KEY
npx ruflo@latest config set provider google --api-key $GOOGLE_API_KEY
# 指定智能体使用特定提供商
npx ruflo@latest agent spawn coder \
--provider anthropic \
--model claude-opus-4-7 \
--task "实现复杂算法"
# 经济型任务使用便宜模型
npx ruflo@latest agent spawn documenter \
--provider anthropic \
--model claude-haiku-4-5-20251001 \
--task "生成 API 文档"
# 使用本地 Ollama
npx ruflo@latest agent spawn researcher \
--provider ollama \
--model llama3.2 \
--task "技术调研"
```
---
## 自定义智能体
创建自己的专业智能体:
```javascript
// agents/custom-agent.js
module.exports = {
name: "data-analyst",
description: "专门处理数据分析和可视化任务的智能体",
capabilities: ["data_analysis", "visualization", "statistics"],
systemPrompt: `You are an expert data analyst.
Focus on: statistical analysis, data quality, visualization recommendations.
Always provide actionable insights with quantified impact.`,
tools: ["read_file", "write_file", "execute_code"],
hooks: {
beforeTask: async (task) => {
// 预处理任务
return task;
},
afterTask: async (result) => {
// 后处理结果
return result;
}
}
};
```
```bash
# 注册自定义智能体
npx ruflo@latest agent register agents/custom-agent.js
# 使用自定义智能体
npx ruflo@latest agent spawn data-analyst \
--task "分析 sales.csv,找出销售下降的原因"
```
---
## 向量记忆管理
Claude-Flow 使用 HNSW 向量数据库记录成功模式:
```bash
# 查看记忆使用状态
npx ruflo@latest memory status
# 搜索相关历史模式
npx ruflo@latest memory search "authentication JWT"
npx ruflo@latest memory search "database optimization"
# 导出记忆数据库(备份)
npx ruflo@latest memory export backup-2026.json
# 清理低质量记忆
npx ruflo@latest memory prune --min-confidence 0.7
# 查看智能体学习曲线
npx ruflo@latest hooks intelligence --report
```
---
## Hook 系统
Hook 在智能体生命周期的关键节点自动触发:
```bash
# 查看当前活跃的 Hook
npx ruflo@latest hooks list
# 启用代码质量 Hook(每次代码生成后自动运行 linter)
npx ruflo@latest hooks enable code-quality
# 启用安全扫描 Hook
npx ruflo@latest hooks enable security-scan
# 查看 Hook 执行日志
npx ruflo@latest hooks logs --last 20
```
---
## 蜂群拓扑详解
```bash
# 层级拓扑(Queen 管理 Worker,适合大任务分解)
npx ruflo@latest swarm start \
--topology hierarchical \
--queen-agent architect \
--worker-agents coder,tester,reviewer,documenter \
--consensus majority \
--task "设计和实现完整的电商订单系统"
# 环形拓扑(顺序流水线,适合步骤明确的任务)
npx ruflo@latest swarm start \
--topology ring \
--agents researcher,architect,coder,tester \
--task "技术调研 → 设计 → 实现 → 测试"
# 星形拓扑(一个协调者+多个独立工作者)
npx ruflo@latest swarm start \
--topology star \
--coordinator-agent architect \
--agents coder,coder,coder \ # 多个同类型智能体并行
--task "并行实现三个独立的 API 端点"
```
---
## WASM 优化引擎
Claude-Flow 包含 WebAssembly 优化引擎,对简单任务跳过 LLM 调用:
```bash
# 查看 WASM 引擎状态
npx ruflo@latest hooks intelligence --wasm-status
# 查看 Token 节省报告(30-50% 压缩)
npx ruflo@latest hooks intelligence --token-reporAionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/cn-big-cabbage/skills/claude-flow",
"sourceUrl": "https://clawhub.ai/cn-big-cabbage/skills/claude-flow",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T08:15:26.143Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T08:15:26.143Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/cn-big-cabbage/claude-flow",
"sourceUrl": "https://clawhub.ai/cn-big-cabbage/claude-flow",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T08:15:26.143Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.1",
"href": "https://clawhub.ai/cn-big-cabbage/claude-flow",
"sourceUrl": "https://clawhub.ai/cn-big-cabbage/claude-flow",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-16T10:07:46.605Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.1",
"description": "- Added _meta.json file to the project. - Updated SKILL.md to version 0.1.1, specifying required binaries (node, npx) in metadata. - Removed skill-card.md from the repository.",
"href": "https://clawhub.ai/cn-big-cabbage/claude-flow",
"sourceUrl": "https://clawhub.ai/cn-big-cabbage/claude-flow",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-06-16T10:07:46.605Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
