Ruflo: 为Claude Code打造的多Agent编排框架

面向 Claude Code 和 Codex 的 Agent 元框架。

Agent = Model + Harness。Model 负责执行，Harness 提供工具、内存、循环、沙箱和控制能力，使其能够真正工作。Ruflo 就是这个 Harness —— 围绕 Claude Code 和 Codex 的执行层，集成了 100+ 专业化 Agent、协同 swarm、自学习记忆、跨机器联邦通信以及企业级安全护栏。因此 Agent 之间不只是各干各的，而是能真正协作。

一次 npx ruflo init 就为 Claude Code 赋予了一套"神经系统"：Agent 自动组织成 swarm，从每个任务中学习，跨会话记忆，并且通过联邦机制与其他机器上的 Agent 安全通信而不泄露数据。你只需写代码，Ruflo 负责协调。

自学习 / 自优化 Agent 架构

User --> Ruflo (CLI/MCP) --> Router --> Swarm --> Agents --> Memory --> LLM Providers
                          ^                           |
                          +---- Learning Loop <-------+

不熟悉 Ruflo？不需要学习 314 个 MCP 工具或 26 条 CLI 命令。初始化后，只需正常用 Claude Code —— hooks 系统自动路由任务、从成功模式中学习，并在后台协调 Agent。

Claude Flow 现已更名为 Ruflo —— 由 rUv 命名，他喜欢 Rust、流畅状态和构建让人感觉"本该如此"的东西。"Ru"来自 rUv，"flo"来自凌晨三点还在写的状态。底层由 Cognitum 提供支持——统一的 agentic 架构，运行在基于 Rust 的超强 AI 引擎上，包含 embeddings、memory 和插件系统。

有两种安装路径，复杂度差异很大。根据需要选择（#1744）：

路径 A — Claude Code Plugins（轻量，仅限 slash commands）

# 添加 marketplace
/plugin marketplace add ruvnet/ruflo

# 安装核心 + 需要的插件
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo
/plugin install ruflo-neural-trader@ruflo

这会添加 slash commands 和 agent 定义。上面安装的 ruflo-core 确实会在安装时注册自己的 MCP server —— 其工具可通过 mcp__plugin_ruflo-core_ruflo__* 调用（例如 mcp__plugin_ruflo-core_ruflo__memory_store），而非 CLI-track scaffold 使用的裸名 memory_store/swarm_init/agent_spawn。其他插件通常不自带 MCP server。如需完整循环的 CLI-track 工具名，使用下面的路径 B。

macOS / Linux / WSL / Git-Bash：

# 单行安装（仅限 POSIX shells，详见下方 Windows 说明）
curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash

全平台（包括原生 Windows PowerShell / cmd）：

# 交互式设置向导 —— 所有平台运行一致
npx ruflo@latest init wizard

# 快速非交互式初始化
# npx ruflo@latest init

# 或全局安装
npm install -g ruflo@latest

💡 Windows 用户：curl ... | bash 形式需要 POSIX shell（Git-Bash、WSL、MSYS）。npx ruflo@latest init wizard 可在 PowerShell 和 cmd 中原生运行。如果遇到"'bash' 未被识别"错误，改用 npx 方式 —— 两者最终运行相同的初始化流程。

# 将 Ruflo 添加为 Claude Code 的 MCP server
claude mcp add claude-flow -- npx ruflo@latest mcp start

Web UI（Beta）—— 可自托管，托管演示在 flo.ruv.io

RuFlo 的 Web UI 是一个多模型 AI 对话界面，内置 Model Context Protocol（MCP）工具调用。可与 Qwen、Claude、Gemini 或 OpenAI 交流，同时 RuFlo 直接在对话中调用与 CLI 相同的 MCP 工具 —— agent 编排、持久化记忆、swarm 协调、code review、GitHub 操作等。无需安装，无需 API key 即可体验。

体验托管演示：https://flo.ruv.io/ —— 无需账号，无需 API key。自建：源码在 ruflo/src/ruvocal/，多阶段 Dockerfile（INCLUDE_DB=true 构建包含 MongoDB 的版本），以及用于 Google Cloud Run 的 cloudbuild.yaml。架构说明见 ADR-033，路线图见 issue #1689。

Goal Planner UI —— goal.ruv.io 的自主 Agent

将高层目标转化为可执行的 agent 计划。goal.ruv.io 是 RuFlo 托管的 Goal-Oriented Action Planning（GOAP）前端 —— 用自然语言描述一个结果，RuFlo 将其分解为前置条件、actions 和 A* 状态空间路径，然后将工作分配给 /agents 上的 live agents。

体验：https://goal.ruv.io/goals 查看目标 · https://goal.ruv.io/agents 查看 live agents。自建：clone goal 分支，然后 cd v3/goal_ui && npm install && npm run dev。

Agent 联邦 —— Agent 的 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 给团队提供了 channels。联邦给 Agent 提供了同样的东西 —— 跨信任边界的共享工作空间，不同机器、组织或云区域的 Agent 可以相互发现、证明身份并协作完成任务。

区别在于：有些 channel 受信任，有些不是。@claude-flow/plugin-agent-federation 自动处理这个。你的 Agent 加入联邦，通过 mTLS + ed25519 验证，然后开始交换工作 —— PII 在离开你的节点前被剥离，每条消息都可审计。不受信任的 Agent 仍能以较低权限参与：它们只能看到发现信息，而非你的记忆。随着时间推移，如果它们证明了自己可靠，信任等级会提升。如果行为不端，立即降级 —— 无需人工介入。

不需要配置握手或管理证书。执行 federation init、federation join，Agent 就会开始对话。协议处理身份，PII pipeline 处理数据安全，审计日志处理合规。

📘 完整用户指南：docs/federation/ —— 安装、MCP 工具、信任等级、熔断器，以及（可选的）WireGuard mesh 层，将数据包层可达性与联邦信任绑定。深度解读见 ADR-111：docs/federation/phase7-mesh-bringup.md。

# Team A: 初始化联邦并生成密钥对
npx claude-flow@latest federation init

# Team A: 加入 Team B 的联邦端点
npx claude-flow@latest federation join wss://team-b.example.com:8443

# Team A: 发送任务 —— PII 在离开前自动剥离
npx claude-flow@latest federation send --to team-b --type task-request \
  --message "Analyze transaction patterns for account anomalies"

# Team A: 检查对等信任等级和会话健康状态
npx claude-flow@latest federation status

完整架构、信任模型和实现路线图见 issue #1669。

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

# 或通过 CLI
npx claude-flow@latest plugins install @claude-flow/plugin-agent-federation

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

用户指南索引：