Ruflo

Ruflo 是什么

Ruflo 是面向 Claude Code 与 Codex 的智能体元框架，负责在模型之外提供工具、记忆、执行循环、沙箱、路由与安全控制。其基本理念是：模型负责生成内容，框架负责让模型能够持续完成实际工作。

项目源于早期的 Claude Flow，于 2025 年 6 月开始构建递归式智能体编排层，后续逐步加入任务调度、记忆、终端控制、图谱检索、联邦通信和企业安全能力。Ruflo 的目标不是让智能体仅仅执行单次任务，而是让它们组成团队、共享经验、跨会话记忆，并在不同机器之间安全协作。

核心能力

Ruflo 提供 100 多个专用智能体，覆盖编码、测试、安全审计、文档生成、架构设计、交易分析和知识管理等领域。智能体可按层级、网状或自适应拓扑组成 swarm，通过共识机制分工执行复杂任务。

主要能力包括：

• 自学习：利用 SONA 神经模式、ReasoningBank 和任务轨迹学习成功经验。
• 向量记忆：通过 HNSW 索引的 AgentDB 保存和检索历史上下文。
• 插件市场：提供核心编排、记忆、知识图谱、模型路由、成本追踪和安全审计等插件。
• 多模型支持：可接入 Claude、GPT、Gemini、Cohere 及 Ollama 等模型。
• 后台工作器：自动执行审计、优化、测试缺口检测等周期任务。
• 智能体联邦：不同机器、组织或云区域中的智能体可通过零信任机制发现彼此并交换任务。
• 安全控制：提供提示注入检测、PII 过滤、输入校验、CVE 修复和路径遍历防护。

AgentDB 在较大数据集上使用近似最近邻检索，相比暴力搜索可获得显著性能提升；实际效果取决于数据规模、索引配置和召回要求。

技术架构

概念上的调用链为：

用户 → Ruflo CLI/MCP → 路由器 → Swarm → 智能体 → 记忆 → LLM 提供商

记忆系统会将成功或失败的执行轨迹反馈给路由器，用于后续任务选择和策略调整。MCP 用于向支持 MCP 的客户端暴露 Ruflo 工具；控制台和 Mods 则主要面向 Claude Code 集成。

智能体联邦采用零信任设计：远程智能体初始为不可信状态，通过 mTLS 与 ed25519 挑战响应验证身份。出站消息会经过 PII 检测管线，并依据信任等级执行阻断、脱敏、哈希或放行。系统会持续评估成功率和运行稳定性，动态提升或降低对等节点权限；异常行为可触发即时降权。

安装与初始化

在 Claude Code 中安装核心工具、控制台和 Mods：

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-console@ruflo
/plugin install ruflo-mods@ruflo
/reload-plugins
/ruflo

其中，ruflo-core 提供基础工具，ruflo-console 提供智能体控制台，ruflo-mods 用于提示路由和策略执行。Mods 使用当前账户权限运行，安装前应检查其代码。

使用 Codex 或其他支持 MCP 的客户端时，可在项目目录运行：

npx ruflo@latest init wizard

然后将 MCP 服务器配置为：

{
  "command": "npx",
  "args": ["-y", "ruflo@latest", "mcp", "start"]
}

也可直接启动：

npx -y ruflo@latest mcp start

两种安装路径

Claude Code 插件

适合只想试用部分命令或智能体定义的场景。该路径基本不修改项目工作区，安装简单，但通常不包含完整 CLI 流程中的所有命令、钩子和守护进程。

/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
/plugin install ruflo-rag-memory@ruflo

ruflo-core 包含自己的 MCP 配置，工具名称通常采用类似以下形式：

mcp__plugin_ruflo-core_ruflo__memory_store

完整 CLI 安装

适合生产使用和完整自动化流程：

npx ruflo@latest init wizard

该方式会在项目中生成 .claude/、.claude-flow/、CLAUDE.md、辅助脚本和设置文件，并注册 MCP 服务器、钩子及后台能力。Windows 用户应使用上述 npx 命令；curl | bash 仅适用于 POSIX Shell、WSL 或 Git Bash。

控制台与权限

控制台可展示工作流、智能体、模型、令牌消耗、成本和运行状态，也可查看日志、失败原因、重放执行过程并比较结果。

Claude 控制权限分为：

• read：只读
• write：允许写入
• manage：允许管理操作
• full：完整控制

同时可选择 ask 或 auto 审批模式。默认配置为 read + ask。网络访问、消费和破坏性操作即使在自动模式下也会要求确认。用户可随时通过控制台的“Take back control”操作暂停 Claude 对控制台的控制。

智能体联邦配置

联邦功能可初始化、加入并发送跨机器任务：

npx claude-flow@latest federation init
npx claude-flow@latest federation join wss://team-b.example.com:8443
npx claude-flow@latest federation send --to team-b --type task-request \
  --message "分析交易模式，识别账户异常"
npx claude-flow@latest federation status

出站数据会自动进行 PII 过滤，消息和信任变更会保留审计记录。Federation 不要求手动配置握手协议或证书，身份验证、数据安全和合规记录由系统协议统一处理。