Orkas: đội AI trên máy tính tự lập kế hoạch và 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ở, chạy trên macOS và Windows. Bạn giao mục tiêu cho Commander, nó chia việc cho 16 agent có sẵn và cả Claude Code, Codex, OpenCode… Cài bản đóng gói rất dễ (tải về, đăng nhập, dùng), còn chạy từ mã nguồn thì cần Node 22.12 trở lên.
Orkas là một ứng dụng desktop mã nguồn mở (giấy phép MIT), hoạt động như một đội trợ lý AI trên máy tính của bạn. Bạn nói mục tiêu với Commander (người điều phối). Việc nhỏ thì nó tự làm. Việc lớn thì nó chia thành các to-do, rồi giao cho agent chuyên môn phù hợp, kể cả các agent lập trình bạn đã cài sẵn như Claude Code, Codex, OpenCode, OpenClaw và Hermes-Agent.
Vấn đề Orkas giải quyết là: hỏi chatbot một câu thì dễ, nhưng giữ cho một dự án chạy liên tục nhiều ngày thì khó. Mỗi lần mở cuộc trò chuyện mới, bạn lại phải giải thích từ đầu. Orkas có khái niệm project để lưu mục tiêu, quy tắc, bộ nhớ và tệp. Cuộc trò chuyện sau tiếp nối đúng chỗ cuộc trước đã dừng. Ngoài ra còn có to-do, tự động làm tiếp việc kế tiếp và lịch chạy định kỳ.
Người nên dùng: chủ shop online, người làm marketing, nhân viên văn phòng cần làm báo cáo, slide, tệp Word/Excel, và lập trình viên muốn một chỗ điều phối nhiều agent. Điểm đáng giá nhất là dữ liệu nằm trên máy bạn theo mặc định, và bạn được tặng 500 credit để dùng mô hình có sẵn mà không cần API key. Hiện repo có khoảng 9.314 sao và 552 fork. Bạn có thể xem video ngắn bên dưới để thấy giao diện thực tế.
Orkas-AI/Orkas
Orkas là ứng dụng máy tính mã nguồn mở (MIT): một Commander biến mục tiêu thành to-do và điều phối 16 agent chuyên môn cùng Claude Code, Codex.
I.Orkas làm được gì
Commander biết lập kế hoạch và giao việc. Bạn không phải chọn agent nào cho việc gì. Commander tách mục tiêu thành các bước, chọn agent, kỹ năng, connector phù hợp và ghép kết quả lại. Nếu không có chuyên gia nào hợp hơn, nó tự phân tích, viết, nghiên cứu hoặc xử lý tệp.
16 agent chuyên môn có sẵn. Mỗi agent có kỹ năng, bộ nhớ và công cụ riêng:
- Nghiên cứu và phân tích: DeepResearcher (báo cáo có nguồn kiểm chứng), SeoGeoAgent (đưa URL vào là có audit SEO và danh sách việc cần sửa), StockAnalyser (phân tích cổ phiếu, backtest).
- Nội dung và media: ContentWriter (bài viết, newsletter), PptMaker (slide PPTX chỉnh sửa được), ImageStudio (poster, ảnh mạng xã hội), VideoStudio (lồng tiếng, phụ đề, cắt clip, dựng lại video tham chiếu), VoiceStudio (giọng đọc, phụ đề, chỉnh âm thanh), UIDesigner (giao diện HTML).
- Làm việc và lập trình: ProductDeveloper (sửa lỗi, refactor, review code), OfficeWorker (tạo, sửa, kiểm tra tệp Word/Excel/PowerPoint/PDF, làm từng tệp hoặc hàng loạt).
- Thương mại điện tử: năm agent gồm ECommerceResearcher, ECommerceWriter, ECommerceReviewer, ECommerceAnalyzer, ECommerceOperator. Riêng ECommerceOperator chỉ thực thi qua công cụ bạn tự kết nối.
Ngoài ra README nói có hơn 30 agent trong chợ agent. Bạn cũng có thể mô tả vai trò cần có để Commander tạo agent riêng cho bạn.
Chạy chung các agent lập trình. Orkas chạy các CLI agent bạn đã cài (Claude Code, Codex, OpenCode, OpenClaw, Hermes-Agent) như phiên làm việc cục bộ. Một cuộc chat có thể sửa lỗi, review thay đổi và soạn ghi chú phát hành.
Giữ việc chạy liên tục.
- Projects: mục tiêu, quy tắc, bộ nhớ, tệp dùng chung cho mọi cuộc trò chuyện.
- To-dos và Auto-advance: khi bật, đội tự nhận việc kế tiếp và đưa kết quả về cho bạn duyệt.
- Scheduled automations: chạy tác vụ 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 đang bật. Từ bản 1.9, mỗi automation sẽ bù lần chạy gần nhất bị lỡ trong vòng 12 giờ khi máy thức dậy hoặc Orkas khởi động.
- Connectors: Gmail, Google Calendar, Sheets, Drive, Notion, Slack, Shopify, Stripe và nhiều dịch vụ khác. Mặc định Orkas hỏi bạn trước khi gửi, đăng hoặc xoá bất cứ thứ gì.
- Apps: mô tả một công cụ, Orkas dựng thành ứng dụng cục bộ ngay trong app.
Đổi mô hình tuỳ ý. Mô hình có sẵn của Orkas, hoặc khoá của riêng bạn: Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, MiniMax, Doubao, hoặc một endpoint cục bộ tương thích OpenAI.
II.Cần chuẩn bị gì
Theo tư liệu, có hai cách dùng:
- Bản đóng gói (khuyên dùng): macOS 12 trở lên (Apple Silicon và Intel) hoặc Windows 10 trở lên. Bạn đăng nhập tài khoản để nhận 500 credit miễn phí cho mô hình có sẵn. Không cần API key để bắt đầu.
- Chạy từ mã nguồn: macOS, Windows, hoặc Linux x64/arm64 với glibc 2.34 trở lên. Không cần tài khoản, nhưng bạn phải tự có khoá API của nhà cung cấp hoặc một endpoint cục bộ. Repo yêu cầu Node từ 22.12.0 trở lên (khai báo trong package.json).
Nếu muốn dùng Claude Code, Codex, OpenCode, OpenClaw hay Hermes-Agent trong Orkas, bạn cần cài sẵn các công cụ đó trên máy. Tư liệu mình có không nói chi tiết cách cài từng cái.
Một số tính năng chỉ có ở bản đóng gói: dự án chia sẻ nhiều người, đồ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ợ các tính năng này. Nếu cần chúng, hãy chọn bản đóng gói.
III.Cài đặt từng bước
- Tải bản càiVào trang tải của Orkas, hệ thống tự nhận macOS hay Windows
- Cài và mở appChạy trình cài đặt vừa tải về
- Đăng nhậpNhận 500 credit để dùng mô hình có sẵn
- Chọn mô hìnhGiữ mô hình có sẵn hoặc nhập khoá của bạn trong Settings
- Tạo project đầu tiênGiao mục tiêu cho Commander
A.Cách 1: Dùng bản đóng gọn (dễ nhất)
README ghi rõ đây là cách khuyên dùng. Bạn vào trang tải của dự án (nút Download trong README trên GitHub). Đường dẫn tải tự phát hiện hệ điều hành và bắt đầu tải đúng bộ cài. Mở tệp vừa tải và cài như mọi ứng dụng khác. Sau đó đăng nhập để nhận 500 credit.
Chỗ người mới hay vấp: bản này cần đăng nhập, còn bản mã nguồn thì không. Đừng nhầm hai bản.
B.Cách 2: Chạy từ mã nguồn
Cách này dành cho người quen dòng lệnh. Trước hết kiểm tra Node đã đủ phiên bản chưa. Mở Terminal (macOS/Linux) hoặc PowerShell (Windows):
node --versionKết quả phải từ v22.12.0 trở lên. Nếu thấp hơn, bạn cần nâng cấp Node trước.
Tiếp theo, tải mã nguồn về:
git clone https://github.com/Orkas-AI/Orkas.git
cd OrkasLệnh đầu tải toàn bộ repo về máy, lệnh sau đi vào thư mục vừa tạo. Phần tiếp theo (lệnh cài phụ thuộc và khởi động) nằm trong mục Quick start của README. Đoạn README mình có bị cắt ở giữa nên mình không chép lệnh ở đây để tránh sai. Bạn mở README.md trong repo và làm theo mục Quick start. Trong thư mục gốc cũng có sẵn run.sh, run.cmd và package.json, nhưng mình chưa có tư liệu nói chính xác cách dùng chúng.
C.Chọn mô hình
Vào Settings → Models. Với bản đóng gói, bạn có thể giữ mô hình Orkas có sẵn. Với bản mã nguồn, bạn nhập khoá của nhà cung cấp hoặc trỏ tới endpoint cục bộ. Mô hình bạn chọn dùng chung cho Commander và các agent có sẵn. Còn các CLI agent bên ngoài vẫn giữ cài đặt mô hình riêng của chúng.
IV.Kiểm tra đã chạy được chưa
Cách đơn giản nhất: mở app, tạo một project và gõ một yêu cầu nhỏ cho Commander, ví dụ viết một đoạn giới thiệu sản phẩm ngắn. Nếu Commander trả lời, lập được to-do và kết quả hiện về để bạn duyệt, thì mô hình đã nối thành công.
Với bản mã nguồn, nếu app mở lên nhưng không trả lời, hãy vào Settings → Models kiểm tra lại khoá hoặc endpoint. README mình có không nêu một dòng thông báo cụ thể nào để xác nhận cài thành công, nên mình không bịa thêm.
Nếu dùng giọng nói: trong bản mã nguồn, điền Orkas API Key ở Settings → Models, bấm biểu tượng micro cạnh ô soạn tin, cho phép truy cập micro khi được hỏi. Bấm lần nữa để dừng, kiểm tra văn bản rồi tự gửi đi. Âm thanh được gửi tới Orkas để nhận dạng và trừ credit của chủ khoá.
V.Dùng vào việc thật
A.Chủ shop: báo cáo bán hàng mỗi tuần
Bạn bán hàng online và xuất số liệu doanh thu, quảng cáo, hoàn tiền ra tệp. Tạo một project cho shop, ghi vào mục tiêu và quy tắc của project (giọng thương hiệu, chỉ số quan tâm). Rồi nhờ Commander giao việc cho ECommerceAnalyzer.
Đọc file bán hàng tuần này, đối chiếu doanh thu, quảng cáo, hoàn tiền, tồn kho. Cho mình các quyết định nên làm tuần tới.Sau đó đặt thành scheduled automation chạy hàng tuần. Kết quả là mỗi tuần có một bản tóm tắt số liệu đã đối chiếu, gửi về để bạn duyệt. Việc đổi giá hay chỉnh danh mục, nếu bạn kết nối Shopify, Orkas sẽ hỏi trước khi thực hiện.
B.Nhân viên văn phòng: từ một chủ đề ra báo cáo và slide
Sếp giao tìm hiểu một thị trường. Bạn gõ mục tiêu cho Commander. Nó tách thành: DeepResearcher làm báo cáo có nguồn, PptMaker dựng slide, VideoStudio làm video giới thiệu nếu bạn cần. README lấy đúng ví dụ này: nghiên cứu thị trường thành báo cáo, bộ slide và video ra mắt.
Một mục tiêu rõ ràng, giao một lần, đội tự chia việc và đem kết quả về cho bạn duyệt.
Ông T
Kết quả là tệp báo cáo và tệp PPTX chỉnh sửa được. Bạn xem lại, sửa rồi dùng. Nếu cần sửa tệp Word, Excel hay PDF có sẵn, hãy giao cho OfficeWorker.
C.Người làm nội dung: dựng lại video theo mẫu
Bạn có một video mẫu chạy tốt và muốn làm bản cho sản phẩm của mình. Đưa tệp video mẫu cho VideoStudio cùng tư liệu của bạn. README đưa prompt mẫu:
Use reference.mp4 as a reference for a 30-second vertical promo. Keep its hook, typography and pacing, replace the content with my product and screen recordings, and show me the breakdown and plan first.Agent phân tích hook, thứ tự thông tin, nhịp hình và lời kêu gọi hành động, rồi đề xuất giữ gì, thay gì trước khi sản xuất. Lưu ý giới hạn: phải là tệp video agent đọc được, chưa hỗ trợ tải video từ link chia sẻ mạng xã hội, và không đảm bảo giống từng khung hình hay giống động tác của người thật. Cách này hợp với video giải thích kiểu đồ hoạ chuyển động, demo ứng dụng, quảng cáo sản phẩm.
D.Lập trình viên: sửa lỗi và review bằng nhiều agent
Bạn đã cài Claude Code và Codex. Trong Orkas, nhờ Commander giao phần sửa lỗi cho một agent, phần review cho agent khác, rồi soạn ghi chú phát hành. Bạn giữ một kế hoạch chung thay vì chuyển qua lại giữa nhiều cửa sổ terminal. Với việc trong repo, ProductDeveloper cũng có thể triển khai PRD, sửa lỗi và refactor.
VI.Lỗi hay gặp và cách xử lý
Node quá cũ khi chạy từ mã nguồn. Repo yêu cầu Node từ 22.12.0. Chạy node --version để kiểm tra. Nếu thấp hơn, nâng cấp Node rồi làm lại.
App mở được nhưng không trả lời. Thường do chưa cấu hình mô hình. Vào Settings → Models, kiểm tra khoá API (bản mã nguồn) hoặc trạng thái đăng nhập và credit (bản đóng gói). Đừng dán khoá vào chat hay ảnh chụp màn hình gửi người khác.
Automation không chạy đúng giờ. Orkas chạy trên máy bạn nên máy ngủ hay tắt thì lịch không chạy. Từ bản 1.9, lần bỏ lỡ gần nhất được bù trong 12 giờ khi máy thức dậy hoặc Orkas khởi động. Vì thế với việc quan trọng, hãy để máy bật vào giờ hẹn.
Không dùng được micro. Nếu bạn từ chối quyền lúc đầu, hãy bật micro cho Orkas trong cài đặt hệ thống rồi thử lại. Nhớ rằng nhập giọng nói cần Orkas API Key và tốn credit.
Không thấy tính năng chia sẻ dự án hay xuất bản web. Đây không phải lỗi. README nói các tính năng này chỉ có ở bản đóng gói, bản mã nguồn mở chưa hỗ trợ.
VII.Có nên dùng không
Điểm mạnh. Một nơi để điều phối nhiều agent mà bạn không phải viết code. Dữ liệu, cuộc trò chuyện và agent tuỳ chỉnh lưu trên đĩa của bạn theo mặc định. Với khoá riêng, lời gọi mô hình đi thẳng từ máy bạn tới nhà cung cấp. Mã nguồn mở MIT nên bạn đọc được mọi thứ nó làm. Connector hỏi trước khi gửi, đăng hay xoá.
Giới hạn. Orkas cần máy bạn bật, trong khi các dịch vụ chạy trên đám mây có thể tiếp tục khi máy tắt. Mô hình có sẵn đi qua dịch vụ do Orkas quản lý, nên nếu bạn muốn mọi thứ chỉ nằm trên máy thì hãy dùng khoá riêng hoặc endpoint cục bộ. Bản mã nguồn thiếu chia sẻ nhóm, đồng bộ đám mây và xuất bản web. Về độ chính xác của đầu ra, tư liệu không cam kết gì, nên bạn vẫn cần duyệt kết quả.
Khi nên chọn cách khác. Chính README nói Orkas không dành cho bạn nếu bạn chỉ cần một chatbot đa năng, hoặc một thư viện code để nhúng vào ứng dụng của mình (khi đó các framework như LangChain hay CrewAI hợp hơn). Nếu bạn chỉ lập trình trong terminal, dùng thẳng Claude Code hoặc Codex cũng được. Orkas không thay thế chúng mà chạy chúng như một phần của đội.
Câu hỏi thường gặp
Orkas có miễn phí không?
Ứng dụng miễn phí để bắt đầu và mã nguồn theo giấy phép MIT. Bản đóng gói tặng 500 credit cho mô hình Orkas có sẵn. Nếu dùng khoá API của nhà cung cấp khác, chi phí theo bảng giá của họ, và README không nói thêm về gói trả phí ngoài việc xuất bản web app cần gói trả phí.
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. Chạy từ mã nguồn thì hỗ trợ macOS, Windows và Linux x64/arm64 với glibc 2.34 trở lên.
Có cần API key hay GPU không?
Bản đóng gói không cần API key để bắt đầu vì có 500 credit cho mô hình Orkas. Bản mã nguồn cần khoá của bạn hoặc một endpoint cục bộ. Tư liệu không nhắc yêu cầu về GPU.
Dữ liệu của tôi có an toàn không?
Theo README, cuộc trò chuyện, tệp, cơ sở tri thức và agent tuỳ chỉnh nằm trên đĩa của bạn theo mặc định, đồng bộ đám mây là tuỳ chọn ở bản đóng gói. Với khoá riêng, lời gọi mô hình đi thẳng từ máy bạn tới nhà cung cấp, còn mô hình Orkas có sẵn chạy qua dịch vụ do Orkas quản lý.
Orkas khác gì Claude Code hay Codex?
Claude Code và Codex là agent lập trình. Orkas không thay thế mà chạy chúng như một phần của đội. Orkas thêm Commander, các agent cho nghiên cứu, nội dung, video, văn phòng, thương mại điện tử, cùng project, to-do và lịch tự động.
Orkas khác LangChain hay CrewAI thế nào?
LangChain và CrewAI là framework để bạn viết code dựng agent. Orkas là ứng dụng desktop bạn điều khiển bằng chat, có sẵn project, to-do và automation, không cần viết code điều phối.
Tắt máy thì automation có chạy không?
Không, vì Orkas chạy trên máy của bạn. README nói từ bản 1.9, mỗi automation sẽ bù lần chạy gần nhất bị lỡ trong 12 giờ khi máy thức dậy hoặc Orkas khởi động.


