# CompanyOS: hệ điều hành cho công ty chạy bằng AI agent — hướng dẫn cài đặt và dùng

> Kortix CompanyOS là hệ điều hành mã nguồn mở cho công ty, nơi nhiều AI agent chạy song song, có chung bộ nhớ và được kích hoạt bởi lịch hẹn, webhook hay tin nhắn. Bạn có thể dùng bản đám mây (chỉ cần đăng ký) hoặc cài bằng CLI `kortix`. Cài CLI chỉ một dòng lệnh, nhưng tự host cần biết Docker.

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

Kortix CompanyOS là một nền tảng mã nguồn mở để chạy AI agent cho cả công ty, không chỉ cho một người ngồi trước một khung chat. Tác giả gọi nó là "cloud-native agent harness": bạn viết các agent riêng, Kortix đưa chúng lên đám mây, cho mỗi phiên làm việc một máy tính riêng và lo phần còn lại như lịch chạy, bộ nhớ, quyền hạn và duyệt thay đổi.

Người nên quan tâm là chủ doanh nghiệp nhỏ muốn thử cho AI làm việc lặp lại mỗi ngày, nhóm kỹ thuật muốn có một "bộ khung" agent dùng chung, và lập trình viên thích quản lý mọi thứ bằng git. Nếu bạn chỉ cần một chatbot hỏi đáp thì repo này hơi nặng so với nhu cầu.

Điểm đáng giá nhất: toàn bộ công ty của bạn (agent, kỹ năng, quy tắc, kết nối) nằm trong một repo git do bạn sở hữu. Mọi thay đổi do agent đề xuất đều đi qua một yêu cầu thay đổi (change request) mà người thật duyệt. Hiện repo có khoảng 20.677 sao và 3.471 fork, và vẫn được cập nhật trong vài tháng gần đây.

```repo
- repo | kortix-ai/CompanyOS
- kind | Framework
- desc | Kortix CompanyOS là nền tảng mã nguồn mở để chạy nhiều AI agent làm việc 24/7 cho cả công ty, dùng trên đám mây Kortix hoặc tự cài trên hạ tầng của bạn.
- stars | 21k
- lang | TypeScript
```

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

Tác giả so sánh nó với hệ điều hành máy tính: có "vỏ" để trò chuyện, có "chương trình", có "thư viện", có "ổ đĩa". Dưới đây là những phần bạn sẽ dùng nhiều nhất.

- **My Kortix, một agent để trò chuyện.** Bạn nói chuyện với một agent duy nhất. 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 chuyên trách chạy ngầm. Cuộc trò chuyện của bạn không bị chặn lại chờ việc dài.
- **Luôn bật, chạy theo sự kiện.** Agent có thể được khởi động bởi lịch hẹn, webhook có chữ ký, sự kiện từ công cụ bạn kết nối, hoặc khi một change request được merge. Bạn không cần ngồi gõ lệnh.
- **Mỗi phiên một máy tính đám mây riêng.** Máy tự ngủ sau 15 đến 20 phút không hoạt động và thức dậy khi có tin nhắn hay sự kiện mới, còn nguyên lịch sử. Máy đang ngủ không tốn tài nguyên tính toán.
- **Chạy song song nhiều agent.** Một phiên có thể giao việc ngầm, chạy quy trình điều phối nhiều agent, hoặc nhắn cho phiên khác. README nói hàng nghìn agent có thể chạy song song trên một cấu hình.
- **Kết quả theo mục tiêu (Outcomes).** Bạn nêu mục tiêu và tiêu chí hoàn thành. Agent làm lặp đi lặp lại cho đến khi một phiên kiểm tra độc lập xác nhận là xong.
- **Kết nối hơn 3.000 ứng dụng**, cùng MCP, OpenAPI, GraphQL và HTTP thô. Mỗi công cụ có thể đặt Cho phép, Hỏi hoặc Chặn. Thông tin đăng nhập nằm ở phía máy chủ, không đưa vào máy của agent.
- **Bộ nhớ chung của công ty.** Repo git giữ agent, kỹ năng và quy tắc. Drive giữ thư mục dùng chung và bộ nhớ công ty dạng Markdown. Khi ngữ cảnh đầy, agent tìm lại nguyên văn trong bản ghi đầy đủ của phiên thay vì tóm tắt.
- **Tự dựng và host ứng dụng nội bộ** ở một địa chỉ cố định, đặt sau đăng nhập Kortix, có snapshot, phát hành và quay lui.
- **Chọn mô hình tuỳ ý:** mô hình do Kortix quản lý, key của bạn, hoặc gói thuê bao ChatGPT / Claude. Mọi yêu cầu đi qua cổng LLM của Kortix với ngân sách và quy tắc truy cập.
- **Quản trị nhóm:** vai trò, nhóm, quyền theo từng tài nguyên, nhật ký kiểm toán, SAML 2.0 SSO và SCIM 2.0. Agent mặc định không được tự merge.

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

Tuỳ cách dùng, bạn cần chuẩn bị khác nhau. README chỉ nói những điều sau:

- **Dùng bản đám mây:** chỉ cần đăng ký tài khoản trên trang của dự án, tạo project và bắt đầu một phiên. Không cần cài gì.
- **Dùng CLI `kortix`:** chạy được lệnh `curl` và `bash` để cài (README dùng đúng hai công cụ này). Gói npm của CLI tên là `kortix`.
- **Tự host:** một stack Docker Compose trên tài khoản đám mây, VPC hoặc máy chủ của bạn. Stack kéo image từ Docker Hub, nên máy cần ra được Internet. README nói đây là bản tự host chứ không phải bản chạy hoàn toàn offline.
- **Mô hình AI:** lần chạy đầu của tự host không đòi key mô hình. Bạn kết nối GitHub và thêm key mô hình trong ứng dụng sau đó. Sandbox của agent chạy trên nhà cung cấp bạn cấu hình (mặc định là Platinum).
- **Muốn đóng góp code:** README dùng `pnpm`. Phiên bản Node, hệ điều hành cụ thể và yêu cầu phần cứng: README chưa ghi, bạn xem thêm CONTRIBUTING.md trong repo.

README cũng chưa nói rõ CLI có chạy trực tiếp trên Windows hay không. Nếu bạn dùng Windows, hãy xem hướng dẫn tự host của dự án hoặc thử trong môi trường có bash (ví dụ WSL) và đọc kỹ thông báo khi cài.

```note
Key mô hình và quyền truy cập GitHub là thứ nhạy cảm. Chỉ nhập vào ứng dụng của chính bạn, đừng dán vào chat hay commit vào repo. Chạy agent trên đám mây cũng có thể phát sinh chi phí mô hình và máy tính, nên đặt ngân sách trước khi cho chạy tự động.
```

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

```steps
- Cài CLI | Chạy lệnh cài `kortix` bằng curl
- Tạo dự án | `kortix init` sinh kortix.yaml cùng agent, skill
- Đưa lên mây | `kortix ship` đẩy repo và chạy thật
- (Tuỳ chọn) Tự host | `kortix self-host start` dựng stack Docker Compose
- Thử phiên đầu tiên | Tạo phiên bằng `kortix sessions new`
```

### Cài CLI kortix

Mở terminal (macOS, Linux hoặc môi trường có bash) rồi chạy lệnh dưới. Lệnh tải script cài từ trang của dự án và chạy ngay. Nếu bạn muốn xem script trước khi chạy thì mở địa chỉ đó trên trình duyệt đọc trước, đó là thói quen tốt với mọi lệnh `curl | bash`.

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

### Tạo khung dự án

Đứng trong thư mục bạn muốn làm việc rồi chạy lệnh sau. README mô tả nó tạo `kortix.yaml` cùng các agent, kỹ năng và cấu hình runtime. `kortix.yaml` là file khai báo toàn bộ công ty của bạn.

```bash
kortix init
```

### Đưa lên đám mây

Lệnh này đẩy repo và đưa toàn bộ hệ thống chạy trên đám mây. Người mới hay vấp ở chỗ chưa có tài khoản: nếu lệnh yêu cầu đăng nhập, hãy đăng ký trên trang của dự án trước.

```bash
kortix ship
```

### Hoặc tự host trên máy của bạn

Nếu muốn dữ liệu nằm trong hạ tầng của mình, dùng nhánh tự host. Lệnh đầu cài CLI, lệnh hai khởi động stack Docker Compose, lệnh ba chuyển CLI sang dùng bản tự host (đổi ngược lại là `cloud`). README ghi lần chạy đầu sẽ hỏi sáu câu và chưa cần key mô hình.

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

Hãy bật Docker trước khi chạy `kortix self-host start`. Nếu không, stack sẽ không dựng được. Hướng dẫn chi tiết nằm ở trang tài liệu tự host của dự án.

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

Sau khi đã đưa lên, bạn có thể giao việc ngay bằng dòng lệnh. Câu lệnh mẫu trong README là tóm tắt các commit trong tuần và mở một change request.

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

### (Dành cho lập trình viên) Chạy bản phát triển từ mã nguồn

Chỉ cần khi bạn muốn sửa chính Kortix. Clone repo, rồi chạy các lệnh trong phần Contributing của README. Bạn cần có `pnpm` trước.

```bash
git clone https://github.com/kortix-ai/CompanyOS.git
cd CompanyOS
pnpm install
pnpm dev            # web + API (scripts/dev-local.sh)
pnpm dev:web        # web app only
pnpm dev:api        # API only
pnpm dev:sandbox    # build the local sandbox image
pnpm build          # build all packages
pnpm nuke           # tear down the local Docker environment
```

Lưu ý `pnpm nuke` dọn môi trường Docker cục bộ, nên đừng chạy nếu bạn đang có dữ liệu thử nghiệm cần giữ.

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

README không mô tả sẵn đầu ra mong đợi cho từng lệnh, nên bạn kiểm tra theo các dấu hiệu thực tế sau:

- Chạy `kortix` trong terminal mới: nếu lệnh được nhận diện (không báo "command not found") thì CLI đã cài.
- Sau `kortix init`, trong thư mục có file `kortix.yaml` và các thư mục agent, kỹ năng.
- Sau `kortix ship`, đăng nhập trang của dự án, vào project và thấy phiên làm việc của bạn.
- Chạy `kortix cr ls`: lệnh này liệt kê các thay đổi mà agent đề xuất. Nếu phiên mẫu ở trên đã xong, bạn sẽ thấy một change request chờ duyệt.
- Với tự host: mở ứng dụng web do stack dựng lên và kết nối GitHub cùng key mô hình trong đó. Nếu vào được màn hình này là stack đã chạy.

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

### Dev nhỏ: tóm tắt commit mỗi tuần

Bạn là lập trình viên trong nhóm ba người và cuối tuần nào cũng phải viết báo cáo tiến độ. Bạn tạo phiên bằng đúng lệnh mẫu của README. Agent đọc các commit trong tuần, viết tóm tắt và mở một change request. Bạn xem bằng `kortix cr ls`, đọc nội dung rồi merge nếu ổn.

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

Kết quả: bạn chỉ còn việc duyệt, còn phần đọc và gom nội dung do agent làm.

> Agent làm việc, người thật bấm duyệt. Máy móc không được tự ý đưa gì vào main.
>
> — Ông T

### Chủ shop: trợ lý chạy theo lịch

Bạn bán hàng online và muốn mỗi sáng có bản tổng hợp đơn hàng, câu hỏi khách và việc cần xử lý. Cách làm theo mô tả của README: kết nối công cụ bạn đang dùng qua connector, đặt một trigger theo lịch và nêu mục tiêu bằng lời thường. Agent tự thức dậy theo lịch, làm việc rồi báo kết quả, bạn trò chuyện với My Kortix từ web hoặc Slack. README không đưa sẵn prompt cho tình huống này, nên bạn viết mục tiêu bằng tiếng thường và chỉnh dần.

Kết quả: một việc lặp lại mỗi ngày không còn phụ thuộc vào việc bạn nhớ để hỏi.

### Nhân viên văn phòng: bộ nhớ chung cho cả phòng

Phòng nội dung hay phải nhắc lại cùng một quy tắc: giọng văn, danh sách từ cấm, mẫu báo giá. Với CompanyOS, bạn đặt các quy tắc này làm kỹ năng (skill) và bộ nhớ công ty trong Drive dưới dạng Markdown. Mọi thành viên làm việc với cùng agent và cùng ngữ cảnh, qua web, Slack hoặc Microsoft Teams. Quyền theo vai trò quyết định ai được sửa gì.

Kết quả: người mới vào không phải hỏi lại những điều cả phòng đã thống nhất.

### Nhóm kỹ thuật: tự host để giữ dữ liệu

Công ty bạn có yêu cầu giữ dữ liệu trong hạ tầng riêng. Bạn chạy `kortix self-host start` trên máy chủ hoặc VPC, dùng `kortix hosts use selfhost` để CLI trỏ vào đó, rồi thêm key mô hình của chính bạn trong ứng dụng. Cần chuyển lại bản đám mây thì dùng `kortix hosts use cloud`.

Kết quả: cùng một cách làm việc, nhưng dữ liệu và key nằm trong phạm vi bạn kiểm soát.

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

- **`kortix: command not found` sau khi cài.** Thường do terminal cũ chưa nạp lại đường dẫn. Hãy đóng và mở terminal 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 cuối cùng của script.
- **`kortix self-host start` không dựng được.** Rất hay do Docker chưa bật hoặc máy không ra được Internet (stack kéo image từ Docker Hub). Bật Docker, kiểm tra mạng rồi chạy lại. Xem thêm hướng dẫn tự host của dự án.
- **Agent không làm được gì vì thiếu mô hình.** Lần chạy đầu của tự host không hỏi key mô hình. Bạn phải vào ứng dụng, kết nối GitHub và thêm key sau đó.
- **Thay đổi của agent không thấy trong main.** Đây là chủ ý: agent mặc định không được tự merge. Dùng `kortix cr ls` để xem change request đang chờ rồi duyệt.
- **`pnpm dev` báo lỗi khi chạy từ mã nguồn.** Kiểm tra đã chạy `pnpm install` và đã bật Docker chưa. Phiên bản Node cụ thể README chưa ghi, nên xem CONTRIBUTING.md trong repo.

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

**Điểm mạnh.** Cách làm "công ty như code" rất rõ ràng: agent, kỹ năng và quy tắc đều là file trong git, xem lại và sửa được như phần mềm. Có sẵn lịch, webhook, quản lý quyền, nhật ký kiểm toán và bước duyệt của con người. README ghi bản đã được xác minh SOC 2 Type I. Bạn chọn được đám mây, VPC hoặc on-prem, và dùng mô hình tuỳ ý.

**Giới hạn.** Hệ thống khá lớn, gồm nhiều lớp (agent, trigger, connector, Drive, ứng dụng). Với người mới thì cần thời gian làm quen, nên hãy đọc phần Guide trên trang dự án. Tự host đòi hỏi kiến thức Docker và hạ tầng, và vẫn cần kết nối Internet. Giấy phép: README chưa ghi rõ loại giấy phép, bạn xem file LICENSE và WHITE-LABEL-LICENSE.md trong repo trước khi dùng thương mại hoặc bán lại. Chi phí cụ thể của bản đám mây và mô hình README chưa nêu.

**Khi nào nên chọn cách khác.** Nếu bạn chỉ cần một trợ lý chat cá nhân hoặc chạy vài tác vụ đơn giản trên máy, một công cụ agent nhỏ hơn sẽ nhẹ và dễ hơn. Còn nếu bạn muốn nhiều agent chung bộ nhớ, chạy theo sự kiện, có phân quyền và duyệt thay đổi cho cả đội, thì đây là một lựa chọn đáng thử, bắt đầu bằng bản đám mây để xem hợp hay không rồi mới tính chuyện tự host.

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

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

Mã nguồn mở và bạn có thể tự host. README cũng có bản đám mây để đăng ký dùng, nhưng chưa nêu giá cụ thể. Chi phí mô hình phụ thuộc vào cách bạn kết nối (key riêng, gói thuê bao hoặc mô hình do Kortix quản lý). Bạn nên xem trang của dự án để biết mức phí hiện hành.

### Cài đặt có khó không?

Cài CLI chỉ là một dòng lệnh `curl`, rồi `kortix init` và `kortix ship` để đưa lên đám mây. Tự host cần Docker và quen với hạ tầng hơn. Nếu không muốn cài gì, bạn có thể đăng ký bản đám mây và bắt đầu một phiên.

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

README không nhắc đến yêu cầu GPU. Agent chạy trên máy tính đám mây riêng của từng phiên, và bạn dùng mô hình qua nhà cung cấp hoặc key của mình. Yêu cầu phần cứng cho tự host README chưa ghi, nên bạn xem tài liệu tự host.

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

README chưa nói rõ về Windows. Lệnh cài dùng `curl` và `bash`, nên với Windows bạn có thể thử qua môi trường có bash như WSL, hoặc dùng bản đám mây qua trình duyệt. Hãy kiểm tra lại trong tài liệu của dự án.

### Dữ liệu và key có an toàn không?

README nêu các biện pháp: mỗi phiên một máy cô lập, quyền theo từng tài nguyên, nhật ký kiểm toán, thông tin đăng nhập connector giữ ở máy chủ, bí mật mã hoá với một khoá cho mỗi project, và agent mặc định không được tự merge. Có thể tự host trong VPC hoặc on-prem. README cũng ghi bản đã được xác minh SOC 2 Type I.

### Dùng được mô hình AI nào?

README nói dùng được mô hình do Kortix quản lý, key nhà cung cấp của bạn, gói thuê bao ChatGPT hoặc Claude. Mọi yêu cầu đi qua cổng LLM của Kortix với ngân sách và quy tắc truy cập. Danh sách mô hình cụ thể README chưa liệt kê.

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

Theo README, một agent thông thường là một phiên chat trên một máy và phải chờ người gõ. CompanyOS cho agent chạy theo sự kiện, song song, mỗi phiên một máy riêng, có chung bộ nhớ công ty và có bước duyệt của con người trước khi thay đổi vào main. Đây là hướng dành cho nhóm và công ty hơn là cho một người dùng lẻ.
