Claude Flow

鲁弗洛

Claude Code的多代理AI编排

跨机器、团队和信任边界协调100多个专业AI代理。Ruflo在Claude Code中添加了协调集群、自学习内存、联邦通信和企业安全，因此代理不仅仅是运行，而是协作。

为什么是鲁弗洛？

Claude Flow现在是Ruflo，他的名字是 rUv，他喜欢Rust、流状态和构建感觉不可避免的东西。“Ru”就是rUv。“flo”工作到凌晨3点。下面，由 Cognitum.One 代理架构，运行基于Rust的超级AI引擎、嵌入、内存和插件系统。

Ruflo做什么

一 npx ruvflo init 为Claude Code提供了一个神经系统：代理自组织成集群，从每个任务中学习，跨会话记忆，并且通过联盟与其他机器上的代理安全地交谈，而不会泄露数据。你一直在写代码。Ruflo负责协调。

Self-Learning / Self-Optimizing Agent Architecture

User --> Ruflo (CLI/MCP) --> Router --> Swarm --> Agents --> Memory --> LLM Providers
                          ^                           |
                          +---- Learning Loop  **刚到Ruflo？** 您不需要学习314个MCP工具或26个CLI命令。之后 `init`，只需正常使用Claude Code——钩子系统会自动路由任务，从成功的模式中学习，并在后台协调代理。

______________________________________________________________________

## 快速开始

有 **两种不同的安装路径** 具有非常不同的表面积。根据您的需求进行选择（#1744）：

| | **Claude代码插件** | **CLI安装(`npx ruflo init`)** |
|---|---|---|
|它给你什么| Slash命令+一些技能+每个插件的代理定义|完整的Ruflo循环——98个代理、60多个命令、30个技能、MCP服务器、钩子、守护进程|
|工作区中的文件| **零** | `.claude/`, `.claude-flow/`, `CLAUDE.md`、助手、设置|
|MCP服务器已注册| **不** (`memory_store`, `swarm_init`克劳德无法访问）|是|
|已安装挂钩|否|是|
|最适合|尝试单个插件的命令，而不进行完整安装|生产使用——一切都如文档所述|

### 路径A——Claude代码插件（仅限精简版、斜线命令）

Add the marketplace

/plugin marketplace add ruvnet/ruflo

Install core + any plugins you need

/plugin install ruflo-core@ruflo /plugin install ruflo-swarm@ruflo /plugin install ruflo-autopilot@ruflo /plugin install ruflo-federation@ruflo

这只添加了斜线命令和代理定义。Ruflo MCP服务器未注册，因此 `memory_store`, `swarm_init`, `agent_spawn`克劳德不会打电话给你。对于完整循环，请使用下面的路径B。

🔌 All 32 plugins

#### 核心与编排

|插件|它的作用|
|--------|-------------|
| [**鲁弗洛岩芯**](plugins/ruflo-core/README.md) |基础——服务器、健康检查、插件发现|
| [**鲁弗洛蜂群**](plugins/ruflo-swarm/README.md) |将多个代理作为一个团队进行协调|
| [**ruflo 自动 驾驶**](plugins/ruflo-autopilot/README.md) |让代理在循环中自主运行|
| [**鲁弗洛环路工人**](plugins/ruflo-loop-workers/README.md) |在计时器上安排后台任务|
| [**ruflo工作流程**](plugins/ruflo-workflows/README.md) |可重复使用的多步骤任务模板|
| [**鲁弗洛联合会**](plugins/ruflo-federation/README.md) |不同机器上的代理安全协作|

#### 记忆与知识

|插件|它的作用|
|--------|-------------|
| [**ruflo 代理**](plugins/ruflo-agentdb/README.md) |用于代理内存的快速矢量数据库|
| [**ruflo-rag存储器**](plugins/ruflo-rag-memory/README.md) |智能检索——混合搜索、图跳、多样性排名|
| [**鲁弗洛rvf**](plugins/ruflo-rvf/README.md) |跨会话保存和恢复代理内存|
| [**ruflo知识图**](plugins/ruflo-knowledge-graph/README.md) |构建和遍历实体关系图|

#### 智力与学习

|插件|它的作用|
|--------|-------------|
| [**鲁弗洛情报**](plugins/ruflo-intelligence/README.md) |代理人从过去的成功中学习，变得更聪明|
| [**鲁弗洛·达阿**](plugins/ruflo-daa/README.md) |动态代理行为和认知模式|
| [**鲁弗洛·鲁夫尔姆**](plugins/ruflo-ruvllm/README.md) |使用智能路由运行本地LLM（Ollama等）|
| [**鲁弗洛进球**](plugins/ruflo-goals/README.md) |将大目标分解为计划并跟踪进度|

#### 代码质量与测试

|插件|它的作用|
|--------|-------------|
| [**ruflo 测试**](plugins/ruflo-testgen/README.md) |查找缺失的测试并自动生成它们|
| [**Ruflo浏览器**](plugins/ruflo-browser/README.md) |使用Playwright自动化浏览器测试|
| [**柔术**](plugins/ruflo-jujutsu/README.md) |分析git差异，评分风险，建议审阅者|
| [**鲁弗洛文件**](plugins/ruflo-docs/README.md) |自动生成和维护文档|

#### 安全与合规

|插件|它的作用|
|--------|-------------|
| [**ruflo安全审计**](plugins/ruflo-security-audit/README.md) |扫描漏洞和CVE|
| [**鲁弗洛援助**](plugins/ruflo-aidefence/README.md) |阻断快速注射、检测PII、安全扫描|

#### 架构与方法

|插件|它的作用|
|--------|-------------|
| [**ruflo adr**](plugins/ruflo-adr/README.md) |用实时记录跟踪架构决策|
| [**鲁弗洛ddd**](plugins/ruflo-ddd/README.md) |脚手架领域驱动设计——上下文、聚合、事件|
| [**鲁弗洛·斯帕克**](plugins/ruflo-sparc/README.md) |带质量门的五阶段开发方法|

#### DevOps和可观察性

|插件|它的作用|
|--------|-------------|
| [**鲁弗洛迁徙**](plugins/ruflo-migrations/README.md) |安全地管理数据库架构更改|
| [**ruflo可观测性**](plugins/ruflo-observability/README.md) |结构化日志、跟踪和指标集中在一个地方|
| [**ruflo成本跟踪器**](plugins/ruflo-cost-tracker/README.md) |跟踪令牌使用情况，设置预算，获取成本警报|

#### 可扩展性

|插件|它的作用|
|--------|-------------|
| [**鲁弗洛试剂**](plugins/ruflo-agent/README.md) |运行代理--本地WASM沙箱（rvagent）+人工克劳德管理代理（云）|
| [**ruflo插件创建者**](plugins/ruflo-plugin-creator/README.md) |搭建、验证和发布您自己的插件|

#### 特定领域

|插件|它的作用|
|--------|-------------|
| [**已知红色物联网**](plugins/ruflo-iot-cognitum/README.md) |物联网设备管理——信任评分、异常检测、车队|
| [**鲁弗洛市场数据**](plugins/ruflo-market-data/README.md) |摄取市场数据，矢量化OHLCV，检测模式|

### CLI安装

**macOS/Linux/WSL/Git Bash：**

One-line install (POSIX shells only — see Windows note below)

curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

**所有平台（包括本机Windows PowerShell/cmd）：**

Interactive setup wizard — runs identically on every platform

npx ruflo@latest init wizard

Quick non-interactive init

npx ruflo@latest init

Or install globally

npm install -g ruflo@latest

> 💡 **Windows用户：** 这 `curl ... | bash` 表单需要一个POSIX shell（Git Bash、WSL、MSYS）。这 `npx ruflo@latest init wizard` line在PowerShell和cmd中本机工作。如果你击中了 `'bash' is not recognized` 错误，使用 `npx` 相反，两者最终都运行相同的init流。

### MCP服务器

Add Ruflo as an MCP server in Claude Code (canonical form, matches USERGUIDE.md)

claude mcp add ruflo -- npx ruflo@latest mcp start

______________________________________________________________________

## 所得

|能力|描述|
|------------|-------------|
| 🤖 **100+代理商** |编码、测试、安全、文档、架构的专业代理|
| 📡 **通信层** |零信任联盟——跨机器/组织的代理安全地发现、验证和交换工作|
| 🐝 **群体协同** |具有共识的分层、网格和自适应拓扑|
| 🧠 **自我学习** |SONA神经模式、ReasoningBank、轨迹学习|
| 💾 **向量内存** |HNSW索引AgentDB，搜索速度快150x-12500倍|
| ⚡ **背景工作者** |12个自动触发的工作人员（审计、优化、测试间隙等）|
| 🧩 **插件市场** |32个原生Claude Code插件+21个npm插件|
| 🔌 **多供应商** |Claude、GPT、Gemini、Cohere、Ollama采用智能路由|
| 🛡️ **安全** |AIDefence、输入验证、CVE修复、路径遍历预防|
| 🌐 **Agent联邦** |具有零信任安全性的跨安装代理协作|
| 💬 **[Web UI测试版](https://flo.ruv.io/)** |flo.ruv.io上的多模型聊天，带有并行MCP工具调用和浏览器内WASM工具库|
| 🎯 **[RuFlo研究](https://goal.ruv.io/)** |goal.ruv.io上的GOAP A\*规划师——简单的英语进球→ 可执行代理计划，实时代理仪表板位于 [/代理商](https://goal.ruv.io/agents) |

  

### Web UI（测试版）-可自托管，托管演示 [flo.ruv.io](https://flo.ruv.io/)

**RuFlo的web UI是一个内置模型上下文协议（MCP）工具调用的多模型AI聊天。** 与Qwen、Claude、Gemini或OpenAI交谈，RuFlo直接从聊天中调用CLI使用的相同MCP工具——代理编排、持久内存、集群协调、代码审查、GitHub操作。无需安装，无需API密钥即可进行尝试。

||它是什么|为什么重要|
|---|------------|----------------|
| 🧠 | **任何型号，本地或远程** |6个现成的前沿模型——Qwen 3.6 Max（默认）、Claude Sonnet 4.6、Claude Haiku 4.5、Gemini 2.5 Pro、Gemini 2.5Flash、OpenAI——通过OpenRouter。添加您自己的：任何与OpenAI兼容的端点（vLLM、Ollama、LM Studio、Together、Groq、自托管）。 |
| 🦾 | **ruvLLM自主学习AI** |本地支持 [ruvLLM](https://github.com/ruvnet/RuVector/tree/main/examples/ruvLLM) （住在 `ruvnet/RuVector/examples/ruvLLM`)——RuFlo的自改进局部模型层。路由到MicroLoRA适配器，通过SONA从您的轨迹中学习，并留在您的机器上。与云模型配对或完全离线运行。 |
| 🛠️ | **约210个工具，随时待命** |5个服务器组（核心、智能、代理、内存、DevTools）加上一个完全在浏览器中运行的18个工具库，可以离线工作。 |
| 🔌 | **自带MCP服务器** |点击 **MCP（n）** 聊天输入中的药丸→ *添加服务器* 并粘贴任何MCP端点（HTTP、SSE或stdio）。您的工具将RuFlo的原生工具加入到相同的并行执行流中。在上运行本地MCP服务器 `localhost:3000` 它只是工作。 |
| ⚡ | **工具并行运行** |一个模型响应可以同时启动4-6个工具。UI将它们显示为带有 *步骤1--完成2个工具* 徽章，这样你就可以准确地看到跑了什么。 |
| 💾 | **难以忘怀的记忆** |说 *“记住我最喜欢的颜色是靛蓝色”* 几周后再问——RuFlo回忆道。基于AgentDB+HNSW矢量搜索（比暴力快≥150倍）。 |
| 📘 | **内置功能之旅** |单击侧边栏中的问号图标，将打开一个“RuFlo Capabilities”模式，其中包含完整的工具列表、模型强度、架构和键盘快捷键。 |
| 🏠 | **自助式** |Web UI以Docker的形式发布(`ruflo/src/ruvocal/Dockerfile`)内嵌Mongo。部署到您自己的Cloud Run/Fly/Kubernetes/docker compose。主办 [flo.ruv.io](https://flo.ruv.io/) demo是一种选择；完全支持自己跑步。 |
| 🚀 | **零安装尝试** |打开托管URL，选择模型，键入问题。这就是整个入职流程。 |

  

### 目标规划器UI——自主代理 [goal.ruv.io](https://goal.ruv.io/)

**将高级目标转化为可执行的代理计划。** `goal.ruv.io` 是RuFlo托管的目标导向行动计划（GOAP）前端——用简单的英语描述结果，并观察RuFlo将其分解为先决条件、行动和状态空间中的A\*路径，然后将工作分派给 [`/agents`](https://goal.ruv.io/agents).

||它是什么|为什么重要|
|---|------------|----------------|
| 🎯 | **简明英语目标** |类型 *“发布带有测试和PR的身份重构”* --RuFlo提取成功标准、约束和隐含前提条件。没有JSON，没有DSL。 |
| 🧭 | **GOAP A\*规划师** |经典游戏人工智能规划移植到软件工作中：通过具有先决条件/效果的动作进行状态空间搜索，以找到最短可行路径。状态更改时动态回放。 |
| 🤖 | **实时代理仪表板** | [goal.ruv.io/gents](https://goal.ruv.io/agents) 显示每个生成的代理--角色、当前步骤、内存命名空间、令牌预算、状态。点击查看轨迹、杀死逃跑的工人或重新分配。 |
| 🌳 | **可视化计划树** |目标呈现为可折叠的动作树，突出显示进度、阻塞的分支和回滚。看 *确切地* 为什么代理选择了一条路径——没有不透明的思路。 |
| ♻️ | **适应性重新规划** |当操作失败或新信息到达时，计划器会从当前状态重新运行A\*，而不是重新启动。失败变成了学习，而不是循环。 |
| 🧠 | **共享内存+SONA** |计划、轨迹和结果流入AgentDB。未来计划通过HNSW检索过去的解决方案——规划者每次运行都会变得更聪明。 |
| 🔗 | **连接到MCP工具** |每个动作节点都映射到一个工具调用（RuFlo的约210个MCP工具、您的自定义服务器或shell）。计划器在依赖关系图允许的情况下并行调度它们。 |
| 🚀 | **零安装尝试** |打开 [goal.ruv.io](https://goal.ruv.io/)，描述一个目标，看着它跑。来源生活在 [`v3/goal_ui/`](v3/goal_ui/) --Vite+Supabase，自助式。 |

### Agent Federation——Slack for Agent

Your Agent --> [ Remove secrets ] --> [ Sign message ] --> [ Encrypted channel ] Emails, SSNs, Proves it came No one reads it keys stripped from you in transit | v Their Agent 📘 完整用户指南： docs/federation/ --设置、MCP工具、信任级别、断路器以及将数据包层可达性与联邦信任联系起来的（选择加入）WireGuard网格层。ADR-111深潜 docs/federation/phase7-mesh-bringup.md.

Federation capabilities

Example: two teams sharing fraud signals without sharing customer data

# Team A: initialize federation and generate keypair
npx claude-flow@latest federation init

# Team A: join Team B's federation endpoint
npx claude-flow@latest federation join wss://team-b.example.com:8443

# Team A: send a task — PII is stripped automatically before it leaves
npx claude-flow@latest federation send --to team-b --type task-request \
  --message "Analyze transaction patterns for account anomalies"

# Team A: check peer trust levels and session health
npx claude-flow@latest federation status

看 第1669期 了解完整的架构、信任模型和实现路线图。

# Claude Code plugin
/plugin install ruflo-federation@ruflo

# Or via CLI
npx claude-flow@latest plugins install @claude-flow/plugin-agent-federation

Claude Code: With vs Without Ruflo

Architecture overview

User --> Claude Code / CLI
          |
          v
    Orchestration Layer
    (MCP Server, Router, 27 Hooks)
          |
          v
    Swarm Coordination
    (Queen, Topology, Consensus)
          |
          v
    100+ Specialized Agents
    (coder, tester, reviewer, architect, security...)
          |
          v
    Memory & Learning
    (AgentDB, HNSW, SONA, ReasoningBank)
          |
          v
    LLM Providers
    (Claude, GPT, Gemini, Cohere, Ollama)

______________________________________________________________________

文档

针对三个受众的三份文档：

用户指南部分索引：

______________________________________________________________________

支持

许可证

麻省理工学院- RuvNet