Ruflo 智能体编排平台
为 Claude Code 与 Codex 提供多智能体协作、记忆和自动化执行层。
- 源仓库
- ruvnet/ruflo
- Star 数
- ★ 81k
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 45/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Claude Code 的工程团队，希望在代码、测试、审查和安全任务之间自动分派多个专用智能体。
- 不适合
- 只想用轻量斜杠命令插件、不愿改动工作区文件的团队
- 无法接受跨机器联邦带来的身份、PII 与合规治理负担的组织
- 源码审查
- 45/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Ruflo 是面向 Claude Code 和 Codex 的智能体元编排框架，可通过 CLI、MCP 服务器和 Claude Code 插件交付。完整 CLI 安装会在工作区创建 .claude/、.claude-flow/、CLAUDE.md、辅助文件和设置，并安装 MCP、hooks 与后台能力。它组织专用智能体以层级、网格或自适应拓扑协作，并结合 AgentDB、HNSW、SONA 和 ReasoningBank 记录与检索任务经验。项目还提供插件市场、跨机器的联邦协作，以及可自托管的 RuFlo Web UI 和目标规划界面。适合希望在既有编码代理周围增加协调、持久记忆和工作流控制的团队，而非只安装几个斜杠命令的轻量使用场景。
执行 npx ruflo@latest init wizard 或 init 后，Ruflo 将 CLI 与 hooks 接入工作区，并可用 claude mcp add ruflo -- npx ruflo@latest mcp start 注册 MCP 服务器。其路由器把任务分配给 swarm 中的专用智能体；智能体可使用 memory_store、swarm_init、agent_spawn 等 MCP 能力，并将任务信息写入或从 AgentDB 的 HNSW 向量记忆中检索。插件覆盖工作流、测试生成、Playwright 浏览器测试、文档、风险分析、安全审计和可观测性等操作。联邦模式通过 federation init、federation join、federation send 和 federation status 处理远程节点协作，并对外发消息执行身份、PII 与审计处理。
- 使用 Claude Code 的工程团队，希望在代码、测试、审查和安全任务之间自动分派多个专用智能体。
- 需要跨会话保存项目经验，并通过向量检索为后续开发任务提供上下文的软件团队。
- 需要以 MCP 方式把智能体编排、记忆和 swarm 控制接入 Claude Code 的开发者。
- 希望用 ruflo-browser 的 Playwright 自动化执行浏览器测试、并用 ruflo-testgen 补充测试缺口的 QA 团队。
- 多个机器或组织之间需要协作，但希望通过 mTLS、ed25519、PII 处理和审计记录控制数据交换的团队。
- 希望在自托管网页聊天中调用 MCP 工具，或将自然语言目标拆解为可执行计划的内部平台团队。
如何安装或部署这个 Agent？
完整安装：运行 npx ruflo@latest init wizard；非交互式安装可运行 npx ruflo@latest init，也可使用 npm install -g ruflo@latest。在 macOS、Linux、WSL 或 Git-Bash 中，文档还提供 curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash。若只需 Claude Code 的斜杠命令，先运行 /plugin marketplace add ruvnet/ruflo，再运行例如 /plugin install ruflo-core@ruflo 和 /plugin install ruflo-swarm@ruflo；这种插件路径不会注册 MCP 服务器或 hooks。要在 Claude Code 中注册完整 MCP 服务，运行 claude mcp add ruflo -- npx ruflo@latest mcp start。
如何使用这个 Agent？
完成完整初始化后，可正常使用 Claude Code；文档说明 hooks 会在后台路由任务、学习成功模式并协调智能体。需要显式接入时，先用 claude mcp add ruflo -- npx ruflo@latest mcp start 注册服务，再调用已列出的 MCP 能力，例如 memory_store、swarm_init 或 agent_spawn。跨节点协作可从 npx claude-flow@latest federation init 开始，再以 federation join <endpoint> 加入端点并使用 federation send 发送任务。托管 Web UI 可直接在 flo.ruv.io 试用，文档称无需账户或 API key；自托管版本位于 ruflo/src/ruvocal/，并附带 Dockerfile。
这个 Agent 有哪些优点和局限？
- 完整 CLI 路径同时提供 MCP 服务器、hooks、daemon、专用智能体、命令和 skills，而不只是插件命令。
- 协调层明确支持层级、网格和自适应 swarm 拓扑，并把持久记忆与 AgentDB/HNSW 连接起来。
- 联邦功能记录了 mTLS、ed25519、PII 处理、信任评分和审计轨迹，适用于有跨节点协作要求的场景。
- 同时提供 Claude Code 插件、CLI/MCP、托管 Web UI 与 Docker 自托管边界，并列出 Claude、GPT、Gemini、Cohere、Ollama 等多提供商路径。
- Claude Code 插件安装是轻量路径：不会注册 MCP，因此 memory_store、swarm_init 和 agent_spawn 等能力不可调用。
- 完整初始化会在工作区写入 .claude/、.claude-flow/、CLAUDE.md、辅助文件和设置，采用前应评估对现有仓库配置的影响。
- 许多能力以插件、MCP、后台 worker 和外部模型提供商组合提供；文档未在所给材料中列出完整 CLI 的运行时前置条件或凭据配置细节。
- 联邦协作涉及远程端点、身份验证、信任等级与 PII 策略，因此比单机 Claude Code 工作流具有更高的部署和治理复杂度。
这个 Agent 与同类方案有什么区别？
README 将“Claude Code Alone”与“+ Ruflo”对比：前者的协作与上下文较为孤立、记忆限于会话且需手工编排；Ruflo 增加 swarm 协调、HNSW 向量记忆、SONA 学习、任务路由、后台 worker 和多提供商路径。这是围绕 Claude Code 的增强层，而不是对 Claude Code 本身的替代描述。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Ruflo 智能体编排平台 当前 | 45 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 81k | 今天 | TypeScript | Codex · Claude Code · OpenAI API |
| Emulo | 78 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 302 | 25 天前 | HTML | Codex · Claude Code |
| Remembra Relay | 72 · 存在缺口 | Agent 插件 / 技能免费版 + 付费版 | ★ 16 | 11 天前 | Python | Claude Code |
| OpenRig | 79 · 表现良好 | 命令行工具免费 + 模型费 | ★ 8.7k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示有安全措施（如AIDefence、输入验证、路径遍历防护）和联邦的PII剥离，但缺少用户确认机制和最小权限的详细说明。扣分：未明确用户确认流程，权限管理细节不足。
有测试（如arena测试）和CI工作流，但依赖众多且部分为alpha版本，失败消息未详细说明。扣分：依赖可用性未验证，失败消息不充分。
面向多种场景（编码、测试、安全等），有插件系统，但触发精度和边界描述不清晰。扣分：触发机制细节不足，环境适配未全面说明。
有README、安装说明、许可证，但命名稳定性（如claude-flow vs ruflo）和版本变更记录不明确。扣分：命名不一致，变更日志缺失。
输出可用性高（有CLI、MCP、Web UI），边际价值明显，但成本效益未量化。扣分：成本效益分析缺失。
有测试和审计文档，但声明与证据的对应关系不完整，跨源验证不足。扣分：声明可追溯性有限，事实与推断分离不清晰。
- 依赖众多且部分为alpha版本，需关注供应链安全。
- 命名不一致（claude-flow vs ruflo）可能导致混淆。
- 缺少明确的用户确认机制，自动化操作需谨慎。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v3.71.4 v3.71.4 — security patch
发布说明摘录
Security patch release: @claude-flow/cli, claude-flow, ruflo 3.71.4. Upgrade is recommended for everyone who runs the ruflo MCP server. Security fixes - browser tools (#4783): browser_open accepts only a fixed list of plain Chromium switches. No caller value may add an agent-browser option. - memory export / import (#4783): - For MCP callers, memory_export and memory_import paths must be inside the project. Symlinks, .git, executables, and servers started from a home or filesystem root are refused. - Import errors no longer quote the file. …在 GitHub 查看 ↗ -
v3.71.3 v3.71.3 — Claude Code 2.1.318 adoption, narrow band, AutoMemory + daemon fixes
发布说明摘录
Patch release: @claude-flow/cli, claude-flow, ruflo 3.71.3. Standalone packages: @claude-flow/performance 3.0.1 and @claude-flow/browser 3.0.1. Claude Code 2.1.290–2.1.318 adoption - Headless workers: they pass --permission-mode auto, so they no longer stall in 2.1.302's manual default. They read credential_expires_at and emit a warning 10 days before a sign-in ends (#4699). - pre-bash gate: fails closed with onFailure: "block" (#4699). …在 GitHub 查看 ↗ -
v3.71.2 v3.71.2 — PR sweep fixes + providers 3.0.1
发布说明摘录
Patch release: @claude-flow/cli, claude-flow, ruflo 3.71.2, plus standalone @claude-flow/providers 3.0.1. Fixes - embeddings: embeddings_search honours threshold: 0 (#4611); CLI reads --db-path, --max-size, --ef-construction, --batch-size (#4675) - session: save/restore/export honour the component flags (#4649) - memory: list pages row identities before loading payloads (#4687, closes #4686) - claims: claims_steal keeps the claim context when no handoff context is given (#4656); claims_status takes a claim off the stealable list (#4655) …在 GitHub 查看 ↗