Ruflo：为 Claude Code 和 Codex 打造的智能体协作框架

🌊 原始特工元束缚。部署智能多人群体，协调自主工作流程，构建对话式AI系统。具备自适应记忆、自学智能、RAG集成，以及原生Claude代码/Codex/Hermes等多种功能。

https://Cognitum.One

鲁弗洛

克劳德代码和法典的特工元绑架。

代理 = 型号 + 线束。模型写道：束带为它提供了工具、内存、循环、沙盒和控制，使它真正能正常工作。Ruflo 是安全带——围绕Claude代码和Codex的执行层，增加了100+个专业代理、协调蜂群、自学习记忆、跨机器联邦通信以及企业安全护栏。所以经纪人不仅仅是逃跑，而是协作。

一npx ruflo init赋予克劳德代码一个神经系统：代理自我组织成群体，从每个任务中学习，跨会话记忆，并且——通过联邦——安全地与其他机器上的代理通信而不泄露数据。

你继续写代码。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代码即可——钩子系统会自动路由任务，从成功的模式中学习，并在后台协调代理。

📖 背景——名称的由来

克劳德·弗洛现在是鲁弗洛——由rUv，他热爱Rust、流动状态，以及那些感觉不可避免的建造。“Ru”是rUv。“flo”工作到凌晨3点。底下，动力由Cognitum.One代理架构，运行基于Rust的超强AI引擎、嵌入、内存和插件系统。

快速入门

有两种不同的安装路径表面积差异很大。根据你需要的选择（#1744）：

路径A — Claude Code 插件（仅限轻量版，斜杠命令）

# 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-rag-memory@ruflo
/plugin install ruflo-neural-trader@ruflo

这增加了斜杠命令和代理定义。ruflo-core（如上所述）在安装时确实注册了自己的MCP服务器——其工具可调用为mcp__plugin_ruflo-core_ruflo__*（例如：mcp__plugin_ruflo-core_ruflo__memory_store），不是最裸露的memory_store/swarm_init/agent_spawnCLI轨道支架使用的名称。

其他插件通常不会自带MCP服务器。对于完整的环路，包含CLI轨道工具名称，请使用下方路径B。

🔌 全部35个插件

核心与编排

记忆与知识

智力与学习

代码质量与测试

安全与合规

架构与方法论

DevOps 与可观测性

可扩展性

领域特定

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 wizardLine 在 PowerShell 和 cmd 中原生运行。如果你撞上了'bash' is not recognized错误，使用以下npx线路——两者最终运行相同的初始化流程。

MCP服务器

# Add Ruflo as an MCP server in Claude Code
claude mcp add claude-flow -- npx ruflo@latest mcp start

你得到了什么

Web UI（测试版）——自托管、托管演示于flo.ruv.io

RuFlo 的网页界面是一个多模型 AI 聊天，内置了模型上下文协议（MCP）工具调用功能。你可以直接在聊天中调用 Qwen、Claude、Gemini 或 OpenAI，RuFlo 调用 CLI 使用的 MCP 工具——代理编排、持久内存、群组协调、代码审查、GitHub 运营。

不需要安装，也不需要API密钥就能尝试。

试试托管演示： https://flo.ruv.io/——没有账户，没有API密钥。自己运行：源头居住在ruflo/src/ruvocal/带有多阶段 Docker 文件（INCLUDE_DB=true在MongoDB中构建）以及一个cloudbuild.yaml用于Google Cloud Run。

参见ADR-033对于建筑和第#1689期为了路线图。

Goal Planner UI — 自主代理goal.ruv.io

将高层目标转化为可执行的代理计划。 goal.ruv.io是RuFlo托管的目标导向行动规划（GOAP）前端——用通俗易懂的英语描述一个结果，并观看RuFlo将其分解为前提条件、动作和状态空间中的A*路径，然后将工作派遣到实时代理/agents.

试试看： https://goal.ruv.io/进球·https://goal.ruv.io/agents对于活人特工来说。自己运行：克隆goal分支和cd v3/goal_ui && npm install && npm run dev.

特工联邦——特工的Slack

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 <-- [ Block attacks ] <-- [ Check identity ] <------+
                 Stops prompt          Rejects forgeries
                 injection

                          Audit trail on both sides.
                  Trust builds over time. Bad behavior = instant downgrade.

Slack为团队提供了频道。联邦也给特工同样的——跨信任边界的共享工作空间，不同机器、组织或云区域的代理可以相互发现，证明身份，并协作完成任务。

区别在于：有些频道是可信的，有些则不是。@claude-flow/plugin-agent-federation会自动处理。你的代理加入联盟，通过mTLS + ed25519进行验证，开始交换工作——在任何信息离开节点前就被剥离个人身份信息，每条消息都可以被审计。

不受信任的代理仍可以较低权限参与：他们看到的是发现信息，而非你的记忆。由于它们被证明可靠，信任升级。如果他们表现不当，会立即被降级——不需要任何人参与。

你不需要配置握手或管理证书。你federation init,federation join你的经纪人开始发言。协议负责身份识别，PII流水线负责数据安全，审计跟踪负责合规。

📘 完整用户指南： docs/federation/—— 设置、MCP工具、信任级别、断路器，以及将分组层可达性与联邦信任绑定的（选择加入）WireGuard网格层。ADR-111深度潜航docs/federation/phase7-mesh-bringup.md.

联邦能力

示例：两个团队共享欺诈信号却不共享客户数据

# 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 码：带 vs 无 Ruflo

架构概述

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)

文献资料

四部纪录片，面向四大观众：

基准内部结构（用于复制：sota-workload-spec.md·SOTA-PROGRESS.md·原始矩阵 JSON： darwin·Linux

用户指南章节索引：

支持

许可

与——RuvNet