Bỏ qua tới nội dung
Ông T.vn

ruflo: Điều phối đội AI tự động — hướng dẫn cài đặt và dùng

12 phút đọcCập nhật

Bài này là một góc nhìn khác về ruvnet/ruflo — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: ruflo: điều phối nhiều AI agent cho Claude Code và Codex — hướng dẫn cài đặt và dùng →

ruflo: Điều phối đội AI tự động — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Ruflo là lớp điều phối dành cho Claude Code, Codex và các MCP client. Repo giúp tạo swarm nhiều agent, quản lý bộ nhớ, tìm kiếm vector, kiểm thử và theo dõi quy trình. Cách cài cơ bản khá đơn giản vì chỉ cần Node.js và một lệnh npx, nhưng các tính năng nâng cao cần đọc kỹ quyền truy cập.

ruflo là một agent meta-harness cho Claude Code và Codex. Nó đứng giữa mô hình AI và công việc thực tế để thêm công cụ, bộ nhớ, vòng lặp xử lý, sandbox, quyền kiểm soát và khả năng phối hợp nhiều agent.

Repo phù hợp với lập trình viên, nhóm phát triển sản phẩm, nhân viên kỹ thuật và người muốn giao cho AI những việc dài nhiều bước. Thay vì yêu cầu một phiên trò chuyện làm mọi thứ, bạn có thể để một swarm chia nhiệm vụ, lưu kinh nghiệm, chạy kiểm thử và tổng hợp kết quả.

Điểm đáng giá nhất là Ruflo không chỉ cung cấp một chatbot. Nó là lớp vận hành quanh Claude Code hoặc Codex. Sau khi khởi tạo, Claude Code có thể tự định tuyến công việc, dùng các agent chuyên biệt, ghi nhớ kết quả hữu ích và phối hợp các bước trong nền. Repo hiện có khoảng 81612 sao và 9612 fork, dùng TypeScript, giấy phép MIT.

Agent

ruvnet/ruflo

Ruflo là agent meta-harness giúp Claude Code và Codex phối hợp nhiều agent, ghi nhớ công việc và tự động hoá quy trình.

★ 82kTypeScriptMIT
Xem repo trên GitHub

I.Ruflo làm được gì

Ruflo tập trung vào việc biến một agent đơn thành một nhóm agent có tổ chức. Bạn không nhất thiết phải học hết các công cụ bên trong. Với cách cài đầy đủ, bạn vẫn có thể dùng Claude Code theo cách quen thuộc.

  • Điều phối swarm nhiều agent: Ruflo có thể chia một mục tiêu lớn thành nhiều phần để các agent chuyên trách cùng xử lý. Ví dụ, một agent phân tích mã nguồn, một agent viết test và một agent kiểm tra rủi ro.

  • Hỗ trợ hơn 100 agent chuyên biệt: Các agent phục vụ nhiều nhóm việc như kiểm thử, bảo mật, tài liệu, quản lý mục tiêu, phân tích thay đổi và tự động hoá trình duyệt. Lợi ích thực tế là bạn không phải tự thiết kế vai trò cho mọi nhiệm vụ.

  • Bộ nhớ và tìm kiếm ngữ nghĩa: Ruflo có agent memory, cơ sở dữ liệu vector, hybrid search, graph hops và RAG. Những thành phần này giúp hệ thống tìm lại kinh nghiệm hoặc thông tin liên quan thay vì bắt đầu từ đầu trong mỗi phiên.

  • Học từ các tác vụ trước: Thành phần intelligence có thể dùng kết quả thành công trước đó để cải thiện việc định tuyến và cách xử lý. Tài liệu cũng nói rằng một số vòng học cục bộ có thể chạy mà không cần LLM, nhưng embedding và các mô-đun học đã cấu hình vẫn cần thiết.

  • Tích hợp MCP: Ruflo có MCP server để Claude Code, Codex hoặc MCP client khác gọi các công cụ điều phối. Bạn cũng có thể chỉ chạy MCP server mà không đưa toàn bộ cấu hình Ruflo vào một dự án.

  • Theo dõi trong console: Console hiển thị workflow, agent, model, token và chi phí. Bạn có thể mở log, tìm kiếm, phân loại lỗi, replay và so sánh các lần chạy.

  • Tạo mission và theo dõi mục tiêu: Trong console, Claude có thể tạo một mission, mở các trang Learning hoặc Security và báo cáo hành động ở Overview. Mission chỉ tạo ra mục tiêu; nó không có nghĩa là tính năng đã được triển khai xong.

  • Plugin và mod cho Claude Code: Ruflo có các plugin cho swarm, memory, bảo mật, test generation, browser, documentation, cost tracking, observability và nhiều nhóm khác. Bạn có thể cài riêng plugin cần dùng hoặc cài đường đầy đủ.

  • Federation giữa nhiều máy: Các plugin federation cho phép agent ở các máy khác nhau phối hợp. Cơ chế này phù hợp với nhóm hoặc hệ thống có nhiều môi trường, nhưng cần xem kỹ signing key, quyền và chính sách dữ liệu trước khi bật.

  • Giao diện terminal độc lập: Console có thể chạy không cần Claude Code bằng lệnh npx ruflo tui. Tuỳ chọn --plain giúp in một frame, phù hợp với script hoặc môi trường terminal đơn giản.

  • Hỗ trợ ruOS Desktop: Tài liệu có hướng dẫn kết nối ruOS với ChatGPT hoặc Claude qua MCP. Đây là lựa chọn mở rộng, không cần thiết cho lần chạy đầu tiên.

II.Cần chuẩn bị gì

  • Cần Node.js phiên bản 20 trở lên. Metadata của package.json ghi rõ yêu cầu Node >=20.0.0.

  • Cần có terminal và quyền chạy npx. Bạn có thể cài Ruflo trong thư mục dự án đang làm việc.

  • Nếu dùng đường cài đầy đủ, cần Claude Code để Ruflo tự thêm agent, hook, memory và MCP server vào dự án.

  • Nếu dùng đường plugin, cần Claude Code phiên bản 2.1.287 trở lên. Lệnh cài plugin trực tiếp từ terminal yêu cầu Claude Code 2.1.292 trở lên.

  • Nếu dùng Codex hoặc MCP client khác, client đó cần cho phép cấu hình command npx với danh sách arguments tương ứng.

  • Tài liệu được cung cấp không nêu một API key bắt buộc cho lệnh khởi tạo cơ bản. Việc dùng model hoặc nhà cung cấp LLM cụ thể có thể cần cấu hình riêng, nhưng phần tư liệu này chưa ghi chi tiết các key đó.

  • Không có yêu cầu GPU được nêu cho cài đặt cơ bản. Một số plugin có thể dùng local LLM, vector search hoặc tăng tốc GPU, nhưng tài liệu chưa nói rằng GPU là điều kiện bắt buộc.

Ruflo có thể chạy hành động có quyền ghi, quản lý, truy cập mạng hoặc tạo chi phí. Mặc định Claude control là read + ask. Hãy giữ chế độ hỏi trước, đọc mã của mod trước khi cài và chỉ nâng quyền khi bạn hiểu rõ tác động.

III.Cài đặt từng bước

  1. Kiểm tra môi trườngĐảm bảo Node.js đạt phiên bản yêu cầu và mở terminal trong thư mục dự án
  2. Khởi tạo RufloChạy lệnh npx để thêm agent, hook, memory và MCP server
  3. Mở lại Claude CodeKhởi động Claude Code trong cùng thư mục để nhận cấu hình mới
  4. Giao tác vụ đầu tiênYêu cầu Claude Code dùng Ruflo swarm xử lý một việc thật
  5. Kiểm tra consoleMở /ruflo để xem workflow, agent, log và quyền điều khiển

A.Kiểm tra Node.js và mở đúng thư mục

Bạn nên mở terminal tại thư mục dự án cần Ruflo hỗ trợ. Lệnh khởi tạo sẽ thêm các thành phần vào chính dự án đó, vì vậy chạy ở thư mục khác có thể làm bạn tìm nhầm file cấu hình.

Tư liệu cho biết package.json yêu cầu Node.js từ 20.0.0. README không cung cấp lệnh kiểm tra phiên bản cụ thể, nên hãy kiểm tra Node.js bằng công cụ quản lý Node bạn đang dùng trước khi tiếp tục.

B.Khởi tạo Ruflo trong dự án

Đây là đường cài được README giới thiệu đầu tiên. Chạy đúng lệnh sau trong thư mục dự án:

Terminal
npx ruflo@latest init

Lệnh npx ruflo@latest init thêm agent, hook, memory và MCP server của Ruflo vào dự án. Sau khi chạy xong, Claude Code sẽ nhận các thành phần này ở lần khởi động tiếp theo.

Đường CLI đầy đủ cung cấp nhiều thành phần hơn đường plugin. Bảng trong README mô tả nó gồm 98 agent, hơn 60 command, 30 skill, MCP server, hook và daemon. Ruflo cũng có thể tạo các file như .claude/, .claude-flow/, CLAUDE.md và settings trong workspace.

C.Mở Claude Code trong cùng thư mục

Đóng hoặc khởi động lại Claude Code trong chính thư mục vừa chạy init. Đây là điểm người mới dễ bỏ qua. Nếu Claude Code đã mở từ trước, nó có thể chưa nạp hook hoặc agent mới.

Sau đó, giao cho Claude một tác vụ cụ thể. Ví dụ trong README:

text
Use a ruflo swarm to review this repo: find the riskiest module, write tests for it, and summarise what you changed.

Câu lệnh này yêu cầu swarm xem xét repo, tìm module rủi ro nhất, viết test và tóm tắt thay đổi. Bạn nên thử trên một repo có bản sao hoặc branch riêng, vì task có thể tạo hoặc sửa file.

D.Dùng Ruflo qua MCP client

Nếu không muốn thiết lập toàn bộ project, Codex hoặc MCP client khác có thể chạy Ruflo bằng command npx và arguments sau:

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

Trong cấu hình MCP, command là chương trình được gọi. Mảng arguments yêu cầu npx dùng phiên bản Ruflo mới nhất và khởi động MCP server. README không đưa ra file cấu hình cụ thể cho từng MCP client, nên bạn cần đặt cặp giá trị này vào đúng vị trí mà client của bạn yêu cầu.

Nếu muốn thiết lập dự án theo cách tương tác, README cung cấp lệnh:

Terminal
npx ruflo@latest init wizard

E.Cài phiên bản plugin cho Claude Code

Đường plugin phù hợp khi bạn chỉ muốn slash command, một số skill và agent definition mà không thêm file vào workspace. README ghi rõ đường này không tạo file trong dự án và cần Claude Code 2.1.287 hoặc mới hơn.

Trong Claude Code, chạy:

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

Lệnh đầu tiên thêm marketplace. Ba lệnh tiếp theo cài phần lõi, console và mod. /reload-plugins nạp lại plugin, còn /ruflo mở console.

Tài liệu cảnh báo mod chạy với quyền của tài khoản và không được sandbox. Vì vậy bạn nên đọc mã trước khi cài. Ruflo cũng cung cấp cách cài một số plugin cụ thể:

text
/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

Đường plugin chỉ cài những phần bạn chọn. ruflo-core có MCP server riêng, nhưng tên tool của nó khác với các tool trong scaffold của đường CLI. Nếu cần full loop và tên tool của đường CLI, hãy dùng npx ruflo@latest init.

F.Cài từ terminal và chạy console độc lập

Với Claude Code 2.1.292 trở lên, README cho phép cài plugin core từ terminal:

Terminal
claude plugin install ruflo-core@ruflo --marketplace ruvnet/ruflo

Console cũng có thể chạy không cần Claude Code:

Terminal
npx ruflo tui

Nếu muốn in một frame cho script, thêm --plain theo hướng dẫn README:

Terminal
npx ruflo tui --plain

IV.Kiểm tra đã chạy được chưa

Cách kiểm tra cơ bản là mở lại Claude Code trong dự án sau khi chạy npx ruflo@latest init, rồi giao tác vụ swarm mẫu. Nếu Claude Code nhận được yêu cầu và Ruflo định tuyến task, phần khởi tạo đã hoạt động.

Bạn cũng có thể chạy /ruflo trong Claude Code. Console sẽ cho bạn xem workflow, agent, model, token và cost. Khi có log hoặc kết quả để mở, bạn có thể tìm kiếm, triage, replay và so sánh các lần chạy.

Nếu cài plugin, mở /plugin để xác nhận plugin xuất hiện trong dòng active mods. Với đường plugin có console, /ruflo phải mở được cockpit.

Khi dùng Claude control, hãy vào Settings → Claude control. Mặc định là read + ask. Một hành động cần quyền cao hơn sẽ bị từ chối. Hành động liên quan đến network, spending hoặc destructive action vẫn yêu cầu xác nhận ngay cả trong chế độ auto.

V.Dùng vào việc thật

A.Chủ shop muốn phân tích website bán hàng

Một chủ shop có repo chứa trang bán hàng và muốn biết phần nào dễ gây lỗi nhất. Bạn mở Claude Code trong repo rồi dùng prompt:

text
Use a ruflo swarm to review this repo: find the riskiest module, explain the business impact, and suggest tests before changing any file.

Swarm có thể chia việc phân tích mã, đánh giá rủi ro và đề xuất test cho các agent khác nhau. Kết quả phù hợp để ưu tiên việc sửa lỗi, nhưng bạn vẫn cần đọc lại nhận định trước khi cho phép thay đổi file.

B.Nhân viên văn phòng muốn tạo quy trình nhiều bước

Một nhân viên phụ trách báo cáo có thể dùng Ruflo để biến một mục tiêu dài thành mission. Trong Claude control, đặt quyền write + ask, rồi yêu cầu:

text
Create a mission to add a dark mode toggle. Show me the mission and its status.

Claude sẽ mở Missions và đặt mục tiêu. Bạn xác nhận hành động pending trong console, sau đó kiểm tra Missions và Overview. Cần nhớ rằng tạo mission chưa phải là triển khai xong tính năng.

C.Dev muốn tìm thiếu sót trong test

Một dev mới nhận dự án TypeScript có thể cài plugin testgen và giao việc tìm test còn thiếu. Plugin ruflo-testgen được README mô tả là tìm test thiếu và tự động tạo test.

Prompt có thể viết như sau:

text
Review the changed modules, find missing tests, generate focused tests, and report which files were added.

Sau đó bạn xem diff, chạy test của dự án và kiểm tra từng test được tạo. Ruflo hỗ trợ tạo test, nhưng không thay thế việc xác nhận test có đúng yêu cầu nghiệp vụ hay không.

D.Nhóm kỹ thuật muốn xem lại một lần chạy

Khi swarm xử lý task lớn, người phụ trách có thể mở /ruflo để xem log và kết quả. Bạn có thể tìm kiếm, phân loại lỗi, replay hoặc so sánh các lần chạy để biết agent thất bại ở đâu.

Nếu cần Claude điều khiển console, vào Settings → Claude control, chọn mức quyền phù hợp và giữ chế độ ask. Khi muốn dừng, chọn Take back control. Các lần gọi sau sẽ bị từ chối cho tới khi bạn khôi phục quyền điều khiển.

Hãy xem Ruflo như một đội vận hành cho AI: giao mục tiêu rõ, đặt giới hạn, rồi kiểm tra bằng log và kết quả.

Ông T

VI.Lỗi hay gặp và cách xử lý

A.Node.js quá cũ

Nếu npx ruflo@latest init không chạy hoặc package báo không đáp ứng engine, hãy kiểm tra phiên bản Node.js. package.json yêu cầu Node.js từ 20.0.0. Nâng Node.js bằng công cụ quản lý của bạn rồi chạy lại trong thư mục dự án.

B.Chạy init sai thư mục

Nếu Claude Code không thấy agent, hook hoặc memory, có thể bạn đã chạy init ở thư mục khác. Mở terminal tại đúng project, chạy lại lệnh init, rồi khởi động lại Claude Code trong cùng thư mục.

C.Claude Code chưa nạp cấu hình mới

Sau khi init, Claude Code cần được mở lại để nhận thành phần mới. Nếu dùng plugin, chạy /reload-plugins. Với đường plugin, hãy kiểm tra /plugin để chắc rằng plugin đã nằm trong danh sách active.

D.Dùng sai tên tool giữa hai đường cài

Plugin ruflo-core có namespace tool riêng như mcp__plugin_ruflo-core_ruflo__memory_store. Các tool không có tiền tố tương ứng với đường CLI scaffold không nhất thiết hoạt động trong đường plugin. Nếu cần full loop với tool của CLI, hãy dùng đường npx ruflo@latest init.

E.Cấp quyền quá rộng cho mod hoặc Claude control

Mod chạy với quyền tài khoản và không được sandbox. Nếu Claude control bị từ chối, đó có thể là do mức quyền hiện tại không cho phép hành động. Hãy giữ read + ask, đọc mã mod và chỉ nâng lên write, manage hoặc full khi cần. Các thao tác mạng, chi phí và xoá dữ liệu vẫn cần xác nhận.

VII.Có nên dùng không

Ruflo đáng thử nếu bạn đang dùng Claude Code hoặc Codex và muốn xử lý công việc dài bằng nhiều agent. Nó có đường cài một lệnh, hỗ trợ MCP, có console quan sát, nhiều plugin, memory, RAG, test generation, bảo mật và cost tracking. Giấy phép MIT cũng thuận lợi cho việc xem xét và tích hợp mã nguồn.

Giới hạn chính là phạm vi rất rộng. Đường CLI đầy đủ thêm nhiều file và thành phần vào workspace. Nhiều agent, plugin và command có thể khiến người mới khó biết nên bắt đầu từ đâu. Một số tính năng như federation, local LLM, learning hoặc plugin chuyên biệt cần cấu hình và kiểm tra riêng.

Bạn nên bắt đầu bằng npx ruflo@latest init trên một repo thử nghiệm, dùng task chỉ đọc hoặc chế độ hỏi trước, rồi mới bật quyền ghi. Nếu chỉ cần một slash command hoặc một plugin đơn lẻ, đường Claude Code plugin nhẹ hơn. Nếu chỉ cần một MCP server nhỏ cho một chức năng cụ thể, một công cụ chuyên biệt có thể dễ vận hành hơn Ruflo.

4.1/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

Ruflo có miễn phí không?

Repo được cung cấp dưới giấy phép MIT. Tuy vậy, tư liệu chưa khẳng định mọi model, nhà cung cấp LLM, ruOS hoặc dịch vụ liên quan đều miễn phí. Console có theo dõi token và cost, nên bạn cần kiểm tra chi phí của hệ thống AI đang kết nối.

Ruflo có chạy được trên Windows không?

Tư liệu được cung cấp không nêu danh sách hệ điều hành được hỗ trợ. README chỉ mô tả cách chạy qua npx, terminal, Claude Code và MCP client, nên chưa đủ thông tin để khẳng định hỗ trợ Windows chính thức.

Có cần GPU để chạy Ruflo không?

Không có yêu cầu GPU cho đường cài cơ bản được nêu trong tư liệu. Một số plugin có thể dùng local LLM hoặc tăng tốc GPU, nhưng GPU không được mô tả là điều kiện bắt buộc.

Ruflo có cần API key không?

Tư liệu không nêu API key bắt buộc cho lệnh `npx ruflo@latest init`. Khi kết nối model hoặc nhà cung cấp LLM cụ thể, có thể phát sinh cấu hình riêng, nhưng phần README được cung cấp chưa ghi chi tiết.

Dữ liệu trong dự án có an toàn không?

Ruflo có các tính năng security guardrails, permission control và log hành động, nhưng mức an toàn phụ thuộc vào cấu hình và quyền bạn cấp. Mod chạy với quyền tài khoản và không được sandbox, vì vậy nên đọc mã trước khi cài và giữ chế độ `read + ask` khi bắt đầu.

Ruflo khác gì so với chỉ dùng Claude Code?

Claude Code cung cấp môi trường làm việc với model, còn Ruflo là lớp harness bổ sung điều phối swarm, agent chuyên biệt, memory, hook, MCP server, learning và console. Bạn vẫn có thể dùng Claude Code bình thường sau khi init, trong khi Ruflo xử lý phần phối hợp ở phía sau.

Có thể chỉ dùng một plugin thay vì cài toàn bộ Ruflo không?

Có. Đường Claude Code plugin cho phép cài riêng các phần như core, swarm, RAG memory hoặc testgen và không thêm file vào workspace. Nếu cần full loop gồm hook, MCP server, daemon và nhiều command, README khuyến nghị đường CLI `npx ruflo@latest init`.

Chuyển nhanh tới mục

  1. I.Ruflo làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Kiểm tra Node.js và mở đúng thư mục
    2. B.Khởi tạo Ruflo trong dự án
    3. C.Mở Claude Code trong cùng thư mục
    4. D.Dùng Ruflo qua MCP client
    5. E.Cài phiên bản plugin cho Claude Code
    6. F.Cài từ terminal và chạy console độc lập
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop muốn phân tích website bán hàng
    2. B.Nhân viên văn phòng muốn tạo quy trình nhiều bước
    3. C.Dev muốn tìm thiếu sót trong test
    4. D.Nhóm kỹ thuật muốn xem lại một lần chạy
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Node.js quá cũ
    2. B.Chạy init sai thư mục
    3. C.Claude Code chưa nạp cấu hình mới
    4. D.Dùng sai tên tool giữa hai đường cài
    5. E.Cấp quyền quá rộng cho mod hoặc Claude control
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.