# Kortix CompanyOS: hệ điều hành mã nguồn mở cho đội AI agent — hướng dẫn cài đặt và dùng

> Kortix CompanyOS là nền tảng mã nguồn mở viết bằng TypeScript, giúp cả công ty dùng chung một đội AI agent chạy nền, kích hoạt bằng lịch, webhook hoặc tin nhắn. Bạn có thể dùng bản cloud hoặc tự host bằng Docker Compose. Cài CLI chỉ cần một dòng lệnh, nhưng để dùng hết khả năng thì cần thời gian làm quen khái niệm.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-11-06 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/kortix-companyos-he-dieu-hanh-ai-agent-cho-cong-ty

Kortix CompanyOS là một nền tảng mã nguồn mở để chạy AI agent cho cả công ty, thay vì mỗi người mở một khung chat riêng. Tác giả gọi nó là “agent harness” chạy trên đám mây: bạn viết agent, Kortix đưa chúng lên cloud, cho chúng chạy nền, tự thức dậy khi có sự kiện và báo kết quả về cho bạn. Hiện repo có khoảng 20.673 sao và 3.470 fork trên GitHub.

Vấn đề nó nhắm tới khá quen thuộc. Một agent AI thông thường chỉ là một phiên chat trên một máy. Nó chờ bạn gõ, bị chặn khi làm việc dài, và dừng khi laptop ngủ. Một người cũng chỉ theo dõi được vài phiên cùng lúc. Kortix lấy phiên làm việc ra khỏi tay người: mỗi phiên chạy trên một máy tính đám mây riêng, ngủ khi rảnh và dậy lại với đầy đủ lịch sử.

Nếu bạn là chủ doanh nghiệp nhỏ, quản lý vận hành hay lập trình viên muốn dựng “nhân viên AI” làm việc theo lịch, repo này đáng để xem. Điểm đáng giá nhất là toàn bộ agent, kỹ năng (skill), quy tắc và kết nối của công ty nằm trong một git repo do bạn sở hữu, còn mọi thay đổi agent đề xuất đều phải qua một người duyệt.

```repo
- repo | kortix-ai/CompanyOS
- kind | Framework
- desc | Kortix CompanyOS là nền tảng mã nguồn mở để chạy đội AI agent cho cả công ty: chạy nền 24/7, tự kích hoạt theo sự kiện, tự host được trên hạ tầng của bạn.
- stars | 21k
- lang | TypeScript
```

## Kortix CompanyOS làm được gì

Tư liệu của repo mô tả khá nhiều lớp. Mình gom lại thành những ý chính, kèm lợi ích thực tế.

- **My Kortix, một agent duy nhất để nói chuyện.** Bạn chat với My Kortix. Nó trả lời ngay, rồi giao việc viết lách, nghiên cứu, code hay làm app cho agent phù hợp chạy ở phiên riêng. Cuộc trò chuyện của bạn không bị treo trong lúc agent làm.
- **Chạy nền, luôn sẵn sàng.** Máy của mỗi phiên ngủ sau khoảng 15 đến 20 phút kể từ lượt cuối và dậy khi có tin nhắn hoặc sự kiện mới. Máy đang ngủ không tốn tài nguyên tính toán.
- **Kích hoạt theo sự kiện (Triggers).** Lịch hẹn, webhook có chữ ký, sự kiện từ công cụ kết nối hay một change request vừa được merge đều có thể đánh thức agent. Một bộ lọc bằng code loại bỏ nhiễu trước khi có model nào chạy, nên đỡ tốn tiền.
- **Chạy song song nhiều agent (Swarms).** Một phiên có thể giao việc nền, chạy workflow điều phối nhiều agent và nhắn tin cho phiên khác. Mỗi agent con tự báo lại kết quả.
- **Mục tiêu có định nghĩa hoàn thành (Outcomes).** Bạn nêu kết quả mong muốn một lần bằng lời thường. Agent làm qua nhiều lần thức dậy, đến khi một phiên kiểm tra riêng xác nhận là xong.
- **Trí nhớ công ty.** Repo git giữ agent, skill, quy tắc. Drive giữ thư mục chung và ghi nhớ công ty dạng file Markdown. Khi ngữ cảnh đầy, agent tiếp tục ở ngữ cảnh mới và tìm lại đúng dòng cần trong toàn bộ bản ghi phiên, không tóm tắt lại.
- **Kết nối hơn 3.000 ứng dụng.** Ngoài ra còn MCP, OpenAPI, GraphQL và HTTP thô. Mỗi công cụ có thể đặt Cho phép, Hỏi trước hoặc Chặn. Thông tin đăng nhập nằm trên máy chủ, không đi vào máy của agent.
- **Agent dựng và host app.** Trang web, công cụ nội bộ, backend chạy ở một URL ổn định, sau màn đăng nhập của Kortix.
- **Phân quyền và kiểm soát.** Vai trò, nhóm, quyền theo từng tài nguyên, nhật ký kiểm toán, SAML 2.0 SSO, SCIM 2.0. Agent mặc định bị chặn merge; một người phải duyệt thì thay đổi mới vào nhánh main.
- **Làm việc ở nhiều nơi.** Web, desktop, mobile, terminal, Slack, Microsoft Teams, email, và từ các công cụ AI khác qua MCP.
- **Dùng model nào cũng được.** Model do Kortix quản lý, key của chính bạn, gói ChatGPT hoặc gói Claude. Mọi yêu cầu đi qua cổng LLM của Kortix, có ngân sách và quy tắc truy cập.

Tóm lại, README ví công ty như một máy tính: My Kortix là shell, agent là chương trình, skill là thư viện, Drive là hệ thống file, connector là driver, trigger là bộ lập lịch. Cách ví này giúp bạn hình dung bức tranh tổng thể.

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

Tư liệu không liệt kê yêu cầu hệ thống đầy đủ, nên mình chỉ nêu những gì có trong đó.

- **Cách dùng nhanh nhất:** một tài khoản tại kortix.com (bản cloud). README ghi “No setup”: đăng ký, tạo project, bắt đầu một phiên.
- **Cài CLI `kortix`:** README dùng lệnh `curl ... | bash`, tức cần một terminal chạy được shell kiểu Unix. README không nói rõ việc cài trực tiếp trên Windows, nên bạn nên xem Guide của dự án trước khi thử.
- **Tự host:** cần một môi trường chạy Docker Compose, trên tài khoản cloud, VPC hoặc server của bạn. Stack kéo image từ Docker Hub, nên máy cần ra được internet. README nói rõ đây là bản tự host, không phải bản chạy ngoại tuyến.
- **Model:** lần chạy đầu của self-host không hỏi key model. Bạn kết nối GitHub và thêm key model trong app sau đó. Sandbox của agent chạy trên nhà cung cấp bạn cấu hình, mặc định là Platinum.
- **Nếu muốn đóng góp code:** cần `pnpm` (README dùng các lệnh pnpm). Phiên bản Node cụ thể README chưa ghi; xem `CONTRIBUTING.md` và `package.json` trong repo.
- Phần cứng yêu cầu: tư liệu chưa nói.

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

```steps
- Cài CLI | Chạy lệnh cài của Kortix để có lệnh kortix
- Tạo dự án | kortix init sinh ra kortix.yaml cùng agent, skill
- Đưa lên cloud | kortix ship đẩy repo và chạy thật
- Hoặc tự host | kortix self-host start dựng stack Docker Compose
- Chạy phiên đầu | kortix sessions new với một yêu cầu bằng lời
```

README gọi đây là “ba lệnh”: cài CLI, tạo dự án, đưa lên chạy. Mình đi qua từng bước.

### Cài CLI kortix

Mở terminal (nơi bạn gõ được lệnh shell) và chạy:

```bash
curl -fsSL https://kortix.com/install | bash
```

Lệnh này tải script cài đặt từ kortix.com rồi chạy ngay bằng bash. Gói npm của dự án tên `kortix`, nhưng README hướng dẫn cài bằng script này, nên cứ làm theo README. Vì script chạy thẳng trên máy bạn, nên nếu cẩn thận, hãy mở địa chỉ https://kortix.com/install trong trình duyệt đọc qua trước khi chạy.

### Tạo dự án với kortix init

Đứng trong thư mục bạn muốn đặt dự án rồi chạy:

```bash
kortix init
```

Lệnh này dựng bộ khung: file `kortix.yaml` (nơi khai báo toàn bộ) cùng agent, skill và cấu hình runtime. Người mới hay vấp ở chỗ chạy `init` sai thư mục, nên hãy `cd` vào thư mục trống trước.

### Đưa lên chạy với kortix ship

```bash
kortix ship
```

README mô tả lệnh này là đẩy repo và đưa cả hệ thống lên cloud. Bạn sẽ cần tài khoản Kortix Cloud; README không nêu chi tiết các bước đăng nhập ở đây, nên nếu CLI hỏi gì, hãy làm theo hướng dẫn trên màn hình và tra thêm trong Guide tại kortix.com/docs/guide.

### Hoặc tự host bằng Docker Compose

Nếu muốn chạy trên hạ tầng của mình, README đưa ba lệnh:

```bash
curl -fsSL https://kortix.com/install | bash
kortix self-host start
kortix hosts use selfhost  # ↔  kortix hosts use cloud
```

Dòng đầu cài CLI như trên. `kortix self-host start` dựng một stack Docker Compose. Lần chạy đầu sẽ hỏi sáu câu hỏi, không hỏi key model. `kortix hosts use selfhost` chuyển CLI sang nói chuyện với bản tự host của bạn, còn `kortix hosts use cloud` chuyển ngược lại. Hãy bật Docker trước khi chạy. Hướng dẫn tự host đầy đủ nằm ở https://kortix.com/docs/host.

### Chạy phiên làm việc đầu tiên

```bash
kortix sessions new --prompt "Summarize this week's commits and open a change request"
kortix cr ls          # review what an agent proposes, merge to keep it
kortix chat           # talk to a session's agent from your terminal
```

Dòng đầu tạo một phiên mới với yêu cầu “tóm tắt các commit trong tuần và mở một change request”. Dòng hai liệt kê các change request, tức những thay đổi agent đề xuất; bạn xem rồi merge nếu đồng ý. Dòng ba cho phép chat với agent của một phiên ngay trong terminal.

```note
Agent chạy bằng key model và kết nối tới công cụ thật của công ty. Hãy đặt quyền Hỏi trước hoặc Chặn cho các công cụ nhạy cảm, đặt ngân sách cho model, và chỉ duyệt change request sau khi đã đọc nội dung. Đừng dán key vào prompt hay commit vào repo.
```

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

README không nêu một dòng kết quả mẫu cụ thể, nên mình chỉ gợi ý những dấu hiệu theo đúng các lệnh có trong tư liệu:

- Gõ `kortix` trong terminal mới mở mà không báo “không tìm thấy lệnh” nghĩa là CLI đã vào máy. Nếu báo lỗi, đóng terminal rồi mở lại.
- Sau `kortix init`, thư mục có file `kortix.yaml` cùng agent, skill đi kèm.
- Sau `kortix sessions new ...`, phiên xuất hiện trong web app. Lệnh `kortix cr ls` sẽ liệt kê change request khi agent có đề xuất.
- Với tự host, sau `kortix self-host start` và khi đã trả lời sáu câu hỏi, bạn mở app, kết nối GitHub và thêm key model như README nói.

Chi tiết màn hình và thông báo thành công cụ thể mình không có trong tư liệu. Hãy đối chiếu với Guide chính thức.

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

Các tình huống dưới đây bám theo những khả năng README mô tả. Câu lệnh mẫu là ví dụ do mình đặt, để bạn hình dung.

### Tình huống 1: Dev tóm tắt công việc cuối tuần

Bạn là lập trình viên trong nhóm nhỏ, cuối tuần muốn có bản tóm tắt thay đổi mà không phải tự đọc từng commit. Dùng đúng lệnh trong README:

```bash
kortix sessions new --prompt "Summarize this week's commits and open a change request"
kortix cr ls
```

Agent chạy trên máy cloud riêng của phiên, đọc repo và mở một change request. Bạn xem bằng `kortix cr ls`, đọc nội dung rồi merge nếu ổn. Kết quả: một bản tóm tắt nằm sẵn trong repo, có người duyệt.

### Tình huống 2: Chủ shop giao việc lặp lại cho agent

Bạn bán hàng online và hằng tuần phải tổng hợp đơn, kiểm tra tồn kho, soạn báo cáo. Kortix cho phép agent bắt đầu từ lịch hẹn hoặc webhook mà không cần ai ngồi gõ. Bạn nêu mục tiêu một lần bằng lời thường, ví dụ “mỗi sáng thứ Hai, tổng hợp đơn tuần trước và gửi báo cáo vào Slack”, kèm quy tắc cần giữ. Agent lên kế hoạch, tự hẹn giờ thức dậy, làm việc, rồi một phiên khác kiểm tra kết quả. Kết quả: báo cáo đến đều đặn, còn việc bạn làm là duyệt khi có thay đổi cần duyệt.

> Agent giỏi đến đâu cũng vô ích nếu nó ngủ quên khi bạn đóng laptop.
>
> — Ông T

Lưu ý: việc kết nối Slack hay các ứng dụng bán hàng cụ thể cần bạn thiết lập connector trong app. README nói có hơn 3.000 ứng dụng, nhưng danh sách và cách cấu hình từng cái bạn cần xem trong Guide.

### Tình huống 3: Nhân viên văn phòng hỏi qua Slack hoặc Teams

Cả phòng ban dùng chung một AI: ai cũng làm việc với cùng agent, skill và trí nhớ công ty, từ web, Slack hoặc Microsoft Teams. Ví dụ nhân viên nhắn My Kortix yêu cầu soạn bản nháp báo giá. My Kortix trả lời ngay và giao cho agent phù hợp xử lý ở nền, sau đó báo kết quả. Vai trò, nhóm và quyền theo tài nguyên quyết định ai được làm gì, nên bạn kiểm soát được dữ liệu nào ai đụng tới.

### Tình huống 4: Công ty muốn dữ liệu nằm trong hạ tầng của mình

Bạn là người phụ trách IT của một công ty cần giữ dữ liệu trong mạng riêng. README ghi Kortix tự host được trên cloud của bạn, VPC hoặc server riêng, từ cùng các image với bản cloud. Bạn chạy `kortix self-host start`, trả lời sáu câu hỏi, rồi kết nối GitHub và thêm key model trong app. Nhớ rằng sandbox mặc định của agent chạy trên Platinum nếu bạn không cấu hình khác, và stack kéo image từ Docker Hub.

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

**1. Gõ kortix báo không tìm thấy lệnh.** Script cài có thể chưa cập nhật đường dẫn trong terminal đang mở. Đóng terminal, mở cái mới rồi thử lại. Nếu vẫn lỗi, chạy lại lệnh cài và đọc kỹ thông báo của script.

**2. Lệnh curl chạy trên Windows không được.** README dùng cú pháp `curl ... | bash` kiểu Unix, và tư liệu không nói rõ về Windows. Bạn có thể thử trong một môi trường bash (ví dụ Git Bash hoặc WSL), nhưng mình chưa kiểm chứng. Hãy xem Guide chính thức trước.

**3. Tự host không khởi động.** Lỗi hay gặp là Docker chưa bật hoặc máy không ra được internet để kéo image từ Docker Hub. Bật Docker, kiểm tra mạng rồi chạy lại `kortix self-host start`. Chi tiết xem tại https://kortix.com/docs/host.

**4. Agent chạy nhưng không có model để trả lời.** Lần chạy đầu của self-host không hỏi key model, bạn phải thêm sau trong app. Vào phần cài đặt model, thêm key của bạn hoặc chọn nhà cung cấp, rồi tạo lại phiên.

**5. Agent đề xuất thay đổi nhưng không vào được main.** Đây là thiết kế có chủ ý: agent bị chặn merge mặc định, cần một người duyệt change request. Dùng `kortix cr ls` để xem, đọc kỹ rồi merge. Đừng nới quyền chỉ để cho nhanh.

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

**Điểm mạnh.** Cách tiếp cận “công ty như code” rất rõ ràng: mọi thứ nằm trong một git repo, có lịch sử, có duyệt. Agent chạy nền, kích hoạt theo sự kiện và chạy song song, nên hợp với việc lặp lại hoặc kéo dài. Có phân quyền, nhật ký, SSO, và mã nguồn mở nên bạn đọc, fork, kiểm tra được. Dự án còn được cập nhật trong vài tháng gần đây và có lượng sao lớn.

**Giới hạn.** Đây là nền tảng lớn, khái niệm nhiều (agent, skill, trigger, outcome, change request…), không phải công cụ cài rồi dùng trong năm phút. Người mới sẽ cần đọc Guide. Chi phí model và hạ tầng chạy là chuyện của bạn; tư liệu chưa nêu bảng giá. Giấy phép: README không ghi rõ trong phần mô tả; repo có file LICENSE và WHITE-LABEL-LICENSE.md, bạn nên đọc kỹ nếu định dùng thương mại hoặc đặt tên riêng. Bản white-label có điều kiện dùng Platinum làm nhà cung cấp compute duy nhất. Tự host cũng chưa phải bản chạy ngoại tuyến.

**Khi nào chọn cách khác.** Nếu bạn chỉ cần một trợ lý chat cho cá nhân hoặc một vài tác vụ đơn giản, một công cụ AI thường sẽ nhẹ hơn nhiều. Kortix đáng thử khi bạn muốn cả đội dùng chung agent, cần chạy nền theo lịch và sự kiện, hoặc cần kiểm soát dữ liệu và quyền ở mức doanh nghiệp. Một lời khuyên thực tế: bắt đầu bằng bản cloud để làm quen, rồi mới cân nhắc tự host.

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

### Kortix CompanyOS có miễn phí không?

Repo là mã nguồn mở và bạn có thể tự host. Tư liệu không nêu bảng giá của bản Kortix Cloud, nên mình chưa có thông tin. Bạn vẫn phải tự trả chi phí model (key riêng hoặc model do Kortix quản lý) và hạ tầng chạy.

### Repo này dùng giấy phép gì?

Phần mô tả repo không ghi rõ giấy phép. Trong repo có file LICENSE và WHITE-LABEL-LICENSE.md, bạn nên đọc kỹ cả hai trước khi dùng thương mại. README cho biết giấy phép white-label miễn phí nhưng yêu cầu dùng Platinum làm nhà cung cấp compute độc quyền.

### Có cần GPU không?

Tư liệu không nhắc tới yêu cầu GPU hay phần cứng cụ thể. Agent chạy trên máy đám mây riêng cho mỗi phiên và có thể dùng model từ nhà cung cấp bằng key của bạn. Với tự host, cần môi trường chạy Docker Compose.

### Chạy được trên Windows không?

README chưa nói rõ. Lệnh cài đặt dùng cú pháp curl kết hợp bash, quen thuộc trên môi trường kiểu Unix. Cách an toàn nhất là dùng bản cloud qua web, hoặc xem Guide chính thức trước khi cài CLI trên Windows.

### Dữ liệu của tôi có an toàn không?

README nêu mỗi phiên chạy trên một máy cô lập, thông tin đăng nhập của connector nằm trên máy chủ, secret được mã hóa với một khóa riêng cho mỗi project, và agent mặc định bị chặn merge. Dự án cũng ghi đã được xác minh SOC 2 Type I. Bạn có thể tự host trong VPC hoặc mạng riêng để giữ dữ liệu trong hạ tầng của mình.

### Tự host có chạy hoàn toàn ngoại tuyến được không?

Không. README nói rõ stack kéo image từ Docker Hub, nên đây là bản tự host chứ không phải bản ngắt kết nối. Sandbox của agent chạy trên nhà cung cấp bạn cấu hình, mặc định là Platinum.

### Khác gì việc chat với một AI thông thường?

Theo README, một agent thường là một phiên chat trên một máy, chờ bạn gõ. Kortix cho agent chạy nền trên máy đám mây riêng, tự bắt đầu từ lịch, webhook hay sự kiện, chạy song song nhiều agent và dùng chung trí nhớ cho cả nhóm. Mọi thay đổi vào main phải qua một người duyệt.
