# 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

> Orkas là ứng dụng desktop mã nguồn mở (MIT) cho macOS và Windows, hoạt động như một đội AI: bạn nói mục tiêu, Commander lập danh sách việc và giao cho các agent chuyên môn. Bản đóng gói tải về miễn phí, có 500 credit để dùng model có sẵn nên không cần API key. Cài bản đóng gói khá dễ, chỉ như cài một phần mềm thông thường; chạy từ mã nguồn thì cần Node 22.12 trở lên.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-07 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/orkas-doi-ai-agent-tren-may-tinh-huong-dan-cai-dat

Orkas là một ứng dụng desktop mã nguồn mở, hoạt động như một đội AI làm việc cùng bạn. Bạn nói với **Commander** (người điều phối) thứ bạn cần. 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 các agent chuyên môn, hoặc cho các agent lập trình bạn đã có như Claude Code, Codex, OpenCode, OpenClaw và Hermes-Agent.

Điểm khác với một khung chat thông thường là Orkas được làm để giữ cho công việc chạy tiếp, không chỉ trả lời một câu hỏi rồi dừng. Mỗi **project** lưu mục tiêu, quy tắc, bộ nhớ và file. Lần sau mở cuộc trò chuyện mới, đội vẫn nhớ chỗ đang dở. Bạn cũng có thể hẹn lịch để việc lặp lại theo giờ, ngày, tuần hoặc tháng. Repo hiện có khoảng 9.296 sao và 549 fork, giấy phép MIT.

Bạn nên đọc bài này nếu bạn làm kinh doanh, làm văn phòng hoặc là lập trình viên mới, và muốn một "đội trợ lý" chạy ngay trên máy mình, dữ liệu để trên ổ đĩa của mình. Bạn có thể xem video ngắn bên dưới để thấy giao diện trước, rồi quay lại làm theo từng bước.

```repo
- repo | Orkas-AI/Orkas
- kind | Ứng dụng
- desc | Orkas là app desktop mã nguồn mở: một Commander chia mục tiêu thành việc nhỏ và điều phối 16 agent chuyên môn cùng Claude Code, Codex trên máy bạn.
- stars | 9.3k
- lang | JavaScript
- license | MIT
```

```video
- youtube | https://youtube.com/shorts/cLwP5jX8vWQ
- facebook | https://www.facebook.com/reel/1134123555687898
- title | Video giới thiệu Orkas
```

## Orkas làm được gì

**Commander biết lập kế hoạch.** Bạn đưa một mục tiêu, nó tách thành các bước, chọn đúng agent, kỹ năng và kết nối cho từng bước rồi gộp kết quả lại. Ví dụ nghiên cứu thị trường có thể thành một báo cáo, một bộ slide và một video giới thiệu. Nếu không có agent nào hợp hơn, Commander tự làm các việc như phân tích, viết, nghiên cứu hay xử lý file.

**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 một đường link, nhận bản kiểm tra SEO và danh sách việc cần sửa), StockAnalyser (phân tích cổ phiếu, kiểm tra rủi ro danh mục).
- Nội dung và hình ảnh, âm thanh: 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, 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 listing, phân tích đánh giá, phân tích doanh số và lập kế hoạch thay đổi danh mục hàng.

Ngoài ra có hơn 30 agent trong chợ agent. Bạn cũng có thể mô tả vai trò mình cần và để Commander dựng một agent riêng.

**Giữ việc chạy liên tục.** Đây là phần đáng giá nhất:

- **Projects**: mục tiêu, quy tắc, bộ nhớ và file dùng chung cho mọi cuộc trò chuyện, đỡ phải giải thích lại từ đầu.
- **To-dos và Auto-advance**: mỗi project có danh sách việc cho người và agent. Bật Auto-advance thì đội tự nhận việc kế tiếp và đem kết quả về cho bạn duyệt.
- **Tự động hoá theo lịch**: chạy một việc theo giờ, ngày, tuần, tháng. Orkas chạy trên máy bạn. Từ bản v1.9, nếu máy ngủ hoặc app chưa mở, lần chạy bị lỡ gần nhất sẽ được bù trong vòng 12 giờ khi máy thức dậy hoặc app khởi động.
- **Connectors**: nối với 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ụ nhỏ (máy tính báo giá, form đặt lịch…) và Orkas dựng nó thành app chạy trong chính ứng dụng.

**Chạy chung các agent lập trình.** Orkas gọi Claude Code, Codex, OpenCode, OpenClaw, Hermes-Agent như các phiên chạy cục bộ. Một cuộc chat có thể vừa sửa lỗi, vừa review thay đổi, vừa viết ghi chú phát hành. Orkas không thay thế các công cụ này mà điều phối chúng.

**Chọn model tuỳ ý.** Bạn dùng model Orkas có sẵn, hoặc key của riêng mình (Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, MiniMax, Doubao), hoặc một endpoint cục bộ tương thích OpenAI. Commander và các agent có sẵn dùng chung một cài đặt model. Các agent CLI bên ngoài giữ cài đặt model riêng của chúng.

## Cần chuẩn bị gì

Theo tư liệu, có hai cách dùng, yêu cầu khác nhau.

**Bản đóng gói (khuyên dùng):**

- macOS 12 trở lên (cả chip Apple Silicon và Intel) hoặc Windows 10 trở lên.
- Đăng nhập tài khoản, được tặng 500 credit cho model Orkas có sẵn, nên không cần API key để bắt đầu.
- Nếu muốn dùng key riêng thì chuẩn bị key của nhà cung cấp bạn chọn.

**Chạy từ mã nguồn:**

- macOS, Windows, hoặc Linux x64/arm64 có glibc 2.34 trở lên.
- Node từ 22.12.0 trở lên (theo package.json).
- Không cần tài khoản, nhưng phải tự có key của nhà cung cấp model hoặc một endpoint cục bộ.
- Bản mã nguồn hiện chưa hỗ trợ dự án chia sẻ, đồng bộ đám mây và xuất bản web app. Các tính năng này chỉ có ở bản đóng gói.

Tư liệu không nói về yêu cầu RAM hay GPU. Nếu bạn dùng model qua key hay model Orkas có sẵn thì phần tính toán nặng nằm ở nhà cung cấp, nhưng mình chưa có thông tin chính thức về cấu hình tối thiểu.

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

```steps
- Tải bản cài | Vào trang tải của Orkas, nút tải tự nhận hệ điều hành
- Cài và mở app | Chạy file cài đặt như phần mềm thông thường
- Đăng nhập hoặc nhập key | Nhận 500 credit, hoặc cấu hình model riêng trong Settings
- Tạo project đầu tiên | Ghi mục tiêu, quy tắc rồi giao việc cho Commander
- (Tuỳ chọn) Chạy từ mã nguồn | Dành cho người muốn xem code hoặc dùng không cần tài khoản
```

### Tải bản cài đặt

Mở trang tải của Orkas (địa chỉ orkas.ai, mục Download, cũng là nút tải nằm đầu README của repo). Liên kết tải tự nhận hệ điều hành và bắt đầu tải đúng bộ cài cho macOS hoặc Windows. Bạn không cần gõ lệnh nào ở bước này.

### Cài và mở app

Mở file vừa tải và làm theo màn hình cài đặt như mọi phần mềm khác. Trên Windows, nếu hệ thống hỏi quyền, hãy chọn cho phép cài. README không ghi chi tiết các hộp thoại này, nên nếu máy bạn có cảnh báo lạ thì dừng lại và kiểm tra lại nguồn tải là trang chính thức.

### Đăng nhập hoặc chọn model

Mở app và đăng nhập. Bản đóng gồm 500 credit miễn phí cho model Orkas, đủ để thử. Nếu muốn dùng key của mình thì vào **Settings → Models** và điền key của nhà cung cấp (hoặc địa chỉ endpoint cục bộ). Hãy dán key vào đúng ô trong phần cài đặt của app, không gửi key qua chat hay lưu trong file chia sẻ.

### Tạo project đầu tiên

Tạo một project, ghi mục tiêu và vài quy tắc (giọng văn, định dạng đầu ra, những việc không được tự làm). Sau đó nhắn cho Commander yêu cầu đầu tiên của bạn. Bạn có thể mở danh sách to-do để xem nó chia việc ra sao.

### Chạy từ mã nguồn (tuỳ chọn)

Bước đầu tiên là lấy mã về máy. Mở terminal (PowerShell hoặc Git Bash trên Windows, Terminal trên macOS) và chạy:

```bash
git clone https://github.com/Orkas-AI/Orkas.git
cd Orkas
```

Lệnh đầu tải mã về thư mục `Orkas`. Lệnh thứ hai đi vào thư mục đó. Trong repo có `package.json` (tên gói npm là `orkas`, yêu cầu Node 22.12.0 trở lên), và các file `run.sh`, `run.cmd`.

Phần README mình có chỉ nhắc tới mục "Quick start" cho cách chạy từ mã nguồn, nhưng nội dung lệnh cụ thể không nằm trong đoạn tư liệu này. Vì vậy mình không tự đoán lệnh. Bạn hãy mở mục Quick start trong README của repo và làm đúng theo đó. Người mới vấp nhiều nhất ở chỗ Node quá cũ: gõ `node -v` để chắc là từ 22.12.0 trở lên.

```note
Key API là tài sản của bạn. Chỉ điền vào ô cài đặt trong app, không dán vào chat nhóm, không đưa vào file chia sẻ. Khi dùng model Orkas có sẵn hay giọng nói qua Orkas API Key, credit của chủ key sẽ bị trừ.
```

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

Tư liệu không đưa ra một lệnh "kiểm tra" riêng. Cách đơn giản nhất là thử trực tiếp:

1. Mở app, đăng nhập (hoặc cấu hình model) mà không báo lỗi.
2. Tạo project, nhắn Commander một việc nhỏ, ví dụ: "Tóm tắt giúp mình ba ý chính của file này" kèm một file ngắn.
3. Commander trả lời, hoặc tạo danh sách to-do và giao cho một agent. Thấy to-do xuất hiện và có kết quả quay về là cài thành công.

Nếu bạn dùng bản mã nguồn và 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 khung soạn, cho phép truy cập micro khi được hỏi. Bấm lần nữa để dừng, xem lại chữ rồi tự gửi.

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

### Chủ shop: báo cáo doanh số mỗi tuần

Bạn bán hàng online, mỗi tuần phải xuất file doanh số, quảng cáo, hoàn tiền rồi ngồi cộng trừ. Trong Orkas, tạo project "Báo cáo tuần", ghi quy tắc như "số liệu phải đối chiếu được, kết luận kèm hành động". Sau đó nhắn:

```text
Đây là file xuất doanh số và quảng cáo tuần này. Đối chiếu số liệu, cho mình biết sản phẩm nào lãi, sản phẩm nào đang lỗ vì quảng cáo, và đề xuất 3 việc nên làm tuần sau.
```

Commander sẽ giao cho agent phân tích doanh số (ECommerceAnalyzer). Bạn nhận lại các chỉ số đã đối chiếu và đề xuất. Sau đó đặt tự động hoá theo tuần để việc này lặp lại. Nếu nối Shopify hay Google Sheets qua connector thì dữ liệu lấy được tiện hơn, và mặc định Orkas vẫn hỏi bạn trước khi gửi hoặc thay đổi gì.

> Một project nhớ giúp bạn mục tiêu và quy tắc, nên mỗi tuần bạn chỉ cần nói việc mới, không phải kể lại từ đầu.
>
> — Ông T

### Nhân viên văn phòng: từ báo cáo nghiên cứu ra bộ slide

Sếp nhờ bạn làm báo cáo về một thị trường và một bộ slide để họp. Bạn nhắn:

```text
Nghiên cứu thị trường [chủ đề của bạn], nêu rõ nguồn và chỗ các nguồn mâu thuẫn nhau. Sau đó làm bộ slide PowerPoint 10 trang để mình trình bày.
```

Commander chia việc: DeepResearcher viết báo cáo có nguồn kiểm chứng, PptMaker dựng file PPTX chỉnh sửa được. Bạn nhận một báo cáo và một bộ slide để duyệt. Quan trọng là bạn vẫn phải tự đọc lại số liệu và nguồn trước khi gửi sếp, vì đây là công cụ hỗ trợ, không phải người chịu trách nhiệm thay bạn.

### Lập trình viên mới: cho nhiều agent cùng làm một việc

Bạn đã cài Claude Code và Codex trên máy. Trong Orkas, bạn mô tả một lỗi cần sửa. Commander có thể giao việc sửa cho một agent lập trình, giao việc review cho agent khác, rồi nhờ ContentWriter viết ghi chú phát hành. Orkas chạy các agent CLI bạn đã cài như phiên cục bộ và giữ một kế hoạch chung cho cả nhóm. Bạn vẫn nên đọc lại thay đổi code trước khi gộp.

### Làm marketing: dựng lại video mẫu bằng nội dung của bạn

Bạn có một video quảng cáo bạn thích và muốn làm bản của riêng mình. README đưa sẵn một câu lệnh mẫu cho VideoStudio:

```text
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 phần mở đầu, thứ tự thông tin, nhịp hình ảnh và lời kêu gọi hành động, rồi đề xuất giữ gì, thay gì trước khi dựng. Lưu ý giới hạn: bạn cần có sẵn file video agent đọc được, vì tải video từ link mạng xã hội chưa được tích hợp. Chuyển động camera chính xác, diễn xuất của người thật và việc khớp từng khung hình không được đảm bảo.

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

**Agent không trả lời hoặc báo thiếu model.** Thường do chưa đăng nhập, hết 500 credit, hoặc key điền sai. Vào **Settings → Models** kiểm tra lại. Nếu dùng key riêng, thử tạo key mới ở trang của nhà cung cấp rồi dán lại.

**Tự động hoá không chạy đúng giờ.** Orkas chạy trên máy bạn, nên máy tắt hoặc ngủ thì việc không chạy được. Theo README, từ v1.9 lần chạy bị lỡ gần nhất sẽ được bù trong 12 giờ khi máy thức dậy hoặc app khởi động. Nếu việc quan trọng và cần chạy đúng giờ, hãy để máy bật suốt hoặc chọn công cụ chạy trên đám mây.

**Không thấy các tính năng chia sẻ, đồng bộ hay xuất bản web app.** Các tính năng này chỉ có ở bản đóng gói, bản chạy từ mã nguồn chưa hỗ trợ. Nếu cần, hãy dùng bản đóng gói.

**Chạy từ mã nguồn bị lỗi ngay khi khởi động.** Kiểm tra `node -v`. Repo yêu cầu Node 22.12.0 trở lên, bản cũ hơn rất dễ gây lỗi. Sau đó làm đúng mục Quick start trong README thay vì tự thử lệnh lạ.

**Nút micro không hoạt động.** Bạn cần cấu hình Orkas API Key trong **Settings → Models** và cho phép micro khi hệ thống hỏi. Nếu từng từ chối, hãy bật lại quyền micro trong cài đặt hệ thống.

## Có nên dùng không

**Điểm mạnh.** Orkas gom nhiều thứ vào một chỗ: đội agent có sẵn, project có bộ nhớ, to-do, tự động hoá theo lịch, connectors, và khả năng chạy cùng Claude Code, Codex. Dữ liệu mặc định nằm trên máy bạn. Khi dùng key riêng, lời gọi model đi thẳng từ máy bạn tới nhà cung cấp; riêng model Orkas có sẵn chạy qua dịch vụ do Orkas quản lý. Giấy phép MIT nên bạn đọc được code và agent làm gì. Bản đóng gói tải miễn phí, có 500 credit để thử.

**Giới hạn.** Orkas cần máy bạn bật mới chạy việc, khác với các công cụ chạy trên đám mây. Bản mã nguồn thiếu chia sẻ, đồng bộ và xuất bản web app. Chạy từ mã nguồn cần Node mới và phải tự có key. Ngoài ra, tư liệu mình có không nói rõ về cấu hình máy tối thiểu.

**Nên chọn cách khác khi nào.** Theo chính README, Orkas không dành cho bạn nếu bạn chỉ cần một chatbot đa năng, hoặc cần 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 cần việc chạy ngầm khi máy tắt, hãy cân nhắc dịch vụ chạy trên đám mây.

Nếu bạn muốn một đội trợ lý làm việc dài ngày, dữ liệu để trên máy mình, thì Orkas đáng để cài thử một buổi. Bắt đầu bằng bản đóng gói và một việc nhỏ có thật trong công việc của bạn, rồi mới mở rộng sang tự động hoá.

## 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 và bản đóng gói tải miễn phí, kèm 500 credit cho model Orkas có sẵn nên không cần API key để bắt đầu. Sau khi hết credit, bạn có thể dùng key riêng của nhà cung cấp. Tư liệu mình có chưa nêu chi tiết giá các 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 (cả Apple Silicon và Intel). Chạy từ mã nguồn thì hỗ trợ thêm Linux x64/arm64 với glibc 2.34 trở lên.

### Có cần GPU hay máy cấu hình mạnh không?

Tư liệu không nêu yêu cầu GPU hay RAM tối thiểu. Bạn có thể dùng model có sẵn của Orkas, model qua key riêng, hoặc một endpoint cục bộ tương thích OpenAI. Cấu hình cụ thể cho từng cách thì chưa có thông tin.

### Dữ liệu của mình có an toàn không?

Theo README, hội thoại, file, cơ sở tri thức và agent tuỳ chỉnh mặc định nằm trên ổ đĩa của bạn, còn đồng bộ đám mây là tuỳ chọn ở bản đóng gói. Khi dùng key riêng, lời gọi model đi thẳng từ máy bạn tới nhà cung cấp; model Orkas có sẵn chạy qua dịch vụ do Orkas quản lý. Mặc định app hỏi trước khi gửi, đăng hoặc xoá thứ gì.

### Orkas khác gì Claude Code hay Codex?

Claude Code và Codex là agent lập trình. Orkas chạy chúng như một phần của đội, rồi thêm 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 hoá. Nói ngắn gọn, bạn không phải chọn một trong hai mà có thể dùng cùng nhau.

### Orkas khác gì LangChain hay CrewAI?

LangChain và CrewAI là framework để lập trình viê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 projects, to-dos và tự động hoá. Nếu bạn cần nhúng agent vào sản phẩm của mình thì framework hợp hơn.

### Tự động hoá có chạy khi máy tắt không?

Không. Orkas chạy trên máy bạn nên cần máy bật. Theo README, từ v1.9, lần chạy bị lỡ gần nhất sẽ được bù trong vòng 12 giờ khi máy thức dậy hoặc khi mở lại Orkas.
