Orkas: đội AI agent chạy ngay trên máy tính, tự làm việc — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về Orkas-AI/Orkas — 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: Orkas: đội AI agent chạy trên máy bạn, tự lo việc dài ngày — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Orkas là ứng dụng desktop mã nguồn mở (MIT) cho macOS và Windows, trong đó một Commander biến mục tiêu của bạn thành danh sách việc rồi giao cho 16 agent có sẵn hoặc các agent như Claude Code, Codex. Dữ liệu nằm trên máy bạn theo mặc định. Cách dễ nhất là tải bản đóng gói, đăng nhập và dùng ngay với 500 credit miễn phí, không cần API key.
Orkas là một ứng dụng desktop mã nguồn mở (giấy phép MIT) biến trợ lý AI thành cả một đội. Bạn nói với Commander (người điều phối) cái bạn cần. Việc nhỏ thì nó tự làm. Việc lớn thì nó lên kế hoạch, chia thành các việc cần làm rồi giao cho từng agent chuyên môn. Nó cũng gọi được các agent lập trình bạn đã có như Claude Code, Codex, OpenCode, OpenClaw và Hermes-Agent.
Repo này hợp với chủ shop, người làm marketing, nhân viên văn phòng, người làm báo cáo cho khách, và cả lập trình viên mới. Họ có chung một kiểu việc: lặp đi lặp lại, nhiều bước, và không muốn mở tám công cụ khác nhau. Hiện repo có khoảng 9.314 sao và 552 fork, vẫn được cập nhật trong 3 tháng gần đây.
Điểm đáng giá nhất là Orkas không chỉ trả lời một câu hỏi rồi thôi. Nó có khái niệm dự án (nhớ mục tiêu, quy tắc, file), việc cần làm (to-do) và tự động lặp lịch, nên công việc được giữ chạy qua nhiều ngày. Xem video ngắn bên dưới để thấy giao diện trước khi cài.
Orkas-AI/Orkas
Orkas là ứng dụng desktop mã nguồn mở: một Commander chia mục tiêu thành việc cần làm và điều phối 16 agent chuyên môn cùng Claude Code, Codex.
I.Orkas làm được gì
Mình tóm lại theo lợi ích, không chép lại cả README.
A.Một Commander điều phối cả đội
Bạn không phải chọn agent nào cho việc nào. Bạn nêu mục tiêu, Commander tự chia nhỏ, chọn agent, kỹ năng, connector phù hợp rồi gộp kết quả lại. README lấy ví dụ: nghiên cứu thị trường rồi ra một báo cáo, một bộ slide và một video giới thiệu. Nếu không có chuyên gia nào hợp hơn, chính Commander tự làm phân tích, viết, nghiên cứu hoặc xử lý file.
B.16 agent chuyên môn có sẵn
Mỗi agent có kỹ năng, bộ nhớ và công cụ riêng. Gồm các nhóm:
- Nghiên cứu và phân tích: DeepResearcher (báo cáo có nguồn đã kiểm chứng), SeoGeoAgent (đưa một URL, nhận bản kiểm tra SEO và danh sách việc cần sửa theo thứ tự ưu tiên), StockAnalyser (phân tích cổ phiếu, backtest, kiểm tra rủi ro danh mục).
- Nội dung và truyền thông: ContentWriter (bài viết, newsletter), PptMaker (slide PPTX chỉnh sửa được), ImageStudio (poster, ảnh mạng xã hội), VideoStudio (video, lồng tiếng, phụ đề), VoiceStudio (giọng đọc, bóc băng, phụ đề), UIDesigner (giao diện HTML).
- Xây dựng và văn phòng: ProductDeveloper (sửa lỗi, refactor, review code), OfficeWorker (tạo, sửa, kiểm tra file Word, Excel, PowerPoint, PDF, làm từng file hoặc hàng loạt).
- Thương mại điện tử: năm agent gồm nghiên cứu chọn sản phẩm, viết nội dung listing, phân tích đánh giá khách hàng, phân tích doanh số và lợi nhuận từ file xuất của bạn, và lập kế hoạch thay đổi danh mục, giá, khuyến mãi, tồn kho.
Ngoài ra có hơn 30 agent trên chợ agent của dự án. Bạn cũng có thể mô tả vai trò mình cần để Commander dựng một agent riêng.
C.Giữ việc chạy liên tục
- Dự án: chứa mục tiêu, quy tắc, bộ nhớ và file. Mỗi cuộc trò chuyện mới bắt đầu từ đó, nên bạn không phải giải thích lại từ đầu.
- To-do và Auto-advance: danh sách việc chia cho người và agent. Bật Auto-advance thì đội tự nhận việc kế tiếp, xong thì trả về cho bạn duyệt.
- Tự động lặp lịch: chạy theo giờ, ngày, tuần hoặc tháng. Orkas chạy trên máy bạn, nên máy phải bật. README nói từ v1.9, mỗi automation sẽ bù lại lần chạy lỡ gần nhất trong vòng 12 giờ khi máy thức dậy hoặc Orkas mở lại.
- Connector: Gmail, Google Calendar, Sheets, Drive, Notion, Slack, Shopify, Stripe và nhiều thứ khác. Mặc định Orkas hỏi trước khi gửi, đăng hoặc xoá bất cứ thứ gì.
- Apps: mô tả một công cụ nhỏ, Orkas dựng thành app chạy cục bộ trong ứng dụng.
D.Chọn mô hình tuỳ ý
Bản có sẵn dùng mô hình Orkas với 500 credit miễn phí. Bạn cũng có thể dùng key của Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, MiniMax, Doubao, hoặc một endpoint cục bộ tương thích OpenAI. Các agent CLI bên ngoài giữ cài đặt mô hình riêng của chúng.
II.Cần chuẩn bị gì
Tuỳ bạn đi đường nào, README chia hai cách:
- Bản đóng gói (khuyên dùng): macOS 12 trở lên (cả Apple Silicon lẫn Intel) hoặc Windows 10 trở lên. Bạn cần đăng nhập để nhận 500 credit miễn phí. Không cần API key để bắt đầu.
- Chạy từ mã nguồn: macOS, Windows, hoặc Linux x64/arm64 có glibc 2.34 trở lên. Không cần tài khoản, nhưng bạn phải tự có key của nhà cung cấp mô hình hoặc một endpoint cục bộ.
package.jsonyêu cầu Node từ 22.12.0 trở lên.
Tư liệu không nhắc yêu cầu GPU hay dung lượng ổ đĩa, nên mình không đưa ra con số nào.
Nếu muốn Orkas điều phối Claude Code, Codex, OpenCode, OpenClaw hay Hermes-Agent, bạn cần đã cài sẵn các công cụ đó trên máy. README nói Orkas chạy các CLI agent bạn đã cài thành phiên làm việc cục bộ.
Một số tính năng chỉ có ở bản đóng gói: dự án chia sẻ cho cả nhóm, đồng bộ đám mây, xuất bản app thành web. README nói bản mã nguồn mở chưa hỗ trợ những phần này. Nếu bạn cần chúng, hãy chọn bản tải về.
III.Cài đặt từng bước
Với người không phải lập trình viên, mình khuyên đi theo bản đóng gói. Cách chạy từ mã nguồn dành cho ai muốn đọc hoặc sửa code.
- Tải ứng dụngVào trang tải của Orkas, link tự nhận hệ điều hành của bạn
- Cài đặtMở file vừa tải và làm theo trình cài
- Đăng nhậpĐăng nhập để nhận 500 credit miễn phí
- Chọn mô hìnhDùng mô hình có sẵn hoặc điền key của bạn trong Settings → Models
- Giao việc đầu tiênNói mục tiêu cho Commander
A.Cách A: tải bản đóng gói
Mở trang tải của Orkas (link nằm ở phần đầu README của repo, mục Download). Link này tự nhận hệ điều hành và tải đúng bộ cài cho macOS hoặc Windows. Cài xong, mở ứng dụng và đăng nhập. Bạn sẽ có 500 credit cho mô hình Orkas, nên chưa cần API key.
Chỗ người mới hay vấp: đừng tìm file .exe trong mã nguồn trên GitHub. Bộ cài nằm ở trang tải, không nằm trong các thư mục của repo.
B.Cách B: dùng key riêng của bạn
Nếu đã có key của một nhà cung cấp, vào Settings → Models và điền vào đó. Theo README, khi dùng key riêng thì các lệnh gọi mô hình đi thẳng từ máy bạn tới nhà cung cấp. Với mô hình Orkas có sẵn, lệnh gọi đi qua dịch vụ mô hình do Orkas quản lý.
C.Cách C: chạy từ mã nguồn
Bước đầu tiên là lấy mã về. Mở terminal (macOS: ứng dụng Terminal; Windows: PowerShell) và gõ:
git clone https://github.com/Orkas-AI/Orkas.git
cd OrkasLệnh đầu tải repo về máy, lệnh sau đưa terminal vào đúng thư mục. Cần cài Git trước.
Phần README mà mình có được bị cắt trước mục Quick start, nên mình chưa có lệnh chính xác để cài và chạy từ mã nguồn. Bạn hãy mở mục Quick start trong README.md của repo và làm đúng theo đó. Thư mục gốc có sẵn package.json, run.sh (cho macOS/Linux), run.cmd (cho Windows) và bootstrap.cjs, nhưng mình không đoán chúng hoạt động thế nào. Đừng tự thêm lệnh nào chưa thấy trong README.
Bản mã nguồn không cần tài khoản Orkas. Vì vậy bạn phải tự cấu hình key hoặc endpoint cục bộ ở Settings → Models trước khi dùng.
IV.Kiểm tra đã chạy được chưa
Với bản đóng gọn, dấu hiệu thành công đơn giản: ứng dụng mở được, bạn đăng nhập xong và thấy khung chat với Commander. Hãy gõ thử một yêu cầu ngắn, ví dụ nhờ nó tóm tắt một đoạn văn bạn dán vào. Nếu nó trả lời và credit bị trừ, mô hình đã nối được.
Với bản mã nguồn, bạn chỉ chắc là đã chạy khi cửa sổ ứng dụng hiện lên và mô hình đã được cấu hình ở Settings → Models. README mình có không nêu kết quả mong đợi cụ thể hơn, nên hãy đối chiếu với mục Quick start.
Nếu muốn thử giọng nói: cấu hình Orkas API Key trong Settings → Models, bấm biểu tượng micro cạnh ô soạn tin, cho phép quyền micro khi được hỏi, bấm lần nữa để dừng, xem lại văn bản rồi tự gửi. Âm thanh được gửi cho Orkas để nhận dạng và trừ credit của chủ key.
V.Dùng vào việc thật
A.Chủ shop làm báo cáo bán hàng hằng tuần
Bạn bán hàng online và mỗi thứ Hai phải xem lại doanh số, hoàn tiền, quảng cáo. Hãy tạo một dự án cho cửa hàng, rồi nhờ Commander giao việc cho agent phân tích doanh số bằng các file xuất từ sàn của bạn. Sau đó đặt một automation chạy theo tuần.
Đọc các file doanh số và quảng cáo tuần này trong dự án. Đối chiếu số liệu, chỉ ra sản phẩm lãi nhiều nhất, sản phẩm hoàn tiền cao bất thường, và đề xuất 3 việc nên làm.Kết quả là một bản phân tích có số liệu đối chiếu và quyết định đề xuất. Nếu nối connector như Shopify hoặc Sheets, Orkas vẫn hỏi bạn trước khi gửi hay thay đổi gì.
B.Người làm nội dung cần bài viết và slide từ một ý tưởng
Bạn có một chủ đề sản phẩm và cần bài blog, newsletter và vài slide để thuyết trình. Hãy nói với Commander mục tiêu chung thay vì giao từng việc. Nó chia thành to-do: ContentWriter viết bài, PptMaker dựng slide PPTX chỉnh sửa được, rồi bạn duyệt từng phần.
Orkas không chỉ trả lời một câu lệnh, nó giữ cho cả dự án tiếp tục chạy.
Ông T
Lợi ích là mọi bài sau đều bắt đầu từ cùng giọng văn và quy tắc bạn đã lưu trong dự án, không phải dặn lại.
C.Nhân viên văn phòng xử lý hàng loạt file Word, Excel, PDF
Bạn có một thư mục báo cáo cần kiểm tra, sửa định dạng hoặc tạo bản mới. Hãy giao cho OfficeWorker. README nói agent này tạo, sửa, kiểm tra và giao file Word, Excel, PowerPoint, PDF, làm từng file hoặc hàng loạt. Bạn nên thử với một file trước, xem kết quả, rồi mới giao cả lô.
D.Lập trình viên mới nhờ nhiều agent cùng xử lý một bản phát hành
Bạn đã cài Claude Code và Codex. Trong Orkas, Commander có thể giao việc viết code cho một agent, việc review cho agent khác, rồi nhờ ContentWriter soạn ghi chú phát hành, tất cả trong một cuộc chat. README mô tả đúng kiểu phối hợp này: sửa lỗi, review thay đổi và soạn release note trong một chat.
VI.Lỗi hay gặp và cách xử lý
A.Tìm không thấy bộ cài trong repo
Đây là ứng dụng desktop, bộ cài không nằm trong thư mục mã nguồn. Hãy vào trang tải của Orkas qua link trong README. Link tự nhận hệ điều hành của bạn.
B.Tự động lặp lịch không chạy đúng giờ
Orkas chạy trên máy của bạn, nên máy tắt hoặc ngủ thì việc không chạy đúng giờ. README nói từ v1.9 nó bù lại lần lỡ gần nhất trong 12 giờ khi máy thức dậy hoặc Orkas mở lại. Muốn chắc chắn, hãy để máy bật vào giờ đã hẹn.
C.Chạy bản mã nguồn nhưng báo thiếu Node hoặc phiên bản không hợp
package.json yêu cầu Node từ 22.12.0 trở lên. Hãy kiểm tra bằng node --version. Nếu thấp hơn, nâng Node lên rồi chạy lại theo mục Quick start.
node --versionD.Agent CLI (Claude Code, Codex…) không xuất hiện
Orkas chạy các CLI agent bạn đã cài sẵn. Nếu chúng chưa được cài trên máy hoặc chưa đăng nhập, Orkas không có gì để gọi. Hãy cài và đăng nhập từng công cụ theo hướng dẫn riêng của nó. Chúng giữ cài đặt mô hình riêng, không dùng chung với Commander.
E.Micro không nhận giọng nói
Nếu trước đó bạn từ chối quyền, hãy bật lại quyền micro trong cài đặt hệ thống. Ngoài ra bản mã nguồn cần đã điền Orkas API Key ở Settings → Models, vì âm thanh được gửi cho Orkas để nhận dạng và trừ credit của chủ key.
Khi nối connector như Gmail, Slack, Shopify hay Stripe, hãy giữ chế độ hỏi trước khi gửi, đăng hoặc xoá mà Orkas bật mặc định. Chỉ cấp quyền cho những tài khoản bạn thật sự cần giao cho agent.
VII.Có nên dùng không
Điểm mạnh. Bạn có cả một đội agent trong một ứng dụng, với dự án, to-do và lặp lịch để việc không đứt quãng. Dữ liệu, file và agent tuỳ chỉnh nằm trên ổ đĩa của bạn theo mặc định. Bạn được chọn mô hình tuỳ ý, kể cả endpoint cục bộ. Mã nguồn MIT nên đọc được toàn bộ cách Orkas và từng agent hoạt động. Bản đóng gói miễn phí để bắt đầu và có 500 credit.
Giới hạn. Orkas cần máy bạn thức để chạy việc. README tự nói đây là điểm đánh đổi so với các công cụ chạy trên đám mây. Tính năng chia sẻ dự án, đồng bộ đám mây, xuất bản web chỉ có ở bản đóng gói. Với VideoStudio, README nói không hứa khớp từng khung hình, và không tải được video từ link chia sẻ mạng xã hội; bạn cần đưa file video cho agent đọc.
Khi nên chọn cách khác. README nói thẳng: nếu bạn chỉ cần một chatbot đa dụng, hoặc một thư viện code để nhúng vào ứng dụng của mình, Orkas không phải lựa chọn phù hợp. Khi đó các framework như LangChain hay CrewAI hợp hơn. Còn nếu bạn cần việc chạy được khi tắt máy, hãy cân nhắc công cụ chạy trên đám mây.
Nếu bạn muốn một đội AI làm việc kéo dài nhiều ngày mà vẫn giữ dữ liệu trên máy mình, Orkas rất đáng thử. Hãy bắt đầu bằng bản đóng gọn với một việc nhỏ.
Câu hỏi thường gặp
Orkas có miễn phí không?
Mã nguồn dùng giấy phép MIT. Ứng dụng đóng gói cho macOS và Windows miễn phí để bắt đầu, kèm 500 credit cho mô hình Orkas có sẵn. Tư liệu chưa nêu rõ chi phí sau khi hết credit, ngoài việc có các gói trả phí cho một số tính năng như xuất bản web.
Dùng Orkas có cần API key không?
Không cần để bắt đầu với bản đóng gói, vì có sẵn 500 credit cho mô hình Orkas. Nếu muốn, bạn có thể dùng key của Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, MiniMax, Doubao hoặc một endpoint cục bộ tương thích OpenAI. Bản chạy từ mã nguồn thì cần tự có key hoặc endpoint.
Orkas chạy được trên Windows không?
Được. Bản đóng gói hỗ trợ Windows 10 trở lên và macOS 12 trở lên (cả Apple Silicon lẫn Intel). Chạy từ mã nguồn còn hỗ trợ Linux x64 hoặc arm64 có glibc 2.34 trở lên.
Dữ liệu của tôi có an toàn không?
Theo README, hội thoại, file, kho tri thức và agent tuỳ chỉnh nằm trên ổ đĩa của bạn theo mặc định, còn đồng bộ đám mây là tuỳ chọn ở bản đóng gói. Khi dùng key riêng, lệnh gọi mô hình đi thẳng từ máy bạn tới nhà cung cấp. Với mô hình Orkas có sẵn, lệnh gọi đi qua dịch vụ do Orkas quản lý.
Orkas khác gì Claude Code hay Codex?
Orkas không thay thế chúng mà chạy chúng như một phần của đội agent. Ngoài code, Orkas thêm các agent cho nghiên cứu, nội dung, video, file văn phòng và thương mại điện tử, cùng dự án, to-do và lặp lịch. Ngược lại, Claude Code và Codex là công cụ lập trình riêng lẻ.
Máy tắt thì tự động hoá có chạy không?
Không. Orkas chạy trên máy bạn nên máy cần đang bật. README nói từ v1.9 mỗi automation sẽ bù lại lần chạy lỡ gần nhất trong vòng 12 giờ khi máy thức dậy hoặc Orkas mở lại. Các công cụ chạy trên đám mây thì có thể chạy khi tắt máy.
Có cần GPU không?
Tư liệu chưa có thông tin về yêu cầu GPU hay cấu hình phần cứng. Với mô hình Orkas có sẵn hoặc key của nhà cung cấp, việc suy luận chạy qua dịch vụ từ xa. Nếu dùng endpoint cục bộ, yêu cầu phần cứng phụ thuộc vào mô hình bạn tự chạy.


