{"id":"079a5ce3-efd4-4fa6-a32b-76af191e3f93","entityType":"agent","slug":"clawhub-cn-big-cabbage-claude-flow","name":"Claude Flow","canonicalUrl":"https://www.xpersona.co/agent/clawhub-cn-big-cabbage-claude-flow","canonicalPath":"/agent/clawhub-cn-big-cabbage-claude-flow","generatedAt":"2026-10-11T10:51:17.332Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-11T08:15:26.143Z","emptyReason":null},"description":"Claude Code 多智能体编排平台，部署 100+ 专业 AI 智能体协同工作，通过蜂群拓扑（层级/网状/环形/星形）协调自主工作流，内置自学习、向量记忆和原生 MCP 集成 Skill: Claude Flow Owner: cn-big-cabbage Summary: Claude Code 多智能体编排平台，部署 100+ 专业 AI 智能体协同工作，通过蜂群拓扑（层级/网状/环形/星形）协调自主工作流，内置自学习、向量记忆和原生 MCP 集成 Tags: latest:0.1.1 Version history: v0.1.1 | 2026-06-16T10:07:46.605Z | auto - Added _meta.json file to the project. - Updated SKILL.md to version 0.1.1, specifying required binaries (node, npx) in metadata. - Removed skill-card.md from the repository. v0.1.0 | 2026-04-22T00:41:","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.","installCommand":"clawhub skill install s17dbd0j0kazk5ay31x9kv1z3n84f04v:claude-flow","sourceUrl":"https://clawhub.ai/cn-big-cabbage/claude-flow","homepage":"https://clawhub.ai/cn-big-cabbage/skills/claude-flow","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/cn-big-cabbage/claude-flow","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/cn-big-cabbage/skills/claude-flow","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Claude Code 多智能体编排平台，部署 100+ 专业 AI 智能体协同工作，通过蜂群拓扑（层级/网状/环形/星形）协调自主工作流，内置自学习、向量记忆和原生 MCP 集成 Skill: Claude Flow Owner: cn-big-cabbage Summary: Claude Code 多智能体编排平"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:15:26.143Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:15:26.143Z","emptyReason":null},"stars":null,"forks":null,"downloads":1115,"packageName":null,"latestVersion":"0.1.1","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-11T08:15:26.072Z","emptyReason":null},"lastUpdatedAt":"2026-10-11T08:15:26.143Z","lastCrawledAt":"2026-10-11T08:15:26.072Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-12T08:15:26.072Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.1","createdAt":"2026-06-16T10:07:46.605Z","changelog":"- Added _meta.json file to the project. - Updated SKILL.md to version 0.1.1, specifying required binaries (node, npx) in metadata. - Removed skill-card.md from the repository.","fileCount":7,"zipByteSize":12218},{"version":"0.1.0","createdAt":"2026-04-22T00:41:58.300Z","changelog":"Initial release of Claude-Flow — a multi-agent orchestration platform for Claude Code. - Orchestrates 100+ specialized AI agents with swarm topologies (hierarchical, mesh, ring, star). - Integrates natively with Claude Code MCP; simple setup via one-click install or NPX wizard. - Supports automated workflows for coding, review, testing, security, architecture, and documentation. - Features self-learning (vector memory), consensus algorithms (Raft/Byzantine/Gossip), and multi-LLM support (Claude/GPT/Gemini/Ollama). - Includes built-in security protections and customizable plugin system.","fileCount":7,"zipByteSize":12314}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17dbd0j0kazk5ay31x9kv1z3n84f04v:claude-flow","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T10:51:17.331Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-cn-big-cabbage-claude-flow/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-11T08:15:26.143Z","emptyReason":null},"readme":"Skill: Claude Flow\n\nOwner: cn-big-cabbage\n\nSummary: Claude Code 多智能体编排平台，部署 100+ 专业 AI 智能体协同工作，通过蜂群拓扑（层级/网状/环形/星形）协调自主工作流，内置自学习、向量记忆和原生 MCP 集成\n\nTags: latest:0.1.1\n\nVersion history:\n\nv0.1.1 | 2026-06-16T10:07:46.605Z | auto\n\n- Added _meta.json file to the project.\n- Updated SKILL.md to version 0.1.1, specifying required binaries (node, npx) in metadata.\n- Removed skill-card.md from the repository.\n\nv0.1.0 | 2026-04-22T00:41:58.300Z | auto\n\nInitial release of Claude-Flow — a multi-agent orchestration platform for Claude Code.\n\n- Orchestrates 100+ specialized AI agents with swarm topologies (hierarchical, mesh, ring, star).\n- Integrates natively with Claude Code MCP; simple setup via one-click install or NPX wizard.\n- Supports automated workflows for coding, review, testing, security, architecture, and documentation.\n- Features self-learning (vector memory), consensus algorithms (Raft/Byzantine/Gossip), and multi-LLM support (Claude/GPT/Gemini/Ollama).\n- Includes built-in security protections and customizable plugin system.\n\nArchive index:\n\nArchive v0.1.1: 7 files, 12218 bytes\n\nFiles: _meta.json (130b), guides/01-installation.md (2092b), guides/02-quickstart.md (3822b), guides/03-advanced-usage.md (4875b), skill-card.md (2599b), SKILL.md (4638b), troubleshooting.md (5264b)\n\nFile v0.1.1:SKILL.md\n\n---\nname: claude-flow\ndescription: Claude Code 多智能体编排平台，部署 100+ 专业 AI 智能体协同工作，通过蜂群拓扑（层级/网状/环形/星形）协调自主工作流，内置自学习、向量记忆和原生 MCP 集成\nversion: 0.1.1\nmetadata:\n openclaw:\n requires:\n bins:\n - node\n - npx\n emoji: 🌊\n homepage: https://github.com/ruvnet/claude-flow\n---\n\n# Claude-Flow — Claude Code 多智能体编排平台\n\nClaude-Flow（现更名为 Ruflo）是专为 Claude Code 设计的企业级多智能体编排框架，将 Claude Code 变成强大的多智能体开发平台。通过 MCP 原生集成，可在 Claude Code 会话中直接协调 100+ 专业智能体（coder、tester、reviewer、architect、security 等），智能体通过蜂群拓扑自组织，支持层级（Queen/Worker）或网状（P2P）协作模式，并具备持续自学习能力。\n\n## 核心使用场景\n\n- **复杂软件工程任务**：自动分解大型任务，分配给专业智能体并行处理\n- **代码审查与安全审计**：同时运行 reviewer、security、tester 智能体进行全面检查\n- **架构设计**：architect 智能体协调 researcher、analyst 智能体完成技术选型\n- **自动化测试**：tester 智能体批量生成和执行测试，optimizer 智能体分析结果\n- **文档生成**：documenter 智能体并发处理多个模块的文档\n\n## AI 辅助使用流程\n\n1. **一键安装** — AI 执行 `npx ruflo@latest init --wizard` 完成 Claude Code MCP 集成\n2. **选择智能体** — AI 根据任务选择合适的专业智能体类型\n3. **启动蜂群** — AI 启动智能体蜂群，自动设置 Queen/Worker 拓扑\n4. **监控协调** — AI 实时查看智能体状态和任务分配\n5. **收集成果** — 智能体协作完成后，Queen 整合所有工作成果\n6. **知识复用** — 成功模式自动存入向量记忆，未来同类任务直接复用\n\n## 关键章节导航\n\n- [安装指南](guides/01-installation.md) — npx 安装、MCP 配置、Claude Code 集成\n- [快速开始](guides/02-quickstart.md) — 启动智能体、蜂群模式、对话驱动编排\n- [高级用法](guides/03-advanced-usage.md) — 自定义智能体、多模型切换、向量记忆、插件\n- [故障排查](troubleshooting.md) — MCP 连接、智能体超时、记忆数据库\n\n## AI 助手能力\n\n使用本技能时，AI 可以：\n\n- ✅ 安装 Claude-Flow 并配置 Claude Code MCP 集成\n- ✅ 启动和配置专业智能体（coder、tester、reviewer 等）\n- ✅ 组建蜂群，设置 Queen/Worker 层级拓扑\n- ✅ 分解复杂任务并分配给最合适的智能体\n- ✅ 监控智能体状态和任务进度\n- ✅ 查询和利用智能体向量记忆中存储的成功模式\n- ✅ 切换不同 LLM 提供商（Claude/GPT/Gemini/Ollama）\n\n## 核心功能\n\n- ✅ **100+ 专业智能体** — 涵盖 coder、tester、reviewer、architect、security 等角色\n- ✅ **蜂群协调** — 层级（Queen/Worker）、网状（P2P）、环形、星形拓扑\n- ✅ **容错共识** — Raft、Byzantine、Gossip 三种共识算法\n- ✅ **自学习记忆** — HNSW 向量搜索 + SQLite 持久化，成功模式自动复用\n- ✅ **MCP 原生集成** — 310+ MCP 工具，直接在 Claude Code 中使用\n- ✅ **多 LLM 支持** — Claude/GPT/Gemini/Cohere/Ollama，自动故障切换\n- ✅ **WASM 优化引擎** — 简单任务跳过 LLM 调用（<1ms），Token 压缩 30-50%\n- ✅ **安全防护** — 内置提示注入防护、路径遍历防护、命令注入拦截\n- ✅ **插件系统** — 自定义 Worker、Hook、Provider，IPFS 市场分发\n\n## 快速示例\n\n```bash\n# 一键安装（推荐）\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash\n\n# 或通过 npx\nnpx ruflo@latest init --wizard\n\n# 启动 Claude Code MCP 服务器\nnpx ruflo@latest mcp start\n\n# 查看可用智能体\nnpx ruflo@latest agent list\n\n# 启动蜂群处理复杂任务\nnpx ruflo@latest swarm start --topology hierarchical --agents coder,tester,reviewer\n```\n\n在 Claude Code 对话中直接使用：\n```\n# 直接描述任务，Claude-Flow 自动路由到合适智能体\n帮我审查 src/auth/ 目录的安全性，需要代码审查、安全扫描和测试覆盖率检查\n```\n\n## 安装要求\n\n| 依赖 | 版本要求 |\n|------|---------|\n| Node.js | >= 18.0 |\n| Claude Code | 最新版 |\n| npm/npx | 任意版本 |\n| Anthropic API Key | 必需（用于 Claude） |\n\n## 项目链接\n\n- GitHub：https://github.com/ruvnet/claude-flow\n- npm：https://www.npmjs.com/package/claude-flow\n- Discord：https://discord.com/invite/dfxmpwkG2D\n\nFile v0.1.1:_meta.json\n\n{\n \"ownerId\": \"kn7c5ry95ff7x22mt3fx6j0q3d81p8t3\",\n \"slug\": \"claude-flow\",\n \"version\": \"0.1.1\",\n \"publishedAt\": 1781604466605\n}\n\nFile v0.1.1:guides/01-installation.md\n\n# 安装指南\n\n## 适用场景\n\n- 在 Claude Code 中安装和配置 Claude-Flow\n- 通过 MCP 将 Claude-Flow 集成到 Claude Code 工作流\n- 配置 Anthropic API 密钥\n\n---\n\n## 方式一：一键安装脚本（推荐）\n\n> **AI 可自动执行**\n\n```bash\n# 完整安装（MCP + 诊断工具）\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash -s -- --full\n\n# 或仅基础安装\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash\n```\n\n---\n\n## 方式二：npx 安装\n\n```bash\n# 交互式向导安装\nnpx ruflo@latest init --wizard\n\n# 或直接初始化（接受默认配置）\nnpx ruflo@latest init\n```\n\n---\n\n## 方式三：全局 npm 安装\n\n```bash\nnpm install -g claude-flow\n# 或\nnpm install -g ruflo\n\n# 验证\nclaude-flow --version\nruflo --version\n```\n\n---\n\n## 配置 Anthropic API 密钥\n\n```bash\nexport ANTHROPIC_API_KEY=\"sk-ant-...\"\n\n# 或写入 .env 文件\necho 'ANTHROPIC_API_KEY=sk-ant-...' >> .env\n```\n\n---\n\n## 在 Claude Code 中配置 MCP\n\n### 自动配置（推荐）\n\n```bash\n# 在 Claude Code 会话中执行\nclaude mcp add claude-flow --scope user npx ruflo@latest mcp start\n```\n\n### 手动配置\n\n在 `~/.claude/settings.json` 中添加：\n\n```json\n{\n \"mcpServers\": {\n \"claude-flow\": {\n \"command\": \"npx\",\n \"args\": [\"ruflo@latest\", \"mcp\", \"start\"],\n \"env\": {\n \"ANTHROPIC_API_KEY\": \"your-key\"\n }\n }\n }\n}\n```\n\n**安装后必须重启 Claude Code** 使 MCP 生效。\n\n---\n\n## 验证安装\n\n```bash\n# 检查版本\nnpx ruflo@latest --version\n\n# 检查 Claude Code MCP 集成\nclaude mcp list # 应显示 claude-flow\n\n# 查看可用智能体\nnpx ruflo@latest agent list\n\n# 系统诊断\nnpx ruflo@latest hooks intelligence --status\n```\n\n---\n\n## 完成确认检查清单\n\n- [ ] 安装命令执行成功\n- [ ] `ANTHROPIC_API_KEY` 环境变量已配置\n- [ ] Claude Code 重启后 MCP 工具可用\n- [ ] `npx ruflo@latest agent list` 显示可用智能体列表\n\n---\n\n## 下一步\n\n- [快速开始](02-quickstart.md) — 启动智能体、蜂群模式、在 Claude Code 中使用\n\nFile v0.1.1:guides/02-quickstart.md\n\n# 快速开始\n\n## 适用场景\n\n- 在 Claude Code 中使用 Claude-Flow 智能体\n- 组建蜂群处理复杂任务\n- 查看和管理智能体状态\n\n---\n\n## 在 Claude Code 中直接使用（最简单）\n\n安装完成后，Claude-Flow 通过 MCP 集成到 Claude Code。**你不需要学习所有命令**，直接在对话中描述任务即可：\n\n```\n帮我审查 src/auth/ 目录的代码安全性\n\n帮我为 payments 模块写完整的测试套件\n\n重构 database.ts，提高性能并改善错误处理\n```\n\nClaude-Flow 会自动路由到合适的专业智能体（security、tester、refactor 等）。\n\n---\n\n## 查看可用智能体\n\n```bash\n# 列出所有可用智能体\nnpx ruflo@latest agent list\n\n# 查看特定智能体详情\nnpx ruflo@latest agent info coder\nnpx ruflo@latest agent info security\n```\n\n常用智能体类型：\n\n| 智能体 | 职责 |\n|--------|------|\n| `coder` | 代码编写和实现 |\n| `tester` | 测试编写和执行 |\n| `reviewer` | 代码审查 |\n| `architect` | 技术架构设计 |\n| `security` | 安全扫描和审计 |\n| `documenter` | 文档生成 |\n| `optimizer` | 性能优化 |\n| `researcher` | 技术调研 |\n\n---\n\n## 手动启动单个智能体\n\n```bash\n# 启动 coder 智能体处理特定任务\nnpx ruflo@latest agent spawn coder \\\n --task \"实现用户认证模块，包含 JWT 刷新机制\"\n\n# 启动 security 智能体审计代码\nnpx ruflo@latest agent spawn security \\\n --task \"审计 src/api/ 目录的安全性\" \\\n --files \"src/api/\"\n```\n\n---\n\n## 启动蜂群（多智能体协作）\n\n```bash\n# 层级蜂群（Queen 协调 Worker）\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --agents coder,tester,reviewer,security \\\n --task \"实现并测试用户注册和登录 API\"\n\n# 网状蜂群（P2P 协作，适合研究任务）\nnpx ruflo@latest swarm start \\\n --topology mesh \\\n --agents researcher,architect,documenter \\\n --task \"设计微服务架构方案\"\n\n# 查看蜂群状态\nnpx ruflo@latest swarm status\n```\n\n---\n\n## 常见任务模式\n\n### 全链路代码实现\n\n```bash\n# 让多个智能体协作完成从设计到测试的完整流程\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --agents architect,coder,tester,reviewer \\\n --task \"设计并实现一个 RESTful API 用于用户管理（CRUD），包含完整测试\"\n```\n\n### 代码质量审查\n\n```bash\n# 并行运行审查、安全、测试三个智能体\nnpx ruflo@latest swarm start \\\n --topology mesh \\\n --agents reviewer,security,tester \\\n --task \"全面审查 src/ 目录的代码质量、安全性和测试覆盖率\"\n```\n\n### 紧急 Bug 修复\n\n```bash\n# 单个 coder 智能体快速处理\nnpx ruflo@latest agent spawn coder \\\n --task \"修复 payment.ts 中的竞态条件 bug，错误出现在 processPayment 函数\"\n```\n\n---\n\n## 查看学习记忆\n\nClaude-Flow 会记住成功的任务模式，可以查询：\n\n```bash\n# 查看记忆系统状态\nnpx ruflo@latest hooks intelligence --status\n\n# 搜索历史成功模式\nnpx ruflo@latest memory search \"authentication\"\n```\n\n---\n\n## MCP 工具列表\n\n在 Claude Code 中，Claude-Flow 暴露 310+ MCP 工具：\n\n```\n# 在 Claude Code 中查询可用工具\n/mcp list\n\n# 常用工具（自动调用，无需手动触发）\nclaude_flow_agent_spawn — 启动智能体\nclaude_flow_swarm_start — 启动蜂群\nclaude_flow_memory_search — 搜索历史模式\nclaude_flow_task_status — 查看任务状态\n```\n\n---\n\n## 完成确认检查清单\n\n- [ ] Claude Code 中 Claude-Flow MCP 工具可用（`/mcp list` 可见）\n- [ ] `npx ruflo@latest agent list` 显示可用智能体\n- [ ] 简单任务通过对话自动路由到合适智能体\n- [ ] 蜂群模式成功启动并完成任务\n\n---\n\n## 下一步\n\n- [高级用法](03-advanced-usage.md) — 自定义智能体、多模型切换、向量记忆管理\n\nFile v0.1.1:guides/03-advanced-usage.md\n\n# 高级用法\n\n## 多 LLM 提供商切换\n\nClaude-Flow 支持在不同 LLM 提供商之间切换，并自动故障切换：\n\n```bash\n# 配置多个提供商\nnpx ruflo@latest config set provider anthropic --api-key $ANTHROPIC_API_KEY\nnpx ruflo@latest config set provider openai --api-key $OPENAI_API_KEY\nnpx ruflo@latest config set provider google --api-key $GOOGLE_API_KEY\n\n# 指定智能体使用特定提供商\nnpx ruflo@latest agent spawn coder \\\n --provider anthropic \\\n --model claude-opus-4-7 \\\n --task \"实现复杂算法\"\n\n# 经济型任务使用便宜模型\nnpx ruflo@latest agent spawn documenter \\\n --provider anthropic \\\n --model claude-haiku-4-5-20251001 \\\n --task \"生成 API 文档\"\n\n# 使用本地 Ollama\nnpx ruflo@latest agent spawn researcher \\\n --provider ollama \\\n --model llama3.2 \\\n --task \"技术调研\"\n```\n\n---\n\n## 自定义智能体\n\n创建自己的专业智能体：\n\n```javascript\n// agents/custom-agent.js\nmodule.exports = {\n name: \"data-analyst\",\n description: \"专门处理数据分析和可视化任务的智能体\",\n capabilities: [\"data_analysis\", \"visualization\", \"statistics\"],\n \n systemPrompt: `You are an expert data analyst. \n Focus on: statistical analysis, data quality, visualization recommendations.\n Always provide actionable insights with quantified impact.`,\n \n tools: [\"read_file\", \"write_file\", \"execute_code\"],\n \n hooks: {\n beforeTask: async (task) => {\n // 预处理任务\n return task;\n },\n afterTask: async (result) => {\n // 后处理结果\n return result;\n }\n }\n};\n```\n\n```bash\n# 注册自定义智能体\nnpx ruflo@latest agent register agents/custom-agent.js\n\n# 使用自定义智能体\nnpx ruflo@latest agent spawn data-analyst \\\n --task \"分析 sales.csv，找出销售下降的原因\"\n```\n\n---\n\n## 向量记忆管理\n\nClaude-Flow 使用 HNSW 向量数据库记录成功模式：\n\n```bash\n# 查看记忆使用状态\nnpx ruflo@latest memory status\n\n# 搜索相关历史模式\nnpx ruflo@latest memory search \"authentication JWT\"\nnpx ruflo@latest memory search \"database optimization\"\n\n# 导出记忆数据库（备份）\nnpx ruflo@latest memory export backup-2026.json\n\n# 清理低质量记忆\nnpx ruflo@latest memory prune --min-confidence 0.7\n\n# 查看智能体学习曲线\nnpx ruflo@latest hooks intelligence --report\n```\n\n---\n\n## Hook 系统\n\nHook 在智能体生命周期的关键节点自动触发：\n\n```bash\n# 查看当前活跃的 Hook\nnpx ruflo@latest hooks list\n\n# 启用代码质量 Hook（每次代码生成后自动运行 linter）\nnpx ruflo@latest hooks enable code-quality\n\n# 启用安全扫描 Hook\nnpx ruflo@latest hooks enable security-scan\n\n# 查看 Hook 执行日志\nnpx ruflo@latest hooks logs --last 20\n```\n\n---\n\n## 蜂群拓扑详解\n\n```bash\n# 层级拓扑（Queen 管理 Worker，适合大任务分解）\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --queen-agent architect \\\n --worker-agents coder,tester,reviewer,documenter \\\n --consensus majority \\\n --task \"设计和实现完整的电商订单系统\"\n\n# 环形拓扑（顺序流水线，适合步骤明确的任务）\nnpx ruflo@latest swarm start \\\n --topology ring \\\n --agents researcher,architect,coder,tester \\\n --task \"技术调研 → 设计 → 实现 → 测试\"\n\n# 星形拓扑（一个协调者+多个独立工作者）\nnpx ruflo@latest swarm start \\\n --topology star \\\n --coordinator-agent architect \\\n --agents coder,coder,coder \\ # 多个同类型智能体并行\n --task \"并行实现三个独立的 API 端点\"\n```\n\n---\n\n## WASM 优化引擎\n\nClaude-Flow 包含 WebAssembly 优化引擎，对简单任务跳过 LLM 调用：\n\n```bash\n# 查看 WASM 引擎状态\nnpx ruflo@latest hooks intelligence --wasm-status\n\n# 查看 Token 节省报告（30-50% 压缩）\nnpx ruflo@latest hooks intelligence --token-report\n```\n\n---\n\n## 与 Claude Code 深度集成\n\n在 Claude Code 中，所有 Claude-Flow 功能通过自然语言触发：\n\n```\n# 以下对话会自动触发多智能体协作\n\n我需要为新功能编写完整的测试套件，包含单元测试、集成测试和 E2E 测试\n\n帮我重构 services/ 目录，要求：保持向后兼容，提高可测试性，添加类型注解\n\n对 src/api/ 目录进行完整的安全审查，关注 SQL 注入、XSS、认证绕过风险\n```\n\nClaude-Flow 的 Hook 系统会自动：\n1. 识别任务类型\n2. 选择合适的智能体组合\n3. 设置蜂群拓扑\n4. 协调执行并整合结果\n\n---\n\n## 完成确认检查清单\n\n- [ ] 多 LLM 提供商切换测试（可选）\n- [ ] 自定义智能体注册并成功使用（可选）\n- [ ] 向量记忆搜索返回相关历史模式\n- [ ] 蜂群任务完成，Queen 整合所有工作成果\n\n---\n\n## 相关链接\n\n- [故障排查](../troubleshooting.md)\n- [GitHub](https://github.com/ruvnet/claude-flow)\n- [Discord](https://discord.com/invite/dfxmpwkG2D)\n\nFile v0.1.1:skill-card.md\n\n## Description:\n\nClaude Flow helps Claude Code users orchestrate specialized agents for software engineering workflows, including coding, review, testing, architecture, documentation, and memory-assisted task reuse.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[cn-big-cabbage](https://clawhub.ai/user/cn-big-cabbage)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and engineering teams use this skill to install and configure Claude Flow/Ruflo in Claude Code, start specialist agents or multi-agent swarms, and route software engineering tasks such as implementation, review, testing, architecture, and documentation.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The install guidance includes one-line installer commands and mutable package references such as ruflo@latest.\n\nMitigation: Review installers before execution and prefer pinned, reviewed package versions for installation and MCP startup.\n\nRisk: The workflow requires API keys and can place credentials in shell or MCP configuration.\n\nMitigation: Pass only required credentials and keep API keys out of shell history and plaintext configuration where possible.\n\nRisk: The skill registers a user-scoped MCP server and uses local vector memory that may persist workflow data.\n\nMitigation: Understand how to remove the MCP registration and clear vector memory before deployment.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/cn-big-cabbage/skills/claude-flow)\n- [Claude Flow homepage](https://github.com/ruvnet/claude-flow)\n- [npm package: claude-flow](https://www.npmjs.com/package/claude-flow)\n- [Installation guide](guides/01-installation.md)\n- [Quickstart guide](guides/02-quickstart.md)\n- [Advanced usage guide](guides/03-advanced-usage.md)\n- [Troubleshooting guide](troubleshooting.md)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, code, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with command examples and configuration snippets]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Produces agent-facing instructions for installing, configuring, orchestrating agents, and troubleshooting Claude Flow/Ruflo workflows.]\n\n## Skill Version(s):\n\n0.1.1 (source: SKILL.md frontmatter and server release evidence)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nFile v0.1.1:troubleshooting.md\n\n# 故障排查\n\n## 安装问题\n\n---\n\n### 问题 1：`npx ruflo@latest init` 失败\n\n**难度：** 低\n\n**症状：** `npm ERR! network` 或 `ENOTFOUND`\n\n**解决方案：**\n```bash\n# 清理 npm 缓存后重试\nnpm cache clean --force\nnpx ruflo@latest init --wizard\n\n# 检查 Node.js 版本（需要 >= 18）\nnode --version\n\n# 或使用全局安装\nnpm install -g ruflo\nruflo init --wizard\n```\n\n---\n\n### 问题 2：Claude Code MCP 安装后工具不可用\n\n**难度：** 低\n\n**症状：** 安装后 Claude Code 中看不到 claude-flow 工具\n\n**解决方案：**\n- **必须重启 Claude Code** — MCP 不热加载\n- 验证 MCP 已注册：`claude mcp list`\n- 手动检查配置：`cat ~/.claude/settings.json | grep claude-flow`\n\n```bash\n# 重新添加 MCP（如果 list 中没有）\nclaude mcp add claude-flow --scope user npx ruflo@latest mcp start\n\n# 验证\nclaude mcp list | grep claude-flow\n```\n\n---\n\n### 问题 3：API Key 未配置导致智能体失败\n\n**难度：** 低\n\n**症状：** `AuthenticationError: API key not set` 或智能体立即返回错误\n\n**解决方案：**\n```bash\n# 检查 API Key\necho $ANTHROPIC_API_KEY # 应显示 sk-ant-...\n\n# 永久设置（添加到 shell 配置）\necho 'export ANTHROPIC_API_KEY=\"sk-ant-your-key\"' >> ~/.zshrc\nsource ~/.zshrc\n\n# 或在 Claude-Flow 配置中设置\nnpx ruflo@latest config set api-key $ANTHROPIC_API_KEY\n```\n\n---\n\n## 使用问题\n\n---\n\n### 问题 4：智能体任务超时\n\n**难度：** 中\n\n**症状：** `AgentTimeoutError: Task exceeded timeout` 或智能体长时间无响应\n\n**常见原因：**\n- 任务描述太大或太模糊（概率 50%）\n- 网络请求超时（概率 30%）\n- LLM API 限流（概率 20%）\n\n**解决方案：**\n```bash\n# 增加超时时间\nnpx ruflo@latest agent spawn coder \\\n --timeout 300 \\ # 300 秒超时\n --task \"实现用户认证模块\"\n\n# 分解大任务\nnpx ruflo@latest agent spawn coder \\\n --task \"只实现 JWT 生成函数，不包含其他功能\"\n\n# 检查 API 限流\nnpx ruflo@latest logs --level error --last 20 | grep \"rate limit\"\n```\n\n---\n\n### 问题 5：蜂群智能体结果不一致或互相矛盾\n\n**难度：** 中\n\n**症状：** 多个智能体返回相互矛盾的结果，Queen 无法整合\n\n**常见原因：**\n- 任务描述不明确（概率 60%）\n- 智能体数量过多导致协调开销过大（概率 40%）\n\n**解决方案：**\n```bash\n# 减少智能体数量，使任务更聚焦\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --agents coder,reviewer \\ # 只用 2 个智能体\n --task \"实现 X 功能（具体描述预期输入输出）\"\n\n# 使用 consensus 配置提高一致性\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --consensus weighted \\ # Queen 决策权重 3x\n --agents coder,tester,reviewer \\\n --task \"...\"\n```\n\n---\n\n### 问题 6：向量记忆数据库损坏\n\n**难度：** 中\n\n**症状：** `SQLite database disk image is malformed` 或记忆查询返回错误\n\n**解决方案：**\n```bash\n# 查看记忆数据库位置\nnpx ruflo@latest memory status --verbose\n\n# 备份当前数据库（如果还能访问）\nnpx ruflo@latest memory export backup-before-repair.json\n\n# 重置记忆数据库（丢失历史学习数据，但能恢复功能）\nnpx ruflo@latest memory reset --confirm\n\n# 从备份恢复\nnpx ruflo@latest memory import backup-before-repair.json\n```\n\n---\n\n### 问题 7：MCP 服务器频繁断开\n\n**难度：** 高\n\n**症状：** Claude Code 提示 `MCP server disconnected`，频繁重连\n\n**常见原因：**\n- MCP 服务器崩溃（内存不足）（概率 40%）\n- Node.js 版本不兼容（概率 30%）\n- 进程被系统 OOM killer 终止（概率 30%）\n\n**排查步骤：**\n```bash\n# 手动测试 MCP 服务器\nnpx ruflo@latest mcp start --debug\n\n# 查看错误日志\nnpx ruflo@latest logs --level error --last 50\n\n# 检查 Node.js 版本（需要 >= 18）\nnode --version\n```\n\n**解决方案：**\n```bash\n# 升级 Node.js\nnvm install 20\nnvm use 20\n\n# 增加 Node.js 内存限制\nNODE_OPTIONS=\"--max-old-space-size=4096\" npx ruflo@latest mcp start\n\n# 在 MCP 配置中增加内存\n# ~/.claude/settings.json\n{\n \"mcpServers\": {\n \"claude-flow\": {\n \"command\": \"node\",\n \"args\": [\"--max-old-space-size=4096\", \"/path/to/ruflo/mcp.js\"],\n \"env\": { \"ANTHROPIC_API_KEY\": \"...\" }\n }\n }\n}\n```\n\n---\n\n## 网络/环境问题\n\n---\n\n### 问题 8：Ollama 智能体无法连接本地模型\n\n**难度：** 中\n\n**症状：** `Connection refused: http://127.0.0.1:11434`\n\n**解决方案：**\n```bash\n# 确认 Ollama 正在运行\nollama serve &\ncurl http://127.0.0.1:11434/api/tags # 验证\n\n# 拉取需要的模型\nollama pull llama3.2\n\n# 在 claude-flow 中配置 Ollama\nnpx ruflo@latest config set provider ollama \\\n --url http://127.0.0.1:11434 \\\n --model llama3.2\n```\n\n---\n\n## 通用诊断\n\n```bash\n# 系统诊断\nnpx ruflo@latest hooks intelligence --status\nnpx ruflo@latest --version\n\n# 检查 MCP 连接\nclaude mcp list\nnpx ruflo@latest mcp status\n\n# 查看最近错误日志\nnpx ruflo@latest logs --level error --last 20\n\n# 重置到干净状态（保留 API Key）\nnpx ruflo@latest reset --keep-config\n```\n\n**GitHub Issues：** https://github.com/ruvnet/claude-flow/issues\n\n**Discord：** https://discord.com/invite/dfxmpwkG2D\n\nArchive v0.1.0: 7 files, 12314 bytes\n\nFiles: guides/01-installation.md (2092b), guides/02-quickstart.md (3822b), guides/03-advanced-usage.md (4875b), skill-card.md (2823b), SKILL.md (4598b), troubleshooting.md (5264b), _meta.json (130b)\n\nFile v0.1.0:SKILL.md\n\n---\nname: claude-flow\ndescription: Claude Code 多智能体编排平台，部署 100+ 专业 AI 智能体协同工作，通过蜂群拓扑（层级/网状/环形/星形）协调自主工作流，内置自学习、向量记忆和原生 MCP 集成\nversion: 0.1.0\nmetadata:\n openclaw_requires: \">=1.0.0\"\n emoji: 🌊\n homepage: https://github.com/ruvnet/claude-flow\n---\n\n# Claude-Flow — Claude Code 多智能体编排平台\n\nClaude-Flow（现更名为 Ruflo）是专为 Claude Code 设计的企业级多智能体编排框架，将 Claude Code 变成强大的多智能体开发平台。通过 MCP 原生集成，可在 Claude Code 会话中直接协调 100+ 专业智能体（coder、tester、reviewer、architect、security 等），智能体通过蜂群拓扑自组织，支持层级（Queen/Worker）或网状（P2P）协作模式，并具备持续自学习能力。\n\n## 核心使用场景\n\n- **复杂软件工程任务**：自动分解大型任务，分配给专业智能体并行处理\n- **代码审查与安全审计**：同时运行 reviewer、security、tester 智能体进行全面检查\n- **架构设计**：architect 智能体协调 researcher、analyst 智能体完成技术选型\n- **自动化测试**：tester 智能体批量生成和执行测试，optimizer 智能体分析结果\n- **文档生成**：documenter 智能体并发处理多个模块的文档\n\n## AI 辅助使用流程\n\n1. **一键安装** — AI 执行 `npx ruflo@latest init --wizard` 完成 Claude Code MCP 集成\n2. **选择智能体** — AI 根据任务选择合适的专业智能体类型\n3. **启动蜂群** — AI 启动智能体蜂群，自动设置 Queen/Worker 拓扑\n4. **监控协调** — AI 实时查看智能体状态和任务分配\n5. **收集成果** — 智能体协作完成后，Queen 整合所有工作成果\n6. **知识复用** — 成功模式自动存入向量记忆，未来同类任务直接复用\n\n## 关键章节导航\n\n- [安装指南](guides/01-installation.md) — npx 安装、MCP 配置、Claude Code 集成\n- [快速开始](guides/02-quickstart.md) — 启动智能体、蜂群模式、对话驱动编排\n- [高级用法](guides/03-advanced-usage.md) — 自定义智能体、多模型切换、向量记忆、插件\n- [故障排查](troubleshooting.md) — MCP 连接、智能体超时、记忆数据库\n\n## AI 助手能力\n\n使用本技能时，AI 可以：\n\n- ✅ 安装 Claude-Flow 并配置 Claude Code MCP 集成\n- ✅ 启动和配置专业智能体（coder、tester、reviewer 等）\n- ✅ 组建蜂群，设置 Queen/Worker 层级拓扑\n- ✅ 分解复杂任务并分配给最合适的智能体\n- ✅ 监控智能体状态和任务进度\n- ✅ 查询和利用智能体向量记忆中存储的成功模式\n- ✅ 切换不同 LLM 提供商（Claude/GPT/Gemini/Ollama）\n\n## 核心功能\n\n- ✅ **100+ 专业智能体** — 涵盖 coder、tester、reviewer、architect、security 等角色\n- ✅ **蜂群协调** — 层级（Queen/Worker）、网状（P2P）、环形、星形拓扑\n- ✅ **容错共识** — Raft、Byzantine、Gossip 三种共识算法\n- ✅ **自学习记忆** — HNSW 向量搜索 + SQLite 持久化，成功模式自动复用\n- ✅ **MCP 原生集成** — 310+ MCP 工具，直接在 Claude Code 中使用\n- ✅ **多 LLM 支持** — Claude/GPT/Gemini/Cohere/Ollama，自动故障切换\n- ✅ **WASM 优化引擎** — 简单任务跳过 LLM 调用（<1ms），Token 压缩 30-50%\n- ✅ **安全防护** — 内置提示注入防护、路径遍历防护、命令注入拦截\n- ✅ **插件系统** — 自定义 Worker、Hook、Provider，IPFS 市场分发\n\n## 快速示例\n\n```bash\n# 一键安装（推荐）\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash\n\n# 或通过 npx\nnpx ruflo@latest init --wizard\n\n# 启动 Claude Code MCP 服务器\nnpx ruflo@latest mcp start\n\n# 查看可用智能体\nnpx ruflo@latest agent list\n\n# 启动蜂群处理复杂任务\nnpx ruflo@latest swarm start --topology hierarchical --agents coder,tester,reviewer\n```\n\n在 Claude Code 对话中直接使用：\n```\n# 直接描述任务，Claude-Flow 自动路由到合适智能体\n帮我审查 src/auth/ 目录的安全性，需要代码审查、安全扫描和测试覆盖率检查\n```\n\n## 安装要求\n\n| 依赖 | 版本要求 |\n|------|---------|\n| Node.js | >= 18.0 |\n| Claude Code | 最新版 |\n| npm/npx | 任意版本 |\n| Anthropic API Key | 必需（用于 Claude） |\n\n## 项目链接\n\n- GitHub：https://github.com/ruvnet/claude-flow\n- npm：https://www.npmjs.com/package/claude-flow\n- Discord：https://discord.com/invite/dfxmpwkG2D\n\nFile v0.1.0:_meta.json\n\n{\n \"ownerId\": \"kn7c5ry95ff7x22mt3fx6j0q3d81p8t3\",\n \"slug\": \"claude-flow\",\n \"version\": \"0.1.0\",\n \"publishedAt\": 1776818518300\n}\n\nFile v0.1.0:guides/01-installation.md\n\n# 安装指南\n\n## 适用场景\n\n- 在 Claude Code 中安装和配置 Claude-Flow\n- 通过 MCP 将 Claude-Flow 集成到 Claude Code 工作流\n- 配置 Anthropic API 密钥\n\n---\n\n## 方式一：一键安装脚本（推荐）\n\n> **AI 可自动执行**\n\n```bash\n# 完整安装（MCP + 诊断工具）\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash -s -- --full\n\n# 或仅基础安装\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash\n```\n\n---\n\n## 方式二：npx 安装\n\n```bash\n# 交互式向导安装\nnpx ruflo@latest init --wizard\n\n# 或直接初始化（接受默认配置）\nnpx ruflo@latest init\n```\n\n---\n\n## 方式三：全局 npm 安装\n\n```bash\nnpm install -g claude-flow\n# 或\nnpm install -g ruflo\n\n# 验证\nclaude-flow --version\nruflo --version\n```\n\n---\n\n## 配置 Anthropic API 密钥\n\n```bash\nexport ANTHROPIC_API_KEY=\"sk-ant-...\"\n\n# 或写入 .env 文件\necho 'ANTHROPIC_API_KEY=sk-ant-...' >> .env\n```\n\n---\n\n## 在 Claude Code 中配置 MCP\n\n### 自动配置（推荐）\n\n```bash\n# 在 Claude Code 会话中执行\nclaude mcp add claude-flow --scope user npx ruflo@latest mcp start\n```\n\n### 手动配置\n\n在 `~/.claude/settings.json` 中添加：\n\n```json\n{\n \"mcpServers\": {\n \"claude-flow\": {\n \"command\": \"npx\",\n \"args\": [\"ruflo@latest\", \"mcp\", \"start\"],\n \"env\": {\n \"ANTHROPIC_API_KEY\": \"your-key\"\n }\n }\n }\n}\n```\n\n**安装后必须重启 Claude Code** 使 MCP 生效。\n\n---\n\n## 验证安装\n\n```bash\n# 检查版本\nnpx ruflo@latest --version\n\n# 检查 Claude Code MCP 集成\nclaude mcp list # 应显示 claude-flow\n\n# 查看可用智能体\nnpx ruflo@latest agent list\n\n# 系统诊断\nnpx ruflo@latest hooks intelligence --status\n```\n\n---\n\n## 完成确认检查清单\n\n- [ ] 安装命令执行成功\n- [ ] `ANTHROPIC_API_KEY` 环境变量已配置\n- [ ] Claude Code 重启后 MCP 工具可用\n- [ ] `npx ruflo@latest agent list` 显示可用智能体列表\n\n---\n\n## 下一步\n\n- [快速开始](02-quickstart.md) — 启动智能体、蜂群模式、在 Claude Code 中使用\n\nFile v0.1.0:guides/02-quickstart.md\n\n# 快速开始\n\n## 适用场景\n\n- 在 Claude Code 中使用 Claude-Flow 智能体\n- 组建蜂群处理复杂任务\n- 查看和管理智能体状态\n\n---\n\n## 在 Claude Code 中直接使用（最简单）\n\n安装完成后，Claude-Flow 通过 MCP 集成到 Claude Code。**你不需要学习所有命令**，直接在对话中描述任务即可：\n\n```\n帮我审查 src/auth/ 目录的代码安全性\n\n帮我为 payments 模块写完整的测试套件\n\n重构 database.ts，提高性能并改善错误处理\n```\n\nClaude-Flow 会自动路由到合适的专业智能体（security、tester、refactor 等）。\n\n---\n\n## 查看可用智能体\n\n```bash\n# 列出所有可用智能体\nnpx ruflo@latest agent list\n\n# 查看特定智能体详情\nnpx ruflo@latest agent info coder\nnpx ruflo@latest agent info security\n```\n\n常用智能体类型：\n\n| 智能体 | 职责 |\n|--------|------|\n| `coder` | 代码编写和实现 |\n| `tester` | 测试编写和执行 |\n| `reviewer` | 代码审查 |\n| `architect` | 技术架构设计 |\n| `security` | 安全扫描和审计 |\n| `documenter` | 文档生成 |\n| `optimizer` | 性能优化 |\n| `researcher` | 技术调研 |\n\n---\n\n## 手动启动单个智能体\n\n```bash\n# 启动 coder 智能体处理特定任务\nnpx ruflo@latest agent spawn coder \\\n --task \"实现用户认证模块，包含 JWT 刷新机制\"\n\n# 启动 security 智能体审计代码\nnpx ruflo@latest agent spawn security \\\n --task \"审计 src/api/ 目录的安全性\" \\\n --files \"src/api/\"\n```\n\n---\n\n## 启动蜂群（多智能体协作）\n\n```bash\n# 层级蜂群（Queen 协调 Worker）\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --agents coder,tester,reviewer,security \\\n --task \"实现并测试用户注册和登录 API\"\n\n# 网状蜂群（P2P 协作，适合研究任务）\nnpx ruflo@latest swarm start \\\n --topology mesh \\\n --agents researcher,architect,documenter \\\n --task \"设计微服务架构方案\"\n\n# 查看蜂群状态\nnpx ruflo@latest swarm status\n```\n\n---\n\n## 常见任务模式\n\n### 全链路代码实现\n\n```bash\n# 让多个智能体协作完成从设计到测试的完整流程\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --agents architect,coder,tester,reviewer \\\n --task \"设计并实现一个 RESTful API 用于用户管理（CRUD），包含完整测试\"\n```\n\n### 代码质量审查\n\n```bash\n# 并行运行审查、安全、测试三个智能体\nnpx ruflo@latest swarm start \\\n --topology mesh \\\n --agents reviewer,security,tester \\\n --task \"全面审查 src/ 目录的代码质量、安全性和测试覆盖率\"\n```\n\n### 紧急 Bug 修复\n\n```bash\n# 单个 coder 智能体快速处理\nnpx ruflo@latest agent spawn coder \\\n --task \"修复 payment.ts 中的竞态条件 bug，错误出现在 processPayment 函数\"\n```\n\n---\n\n## 查看学习记忆\n\nClaude-Flow 会记住成功的任务模式，可以查询：\n\n```bash\n# 查看记忆系统状态\nnpx ruflo@latest hooks intelligence --status\n\n# 搜索历史成功模式\nnpx ruflo@latest memory search \"authentication\"\n```\n\n---\n\n## MCP 工具列表\n\n在 Claude Code 中，Claude-Flow 暴露 310+ MCP 工具：\n\n```\n# 在 Claude Code 中查询可用工具\n/mcp list\n\n# 常用工具（自动调用，无需手动触发）\nclaude_flow_agent_spawn — 启动智能体\nclaude_flow_swarm_start — 启动蜂群\nclaude_flow_memory_search — 搜索历史模式\nclaude_flow_task_status — 查看任务状态\n```\n\n---\n\n## 完成确认检查清单\n\n- [ ] Claude Code 中 Claude-Flow MCP 工具可用（`/mcp list` 可见）\n- [ ] `npx ruflo@latest agent list` 显示可用智能体\n- [ ] 简单任务通过对话自动路由到合适智能体\n- [ ] 蜂群模式成功启动并完成任务\n\n---\n\n## 下一步\n\n- [高级用法](03-advanced-usage.md) — 自定义智能体、多模型切换、向量记忆管理\n\nFile v0.1.0:guides/03-advanced-usage.md\n\n# 高级用法\n\n## 多 LLM 提供商切换\n\nClaude-Flow 支持在不同 LLM 提供商之间切换，并自动故障切换：\n\n```bash\n# 配置多个提供商\nnpx ruflo@latest config set provider anthropic --api-key $ANTHROPIC_API_KEY\nnpx ruflo@latest config set provider openai --api-key $OPENAI_API_KEY\nnpx ruflo@latest config set provider google --api-key $GOOGLE_API_KEY\n\n# 指定智能体使用特定提供商\nnpx ruflo@latest agent spawn coder \\\n --provider anthropic \\\n --model claude-opus-4-7 \\\n --task \"实现复杂算法\"\n\n# 经济型任务使用便宜模型\nnpx ruflo@latest agent spawn documenter \\\n --provider anthropic \\\n --model claude-haiku-4-5-20251001 \\\n --task \"生成 API 文档\"\n\n# 使用本地 Ollama\nnpx ruflo@latest agent spawn researcher \\\n --provider ollama \\\n --model llama3.2 \\\n --task \"技术调研\"\n```\n\n---\n\n## 自定义智能体\n\n创建自己的专业智能体：\n\n```javascript\n// agents/custom-agent.js\nmodule.exports = {\n name: \"data-analyst\",\n description: \"专门处理数据分析和可视化任务的智能体\",\n capabilities: [\"data_analysis\", \"visualization\", \"statistics\"],\n \n systemPrompt: `You are an expert data analyst. \n Focus on: statistical analysis, data quality, visualization recommendations.\n Always provide actionable insights with quantified impact.`,\n \n tools: [\"read_file\", \"write_file\", \"execute_code\"],\n \n hooks: {\n beforeTask: async (task) => {\n // 预处理任务\n return task;\n },\n afterTask: async (result) => {\n // 后处理结果\n return result;\n }\n }\n};\n```\n\n```bash\n# 注册自定义智能体\nnpx ruflo@latest agent register agents/custom-agent.js\n\n# 使用自定义智能体\nnpx ruflo@latest agent spawn data-analyst \\\n --task \"分析 sales.csv，找出销售下降的原因\"\n```\n\n---\n\n## 向量记忆管理\n\nClaude-Flow 使用 HNSW 向量数据库记录成功模式：\n\n```bash\n# 查看记忆使用状态\nnpx ruflo@latest memory status\n\n# 搜索相关历史模式\nnpx ruflo@latest memory search \"authentication JWT\"\nnpx ruflo@latest memory search \"database optimization\"\n\n# 导出记忆数据库（备份）\nnpx ruflo@latest memory export backup-2026.json\n\n# 清理低质量记忆\nnpx ruflo@latest memory prune --min-confidence 0.7\n\n# 查看智能体学习曲线\nnpx ruflo@latest hooks intelligence --report\n```\n\n---\n\n## Hook 系统\n\nHook 在智能体生命周期的关键节点自动触发：\n\n```bash\n# 查看当前活跃的 Hook\nnpx ruflo@latest hooks list\n\n# 启用代码质量 Hook（每次代码生成后自动运行 linter）\nnpx ruflo@latest hooks enable code-quality\n\n# 启用安全扫描 Hook\nnpx ruflo@latest hooks enable security-scan\n\n# 查看 Hook 执行日志\nnpx ruflo@latest hooks logs --last 20\n```\n\n---\n\n## 蜂群拓扑详解\n\n```bash\n# 层级拓扑（Queen 管理 Worker，适合大任务分解）\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --queen-agent architect \\\n --worker-agents coder,tester,reviewer,documenter \\\n --consensus majority \\\n --task \"设计和实现完整的电商订单系统\"\n\n# 环形拓扑（顺序流水线，适合步骤明确的任务）\nnpx ruflo@latest swarm start \\\n --topology ring \\\n --agents researcher,architect,coder,tester \\\n --task \"技术调研 → 设计 → 实现 → 测试\"\n\n# 星形拓扑（一个协调者+多个独立工作者）\nnpx ruflo@latest swarm start \\\n --topology star \\\n --coordinator-agent architect \\\n --agents coder,coder,coder \\ # 多个同类型智能体并行\n --task \"并行实现三个独立的 API 端点\"\n```\n\n---\n\n## WASM 优化引擎\n\nClaude-Flow 包含 WebAssembly 优化引擎，对简单任务跳过 LLM 调用：\n\n```bash\n# 查看 WASM 引擎状态\nnpx ruflo@latest hooks intelligence --wasm-status\n\n# 查看 Token 节省报告（30-50% 压缩）\nnpx ruflo@latest hooks intelligence --token-report\n```\n\n---\n\n## 与 Claude Code 深度集成\n\n在 Claude Code 中，所有 Claude-Flow 功能通过自然语言触发：\n\n```\n# 以下对话会自动触发多智能体协作\n\n我需要为新功能编写完整的测试套件，包含单元测试、集成测试和 E2E 测试\n\n帮我重构 services/ 目录，要求：保持向后兼容，提高可测试性，添加类型注解\n\n对 src/api/ 目录进行完整的安全审查，关注 SQL 注入、XSS、认证绕过风险\n```\n\nClaude-Flow 的 Hook 系统会自动：\n1. 识别任务类型\n2. 选择合适的智能体组合\n3. 设置蜂群拓扑\n4. 协调执行并整合结果\n\n---\n\n## 完成确认检查清单\n\n- [ ] 多 LLM 提供商切换测试（可选）\n- [ ] 自定义智能体注册并成功使用（可选）\n- [ ] 向量记忆搜索返回相关历史模式\n- [ ] 蜂群任务完成，Queen 整合所有工作成果\n\n---\n\n## 相关链接\n\n- [故障排查](../troubleshooting.md)\n- [GitHub](https://github.com/ruvnet/claude-flow)\n- [Discord](https://discord.com/invite/dfxmpwkG2D)\n\nFile v0.1.0:skill-card.md\n\n## Description:
\nClaude-Flow helps Claude Code users install and operate Ruflo multi-agent orchestration for coding, review, testing, security analysis, architecture work, documentation, and workflow automation.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[cn-big-cabbage](https://clawhub.ai/user/cn-big-cabbage)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nDevelopers and engineering teams use this skill to configure Claude-Flow/Ruflo in Claude Code, start specialized agents or swarms, manage MCP integration, and troubleshoot multi-agent development workflows.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill recommends high-impact installation patterns, including remote shell installers and latest-version package execution.
\nMitigation: Review installer contents first and prefer pinned package versions before running commands in a development environment.
\nRisk: The workflows require sensitive API credentials for Anthropic and may optionally use other LLM provider keys.
\nMitigation: Use low-privilege dedicated keys and avoid placing real credentials in committed files, shared configs, shell history, screenshots, or logs.
\nRisk: MCP tools, hooks, and agents may write files or execute code as part of automated workflows.
\nMitigation: Require explicit user approval before enabling automatic hooks, MCP tools, or agents that can modify files or run commands.
\nRisk: Vector memory and exported backups can contain sensitive project context.
\nMitigation: Treat memory databases and exports as sensitive project data and store or share them only under the same controls used for source code and secrets.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/cn-big-cabbage/claude-flow)
\n- [Project homepage](https://github.com/ruvnet/claude-flow)
\n- [npm package](https://www.npmjs.com/package/claude-flow)
\n\n\n## Skill Output:
\n**Output Type(s):** [guidance, markdown, shell commands, configuration, code]
\n**Output Format:** [Markdown guidance with inline shell commands, JSON configuration examples, and code snippets]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May include commands that install packages, configure MCP servers, start agents or swarms, manage memory, and troubleshoot local runtime issues.]
\n\n## Skill Version(s):
\n0.1.0 (source: frontmatter and server release metadata)
\n\n## Ethical Considerations:
\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
\n\nFile v0.1.0:troubleshooting.md\n\n# 故障排查\n\n## 安装问题\n\n---\n\n### 问题 1：`npx ruflo@latest init` 失败\n\n**难度：** 低\n\n**症状：** `npm ERR! network` 或 `ENOTFOUND`\n\n**解决方案：**\n```bash\n# 清理 npm 缓存后重试\nnpm cache clean --force\nnpx ruflo@latest init --wizard\n\n# 检查 Node.js 版本（需要 >= 18）\nnode --version\n\n# 或使用全局安装\nnpm install -g ruflo\nruflo init --wizard\n```\n\n---\n\n### 问题 2：Claude Code MCP 安装后工具不可用\n\n**难度：** 低\n\n**症状：** 安装后 Claude Code 中看不到 claude-flow 工具\n\n**解决方案：**\n- **必须重启 Claude Code** — MCP 不热加载\n- 验证 MCP 已注册：`claude mcp list`\n- 手动检查配置：`cat ~/.claude/settings.json | grep claude-flow`\n\n```bash\n# 重新添加 MCP（如果 list 中没有）\nclaude mcp add claude-flow --scope user npx ruflo@latest mcp start\n\n# 验证\nclaude mcp list | grep claude-flow\n```\n\n---\n\n### 问题 3：API Key 未配置导致智能体失败\n\n**难度：** 低\n\n**症状：** `AuthenticationError: API key not set` 或智能体立即返回错误\n\n**解决方案：**\n```bash\n# 检查 API Key\necho $ANTHROPIC_API_KEY # 应显示 sk-ant-...\n\n# 永久设置（添加到 shell 配置）\necho 'export ANTHROPIC_API_KEY=\"sk-ant-your-key\"' >> ~/.zshrc\nsource ~/.zshrc\n\n# 或在 Claude-Flow 配置中设置\nnpx ruflo@latest config set api-key $ANTHROPIC_API_KEY\n```\n\n---\n\n## 使用问题\n\n---\n\n### 问题 4：智能体任务超时\n\n**难度：** 中\n\n**症状：** `AgentTimeoutError: Task exceeded timeout` 或智能体长时间无响应\n\n**常见原因：**\n- 任务描述太大或太模糊（概率 50%）\n- 网络请求超时（概率 30%）\n- LLM API 限流（概率 20%）\n\n**解决方案：**\n```bash\n# 增加超时时间\nnpx ruflo@latest agent spawn coder \\\n --timeout 300 \\ # 300 秒超时\n --task \"实现用户认证模块\"\n\n# 分解大任务\nnpx ruflo@latest agent spawn coder \\\n --task \"只实现 JWT 生成函数，不包含其他功能\"\n\n# 检查 API 限流\nnpx ruflo@latest logs --level error --last 20 | grep \"rate limit\"\n```\n\n---\n\n### 问题 5：蜂群智能体结果不一致或互相矛盾\n\n**难度：** 中\n\n**症状：** 多个智能体返回相互矛盾的结果，Queen 无法整合\n\n**常见原因：**\n- 任务描述不明确（概率 60%）\n- 智能体数量过多导致协调开销过大（概率 40%）\n\n**解决方案：**\n```bash\n# 减少智能体数量，使任务更聚焦\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --agents coder,reviewer \\ # 只用 2 个智能体\n --task \"实现 X 功能（具体描述预期输入输出）\"\n\n# 使用 consensus 配置提高一致性\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --consensus weighted \\ # Queen 决策权重 3x\n --agents coder,tester,reviewer \\\n --task \"...\"\n```\n\n---\n\n### 问题 6：向量记忆数据库损坏\n\n**难度：** 中\n\n**症状：** `SQLite database disk image is malformed` 或记忆查询返回错误\n\n**解决方案：**\n```bash\n# 查看记忆数据库位置\nnpx ruflo@latest memory status --verbose\n\n# 备份当前数据库（如果还能访问）\nnpx ruflo@latest memory export backup-before-repair.json\n\n# 重置记忆数据库（丢失历史学习数据，但能恢复功能）\nnpx ruflo@latest memory reset --confirm\n\n# 从备份恢复\nnpx ruflo@latest memory import backup-before-repair.json\n```\n\n---\n\n### 问题 7：MCP 服务器频繁断开\n\n**难度：** 高\n\n**症状：** Claude Code 提示 `MCP server disconnected`，频繁重连\n\n**常见原因：**\n- MCP 服务器崩溃（内存不足）（概率 40%）\n- Node.js 版本不兼容（概率 30%）\n- 进程被系统 OOM killer 终止（概率 30%）\n\n**排查步骤：**\n```bash\n# 手动测试 MCP 服务器\nnpx ruflo@latest mcp start --debug\n\n# 查看错误日志\nnpx ruflo@latest logs --level error --last 50\n\n# 检查 Node.js 版本（需要 >= 18）\nnode --version\n```\n\n**解决方案：**\n```bash\n# 升级 Node.js\nnvm install 20\nnvm use 20\n\n# 增加 Node.js 内存限制\nNODE_OPTIONS=\"--max-old-space-size=4096\" npx ruflo@latest mcp start\n\n# 在 MCP 配置中增加内存\n# ~/.claude/settings.json\n{\n \"mcpServers\": {\n \"claude-flow\": {\n \"command\": \"node\",\n \"args\": [\"--max-old-space-size=4096\", \"/path/to/ruflo/mcp.js\"],\n \"env\": { \"ANTHROPIC_API_KEY\": \"...\" }\n }\n }\n}\n```\n\n---\n\n## 网络/环境问题\n\n---\n\n### 问题 8：Ollama 智能体无法连接本地模型\n\n**难度：** 中\n\n**症状：** `Connection refused: http://127.0.0.1:11434`\n\n**解决方案：**\n```bash\n# 确认 Ollama 正在运行\nollama serve &\ncurl http://127.0.0.1:11434/api/tags # 验证\n\n# 拉取需要的模型\nollama pull llama3.2\n\n# 在 claude-flow 中配置 Ollama\nnpx ruflo@latest config set provider ollama \\\n --url http://127.0.0.1:11434 \\\n --model llama3.2\n```\n\n---\n\n## 通用诊断\n\n```bash\n# 系统诊断\nnpx ruflo@latest hooks intelligence --status\nnpx ruflo@latest --version\n\n# 检查 MCP 连接\nclaude mcp list\nnpx ruflo@latest mcp status\n\n# 查看最近错误日志\nnpx ruflo@latest logs --level error --last 20\n\n# 重置到干净状态（保留 API Key）\nnpx ruflo@latest reset --keep-config\n```\n\n**GitHub Issues：** https://github.com/ruvnet/claude-flow/issues\n\n**Discord：** https://discord.com/invite/dfxmpwkG2D","readmeExcerpt":"Skill: Claude Flow Owner: cn-big-cabbage Summary: Claude Code 多智能体编排平台，部署 100+ 专业 AI 智能体协同工作，通过蜂群拓扑（层级/网状/环形/星形）协调自主工作流，内置自学习、向量记忆和原生 MCP 集成 Tags: latest:0.1.1 Version history: v0.1.1 | 2026-06-16T10:07:46.605Z | auto - Added _meta.json file to the project. - Updated SKILL.md to version 0.1.1, specifying required binaries (node, npx) in metadata. - Removed skill-card.md from the repository. v0.1.0 | 2026-04-22T00:41:","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash"},{"language":"bash","snippet":"# 一键安装（推荐）\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash\n\n# 或通过 npx\nnpx ruflo@latest init --wizard\n\n# 启动 Claude Code MCP 服务器\nnpx ruflo@latest mcp start\n\n# 查看可用智能体\nnpx ruflo@latest agent list\n\n# 启动蜂群处理复杂任务\nnpx ruflo@latest swarm start --topology hierarchical --agents coder,tester,reviewer"},{"language":"text","snippet":"# 直接描述任务，Claude-Flow 自动路由到合适智能体\n帮我审查 src/auth/ 目录的安全性，需要代码审查、安全扫描和测试覆盖率检查"},{"language":"bash","snippet":"curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash -s -- --full"},{"language":"bash","snippet":"curl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash"},{"language":"bash","snippet":"# 完整安装（MCP + 诊断工具）\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash -s -- --full\n\n# 或仅基础安装\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: claude-flow\ndescription: Claude Code 多智能体编排平台，部署 100+ 专业 AI 智能体协同工作，通过蜂群拓扑（层级/网状/环形/星形）协调自主工作流，内置自学习、向量记忆和原生 MCP 集成\nversion: 0.1.1\nmetadata:\n openclaw:\n requires:\n bins:\n - node\n - npx\n emoji: 🌊\n homepage: https://github.com/ruvnet/claude-flow\n---\n\n# Claude-Flow — Claude Code 多智能体编排平台\n\nClaude-Flow（现更名为 Ruflo）是专为 Claude Code 设计的企业级多智能体编排框架，将 Claude Code 变成强大的多智能体开发平台。通过 MCP 原生集成，可在 Claude Code 会话中直接协调 100+ 专业智能体（coder、tester、reviewer、architect、security 等），智能体通过蜂群拓扑自组织，支持层级（Queen/Worker）或网状（P2P）协作模式，并具备持续自学习能力。\n\n## 核心使用场景\n\n- **复杂软件工程任务**：自动分解大型任务，分配给专业智能体并行处理\n- **代码审查与安全审计**：同时运行 reviewer、security、tester 智能体进行全面检查\n- **架构设计**：architect 智能体协调 researcher、analyst 智能体完成技术选型\n- **自动化测试**：tester 智能体批量生成和执行测试，optimizer 智能体分析结果\n- **文档生成**：documenter 智能体并发处理多个模块的文档\n\n## AI 辅助使用流程\n\n1. **一键安装** — AI 执行 `npx ruflo@latest init --wizard` 完成 Claude Code MCP 集成\n2. **选择智能体** — AI 根据任务选择合适的专业智能体类型\n3. **启动蜂群** — AI 启动智能体蜂群，自动设置 Queen/Worker 拓扑\n4. **监控协调** — AI 实时查看智能体状态和任务分配\n5. **收集成果** — 智能体协作完成后，Queen 整合所有工作成果\n6. **知识复用** — 成功模式自动存入向量记忆，未来同类任务直接复用\n\n## 关键章节导航\n\n- [安装指南](guides/01-installation.md) — npx 安装、MCP 配置、Claude Code 集成\n- [快速开始](guides/02-quickstart.md) — 启动智能体、蜂群模式、对话驱动编排\n- [高级用法](guides/03-advanced-usage.md) — 自定义智能体、多模型切换、向量记忆、插件\n- [故障排查](troubleshooting.md) — MCP 连接、智能体超时、记忆数据库\n\n## AI 助手能力\n\n使用本技能时，AI 可以：\n\n- ✅ 安装 Claude-Flow 并配置 Claude Code MCP 集成\n- ✅ 启动和配置专业智能体（coder、tester、reviewer 等）\n- ✅ 组建蜂群，设置 Queen/Worker 层级拓扑\n- ✅ 分解复杂任务并分配给最合适的智能体\n- ✅ 监控智能体状态和任务进度\n- ✅ 查询和利用智能体向量记忆中存储的成功模式\n- ✅ 切换不同 LLM 提供商（Claude/GPT/Gemini/Ollama）\n\n## 核心功能\n\n- ✅ **100+ 专业智能体** — 涵盖 coder、tester、reviewer、architect、security 等角色\n- ✅ **蜂群协调** — 层级（Queen/Worker）、网状（P2P）、环形、星形拓扑\n- ✅ **容错共识** — Raft、Byzantine、Gossip 三种共识算法\n- ✅ **自学习记忆** — HNSW 向量搜索 + SQLite 持久化，成功模式自动复用\n- ✅ **MCP 原生集成** — 310+ MCP 工具，直接在 Claude Code 中使用\n- ✅ **多 LLM 支持** — Claude/GPT/Gemini/Cohere/Ollama，自动故障切换\n- ✅ **WASM 优化引擎** — 简单任务跳过 LLM 调用（<1ms），Token 压缩 30-50%\n- ✅ **安全防护** — 内置提示注入防护、路径遍历防护、命令注入拦截\n- ✅ **插件系统** — 自定义 Worker、Hook、Provider，IPFS 市场分发\n\n## 快速示例\n\n```bash\n# 一键安装（推荐）\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash\n\n# 或通过 npx\nnpx ruflo@latest init --wizard\n\n# 启动 Claude Code MCP 服务器\nnpx ruflo@latest mcp start\n\n# 查看可用智能体\nnpx ruflo@latest agent list\n\n# 启动蜂群处理复杂任务\nnpx ruflo@latest swarm start --topology hierarchical --agents coder,tester,reviewer\n```\n\n在 Claude Code 对话中直接使用：\n```\n# 直接描述任务，Claude-Flow 自动路由到合适智能体\n帮我审查 src/auth/ 目录的安全性，需要代码审查、安全扫描和测试覆盖率检查\n```\n\n## 安装要求\n\n| 依赖 | 版本要求 |\n|------|---------|\n| Node.js | >= 18.0 |\n| Claude Code | 最新版 |\n| npm/npx | 任意版本 |\n| Anthropic API Key | 必需（用于 Claude） |\n\n## 项目链接\n\n- GitHub：https://github.com/ruvnet/claude-flow\n- npm：https://www.npmjs.com/package/claude-flow\n- Discord：https://discord.com/invite/dfxmpwkG2D"},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn7c5ry95ff7x22mt3fx6j0q3d81p8t3\",\n \"slug\": \"claude-flow\",\n \"version\": \"0.1.1\",\n \"publishedAt\": 1781604466605\n}"},{"path":"guides/01-installation.md","content":"# 安装指南\n\n## 适用场景\n\n- 在 Claude Code 中安装和配置 Claude-Flow\n- 通过 MCP 将 Claude-Flow 集成到 Claude Code 工作流\n- 配置 Anthropic API 密钥\n\n---\n\n## 方式一：一键安装脚本（推荐）\n\n> **AI 可自动执行**\n\n```bash\n# 完整安装（MCP + 诊断工具）\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash -s -- --full\n\n# 或仅基础安装\ncurl -fsSL https://cdn.jsdelivr.net/gh/ruvnet/ruflo@main/scripts/install.sh | bash\n```\n\n---\n\n## 方式二：npx 安装\n\n```bash\n# 交互式向导安装\nnpx ruflo@latest init --wizard\n\n# 或直接初始化（接受默认配置）\nnpx ruflo@latest init\n```\n\n---\n\n## 方式三：全局 npm 安装\n\n```bash\nnpm install -g claude-flow\n# 或\nnpm install -g ruflo\n\n# 验证\nclaude-flow --version\nruflo --version\n```\n\n---\n\n## 配置 Anthropic API 密钥\n\n```bash\nexport ANTHROPIC_API_KEY=\"sk-ant-...\"\n\n# 或写入 .env 文件\necho 'ANTHROPIC_API_KEY=sk-ant-...' >> .env\n```\n\n---\n\n## 在 Claude Code 中配置 MCP\n\n### 自动配置（推荐）\n\n```bash\n# 在 Claude Code 会话中执行\nclaude mcp add claude-flow --scope user npx ruflo@latest mcp start\n```\n\n### 手动配置\n\n在 `~/.claude/settings.json` 中添加：\n\n```json\n{\n \"mcpServers\": {\n \"claude-flow\": {\n \"command\": \"npx\",\n \"args\": [\"ruflo@latest\", \"mcp\", \"start\"],\n \"env\": {\n \"ANTHROPIC_API_KEY\": \"your-key\"\n }\n }\n }\n}\n```\n\n**安装后必须重启 Claude Code** 使 MCP 生效。\n\n---\n\n## 验证安装\n\n```bash\n# 检查版本\nnpx ruflo@latest --version\n\n# 检查 Claude Code MCP 集成\nclaude mcp list # 应显示 claude-flow\n\n# 查看可用智能体\nnpx ruflo@latest agent list\n\n# 系统诊断\nnpx ruflo@latest hooks intelligence --status\n```\n\n---\n\n## 完成确认检查清单\n\n- [ ] 安装命令执行成功\n- [ ] `ANTHROPIC_API_KEY` 环境变量已配置\n- [ ] Claude Code 重启后 MCP 工具可用\n- [ ] `npx ruflo@latest agent list` 显示可用智能体列表\n\n---\n\n## 下一步\n\n- [快速开始](02-quickstart.md) — 启动智能体、蜂群模式、在 Claude Code 中使用"},{"path":"guides/02-quickstart.md","content":"# 快速开始\n\n## 适用场景\n\n- 在 Claude Code 中使用 Claude-Flow 智能体\n- 组建蜂群处理复杂任务\n- 查看和管理智能体状态\n\n---\n\n## 在 Claude Code 中直接使用（最简单）\n\n安装完成后，Claude-Flow 通过 MCP 集成到 Claude Code。**你不需要学习所有命令**，直接在对话中描述任务即可：\n\n```\n帮我审查 src/auth/ 目录的代码安全性\n\n帮我为 payments 模块写完整的测试套件\n\n重构 database.ts，提高性能并改善错误处理\n```\n\nClaude-Flow 会自动路由到合适的专业智能体（security、tester、refactor 等）。\n\n---\n\n## 查看可用智能体\n\n```bash\n# 列出所有可用智能体\nnpx ruflo@latest agent list\n\n# 查看特定智能体详情\nnpx ruflo@latest agent info coder\nnpx ruflo@latest agent info security\n```\n\n常用智能体类型：\n\n| 智能体 | 职责 |\n|--------|------|\n| `coder` | 代码编写和实现 |\n| `tester` | 测试编写和执行 |\n| `reviewer` | 代码审查 |\n| `architect` | 技术架构设计 |\n| `security` | 安全扫描和审计 |\n| `documenter` | 文档生成 |\n| `optimizer` | 性能优化 |\n| `researcher` | 技术调研 |\n\n---\n\n## 手动启动单个智能体\n\n```bash\n# 启动 coder 智能体处理特定任务\nnpx ruflo@latest agent spawn coder \\\n --task \"实现用户认证模块，包含 JWT 刷新机制\"\n\n# 启动 security 智能体审计代码\nnpx ruflo@latest agent spawn security \\\n --task \"审计 src/api/ 目录的安全性\" \\\n --files \"src/api/\"\n```\n\n---\n\n## 启动蜂群（多智能体协作）\n\n```bash\n# 层级蜂群（Queen 协调 Worker）\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --agents coder,tester,reviewer,security \\\n --task \"实现并测试用户注册和登录 API\"\n\n# 网状蜂群（P2P 协作，适合研究任务）\nnpx ruflo@latest swarm start \\\n --topology mesh \\\n --agents researcher,architect,documenter \\\n --task \"设计微服务架构方案\"\n\n# 查看蜂群状态\nnpx ruflo@latest swarm status\n```\n\n---\n\n## 常见任务模式\n\n### 全链路代码实现\n\n```bash\n# 让多个智能体协作完成从设计到测试的完整流程\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --agents architect,coder,tester,reviewer \\\n --task \"设计并实现一个 RESTful API 用于用户管理（CRUD），包含完整测试\"\n```\n\n### 代码质量审查\n\n```bash\n# 并行运行审查、安全、测试三个智能体\nnpx ruflo@latest swarm start \\\n --topology mesh \\\n --agents reviewer,security,tester \\\n --task \"全面审查 src/ 目录的代码质量、安全性和测试覆盖率\"\n```\n\n### 紧急 Bug 修复\n\n```bash\n# 单个 coder 智能体快速处理\nnpx ruflo@latest agent spawn coder \\\n --task \"修复 payment.ts 中的竞态条件 bug，错误出现在 processPayment 函数\"\n```\n\n---\n\n## 查看学习记忆\n\nClaude-Flow 会记住成功的任务模式，可以查询：\n\n```bash\n# 查看记忆系统状态\nnpx ruflo@latest hooks intelligence --status\n\n# 搜索历史成功模式\nnpx ruflo@latest memory search \"authentication\"\n```\n\n---\n\n## MCP 工具列表\n\n在 Claude Code 中，Claude-Flow 暴露 310+ MCP 工具：\n\n```\n# 在 Claude Code 中查询可用工具\n/mcp list\n\n# 常用工具（自动调用，无需手动触发）\nclaude_flow_agent_spawn — 启动智能体\nclaude_flow_swarm_start — 启动蜂群\nclaude_flow_memory_search — 搜索历史模式\nclaude_flow_task_status — 查看任务状态\n```\n\n---\n\n## 完成确认检查清单\n\n- [ ] Claude Code 中 Claude-Flow MCP 工具可用（`/mcp list` 可见）\n- [ ] `npx ruflo@latest agent list` 显示可用智能体\n- [ ] 简单任务通过对话自动路由到合适智能体\n- [ ] 蜂群模式成功启动并完成任务\n\n---\n\n## 下一步\n\n- [高级用法](03-advanced-usage.md) — 自定义智能体、多模型切换、向量记忆管理"},{"path":"guides/03-advanced-usage.md","content":"# 高级用法\n\n## 多 LLM 提供商切换\n\nClaude-Flow 支持在不同 LLM 提供商之间切换，并自动故障切换：\n\n```bash\n# 配置多个提供商\nnpx ruflo@latest config set provider anthropic --api-key $ANTHROPIC_API_KEY\nnpx ruflo@latest config set provider openai --api-key $OPENAI_API_KEY\nnpx ruflo@latest config set provider google --api-key $GOOGLE_API_KEY\n\n# 指定智能体使用特定提供商\nnpx ruflo@latest agent spawn coder \\\n --provider anthropic \\\n --model claude-opus-4-7 \\\n --task \"实现复杂算法\"\n\n# 经济型任务使用便宜模型\nnpx ruflo@latest agent spawn documenter \\\n --provider anthropic \\\n --model claude-haiku-4-5-20251001 \\\n --task \"生成 API 文档\"\n\n# 使用本地 Ollama\nnpx ruflo@latest agent spawn researcher \\\n --provider ollama \\\n --model llama3.2 \\\n --task \"技术调研\"\n```\n\n---\n\n## 自定义智能体\n\n创建自己的专业智能体：\n\n```javascript\n// agents/custom-agent.js\nmodule.exports = {\n name: \"data-analyst\",\n description: \"专门处理数据分析和可视化任务的智能体\",\n capabilities: [\"data_analysis\", \"visualization\", \"statistics\"],\n \n systemPrompt: `You are an expert data analyst. \n Focus on: statistical analysis, data quality, visualization recommendations.\n Always provide actionable insights with quantified impact.`,\n \n tools: [\"read_file\", \"write_file\", \"execute_code\"],\n \n hooks: {\n beforeTask: async (task) => {\n // 预处理任务\n return task;\n },\n afterTask: async (result) => {\n // 后处理结果\n return result;\n }\n }\n};\n```\n\n```bash\n# 注册自定义智能体\nnpx ruflo@latest agent register agents/custom-agent.js\n\n# 使用自定义智能体\nnpx ruflo@latest agent spawn data-analyst \\\n --task \"分析 sales.csv，找出销售下降的原因\"\n```\n\n---\n\n## 向量记忆管理\n\nClaude-Flow 使用 HNSW 向量数据库记录成功模式：\n\n```bash\n# 查看记忆使用状态\nnpx ruflo@latest memory status\n\n# 搜索相关历史模式\nnpx ruflo@latest memory search \"authentication JWT\"\nnpx ruflo@latest memory search \"database optimization\"\n\n# 导出记忆数据库（备份）\nnpx ruflo@latest memory export backup-2026.json\n\n# 清理低质量记忆\nnpx ruflo@latest memory prune --min-confidence 0.7\n\n# 查看智能体学习曲线\nnpx ruflo@latest hooks intelligence --report\n```\n\n---\n\n## Hook 系统\n\nHook 在智能体生命周期的关键节点自动触发：\n\n```bash\n# 查看当前活跃的 Hook\nnpx ruflo@latest hooks list\n\n# 启用代码质量 Hook（每次代码生成后自动运行 linter）\nnpx ruflo@latest hooks enable code-quality\n\n# 启用安全扫描 Hook\nnpx ruflo@latest hooks enable security-scan\n\n# 查看 Hook 执行日志\nnpx ruflo@latest hooks logs --last 20\n```\n\n---\n\n## 蜂群拓扑详解\n\n```bash\n# 层级拓扑（Queen 管理 Worker，适合大任务分解）\nnpx ruflo@latest swarm start \\\n --topology hierarchical \\\n --queen-agent architect \\\n --worker-agents coder,tester,reviewer,documenter \\\n --consensus majority \\\n --task \"设计和实现完整的电商订单系统\"\n\n# 环形拓扑（顺序流水线，适合步骤明确的任务）\nnpx ruflo@latest swarm start \\\n --topology ring \\\n --agents researcher,architect,coder,tester \\\n --task \"技术调研 → 设计 → 实现 → 测试\"\n\n# 星形拓扑（一个协调者+多个独立工作者）\nnpx ruflo@latest swarm start \\\n --topology star \\\n --coordinator-agent architect \\\n --agents coder,coder,coder \\ # 多个同类型智能体并行\n --task \"并行实现三个独立的 API 端点\"\n```\n\n---\n\n## WASM 优化引擎\n\nClaude-Flow 包含 WebAssembly 优化引擎，对简单任务跳过 LLM 调用：\n\n```bash\n# 查看 WASM 引擎状态\nnpx ruflo@latest hooks intelligence --wasm-status\n\n# 查看 Token 节省报告（30-50% 压缩）\nnpx ruflo@latest hooks intelligence --token-repor"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Claude Code 多智能体编排平台，部署 100+ 专业 AI 智能体协同工作，通过蜂群拓扑（层级/网状/环形/星形）协调自主工作流，内置自学习、向量记忆和原生 MCP 集成 Skill: Claude Flow Owner: cn-big-cabbage Summary: Claude Code 多智能体编排平台，部署 100+ 专业 AI 智能体协同工作，通过蜂群拓扑（层级/网状/环形/星形）协调自主工作流，内置自学习、向量记忆和原生 MCP 集成 Tags: latest:0.1.1 Version history: v0.1.1 | 2026-06-16T10:07:46.605Z | auto - Added _meta.json file to the project. - Updated SKILL.md to version 0.1.1, specifying required binaries (node, npx) in metadata. - Removed skill-card.md from the repository. v0.1.0 | 2026-04-22T00:41:","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":756,"uniquenessScore":51,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-11T08:15:26.143Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-11T08:15:26.143Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T10:51:17.332Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}