# MonkeyCode (百智办公 MonkeyAI): AI làm việc nhóm, tự host — hướng dẫn cài đặt và dùng

> MonkeyCode (tên sản phẩm hiện nay là 百智办公 · MonkeyAI) là bàn làm việc AI mã nguồn mở dành cho nhóm. Bạn mô tả việc bằng tiếng thường, AI làm PPT, tài liệu, bảng tính, code hoặc thiết kế. Cài máy chủ riêng chỉ cần một lệnh, nhưng giao diện và tài liệu chính là tiếng Trung.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-11-07 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/monkeycode-ai-lam-viec-nhom-tu-host-huong-dan-cai-dat

MonkeyCode là một bàn làm việc AI dành cho cả nhóm, mã nguồn mở, có thể tự cài trên máy chủ của bạn. Sản phẩm hiện mang tên 百智办公 · MonkeyAI (Bách Trí Văn Phòng). Bạn đưa tài liệu, nói rõ mục tiêu và kiểu kết quả muốn nhận, AI sẽ làm và giao lại thành phẩm. Repo hiện có khoảng 5.194 sao và 779 fork.

Repo giải quyết hai chuyện cùng lúc. Một là việc hằng ngày: làm slide báo cáo, soạn tài liệu, xử lý bảng, viết code, làm poster. Hai là chuyện quản lý: một công ty nhỏ muốn cả nhóm dùng chung mô hình AI, chung kho tri thức, có phân quyền, có thống kê ai dùng bao nhiêu, thay vì mỗi người tự xoay tài khoản riêng.

Hợp nhất với chủ doanh nghiệp nhỏ, trưởng nhóm, bộ phận IT muốn dựng "AI nội bộ" cho team. Điểm đáng giá nhất là dữ liệu nhóm nằm trên máy chủ của bạn, cấu hình tối thiểu chỉ 1 nhân CPU và 1 GB RAM. Lưu ý trước: tên repo là MonkeyCode nhưng tài liệu và giao diện chủ yếu bằng tiếng Trung.

```repo
- repo | chaitin/MonkeyCode
- kind | Ứng dụng
- desc | MonkeyCode (百智办公) là bàn làm việc AI mã nguồn mở cho nhóm: làm PPT, tài liệu, code, thiết kế, có quản lý quyền và tự cài trên máy chủ riêng.
- stars | 5.2k
- lang | TypeScript
- license | AGPL-3.0
```

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

Theo README, một bàn làm việc phủ ba kiểu việc.

- **Văn phòng**: làm PPT, viết tài liệu, xử lý bảng, sắp xếp tệp. Ví dụ README đưa ra là "gom các tài liệu này thành slide báo cáo và tổng hợp số liệu chính từ bảng". Lợi ích: bạn đi từ đống tư liệu rời rạc tới một bản hoàn chỉnh mà không phải dựng từ đầu.
- **Lập trình**: từ thiết kế kiến trúc, viết code đến sửa lỗi. Ví dụ: "làm tính năng theo yêu cầu này, bổ sung test và sửa các lỗi phát sinh khi chạy". Lập trình viên giữ phần quyết định kỹ thuật, phần việc lặp để AI làm.
- **Thiết kế**: poster, thiết kế đồ họa, thiết kế giao diện, thậm chí làm phim ngắn. Ví dụ: làm poster theo chủ đề sự kiện kèm thiết kế trang đi cùng.

Phần khác biệt so với một khung chat AI thông thường là **bảng quản trị cho doanh nghiệp**:

- **Chia sẻ tài nguyên trong nhóm**: mô hình lớn, kho tri thức, kỹ năng (skill), chuyên gia, kết nối MCP và quy tắc. Một người cấu hình, cả nhóm dùng lại.
- **Theo dõi sử dụng và tính phí**: biết tài nguyên được dùng thế nào, quản lý chi phí theo mức dùng.
- **Phân quyền và kiểm toán**: kiểm soát ai được dùng gì, ghi lại để rà soát sau.
- **Thống kê của nhóm**: số liệu giúp bạn quyết định cấu hình tài nguyên hợp lý.

Nhóm có thể nối mô hình của riêng mình, nối công cụ nghiệp vụ qua MCP, rồi kết hợp kho tri thức, skill, chuyên gia và quy tắc cho hợp quy trình. Ngoài ra có máy khách cho Windows, macOS, Linux và bản Web, kết nối cùng một nhóm.

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

Tư liệu README nói rõ những điều sau, mình không thêm gì ngoài đó.

- **Để thử nhanh (không cài máy chủ)**: một máy Windows x64, macOS (Apple Silicon hoặc Intel) hoặc Linux x64 để cài ứng dụng máy khách, hoặc chỉ cần trình duyệt để mở bản Web demo. Cần một email nhận được mã xác thực.
- **Để tự dựng máy chủ**: một máy chủ riêng. Cấu hình nhẹ theo README là 1 nhân CPU và 1 GB RAM; thực tế tăng theo số người, dung lượng lưu trữ và khối lượng việc. Lệnh cài là lệnh bash, cần có `bash` và `curl`.
- **Mô hình AI**: nhóm tự cấu hình dịch vụ mô hình của mình. Cách cấu hình nằm trong tài liệu sản phẩm; README không liệt kê loại key cụ thể nào, nên bạn xem tài liệu để biết.
- **Gói dùng**: bản miễn phí có tối đa 10 chỗ ngồi (seat), không có máy tính đám mây, không hỗ trợ kỹ thuật. Bản trả phí cần liên hệ tư vấn.
- Android, iOS, Linux ARM64 và máy tính HarmonyOS: README ghi "sắp có", tức là chưa dùng được.

```note
Khi nhóm dùng mô hình hay công cụ bên ngoài, nội dung công việc vẫn được gửi tới dịch vụ bạn cấu hình. Tự host chỉ giữ dữ liệu của nhóm trên máy chủ mình, không có nghĩa mọi thứ không rời khỏi máy. Hãy chọn nhà cung cấp mô hình phù hợp với mức nhạy cảm của dữ liệu.
```

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

Có hai đường: thử trên máy chủ demo có sẵn (không cài gì phía máy chủ), hoặc tự dựng máy chủ riêng. Mình khuyên bạn thử demo trước.

```steps
- Tải máy khách | Tải bản cài đặt cho hệ điều hành của bạn từ trang chủ dự án
- Nhập địa chỉ máy chủ | Điền địa chỉ demo của dự án để thử
- Đăng nhập | Nhận mã xác thực qua email rồi vào
- Xem trang quản trị demo | Mở bảng quản trị để xem quyền, thống kê, tính phí
- Tự dựng máy chủ | Chạy một lệnh cài trên máy chủ của bạn
```

### Tải máy khách

README cung cấp bản cài cho Windows x64 (tệp .exe), macOS Apple Silicon và macOS Intel (tệp .dmg), Linux x64 (tệp AppImage). Đường tải nằm ở mục tải máy khách trên trang chủ dự án https://work.baizhi.cloud/ (kéo xuống phần máy khách). Nếu không muốn cài gì, bạn có thể dùng bản Web ở địa chỉ demo bên dưới.

Chỗ người mới hay vấp: chọn đúng bản. Máy Mac đời mới chip M là "Apple Silicon", máy Mac đời cũ chip Intel là "Intel".

### Nhập địa chỉ máy chủ demo

Mở ứng dụng, khi được hỏi địa chỉ máy chủ thì điền:

```text
https://demo.work.baizhi.cloud/
```

Đây là máy chủ demo của dự án, chỉ nên dùng để làm quen. Đừng đưa tài liệu thật của công ty lên đó.

### Đăng nhập bằng mã xác thực qua email

Nhập email của bạn, hệ thống gửi mã xác thực, bạn nhập mã là vào được. Nếu chưa thấy thư, kiểm tra cả thư mục spam.

### Xem trang quản trị demo

Mở trang quản trị demo để xem phần tài nguyên nhóm, quyền hạn, thống kê sử dụng và tính phí. README cung cấp tài khoản demo công khai:

```text
Địa chỉ: https://admin.demo.work.baizhi.cloud/
Tài khoản: admin@baizhi.cloud
Mật khẩu: work.baizhi.cloud
```

Trang này giúp bạn hình dung phía quản trị trước khi quyết định tự dựng.

### Tự dựng máy chủ riêng

Đây là lệnh cài một dòng trong README. Bạn chạy nó trong terminal của chính máy chủ (đăng nhập SSH vào máy chủ rồi dán lệnh), không chạy trên máy cá nhân Windows của bạn:

```bash
bash -c "$(curl -kfsSL https://release.monkeycode-ai.com/public/monkeyai-install.sh)"
```

Lệnh này tải một tập lệnh cài đặt từ địa chỉ của dự án rồi chạy ngay. Vì vậy hãy chạy trên máy chủ bạn sẵn sàng dùng riêng cho việc này, và nên đọc nội dung tập lệnh trước nếu bạn cẩn thận. Cờ `-k` trong lệnh nghĩa là bỏ qua kiểm tra chứng chỉ, mình nêu để bạn biết, README viết đúng như vậy.

README còn nhắc cách khác: khởi động bằng Docker Compose từ mã nguồn, cấu hình proxy và chứng chỉ, sao lưu, nâng cấp. Phần này README không ghi lệnh cụ thể, bạn xem trong tài liệu triển khai sản phẩm (trang tài liệu dự án) và các hướng dẫn triển khai trong thư mục `docs/` của repo. README cũng chưa ghi hệ điều hành máy chủ được hỗ trợ, nên hãy đọc tài liệu trước khi cài.

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

Với bản demo: bạn đăng nhập được bằng mã email và thấy giao diện làm việc là xong. Hãy gõ thử một yêu cầu đơn giản và xem AI có phản hồi không.

Với máy chủ tự dựng: README không mô tả đầu ra của tập lệnh cài, nên mình không đoán trước màn hình mong đợi. Cách kiểm tra hợp lý là mở máy khách (hoặc bản Web), điền địa chỉ máy chủ của bạn thay cho địa chỉ demo, rồi đăng nhập. Cách vào trang quản trị riêng và tài khoản quản trị đầu tiên được nêu trong tài liệu triển khai, bạn xem ở đó. Nếu vào được trang quản trị và thấy các mục tài nguyên, quyền, thống kê thì máy chủ đã chạy.

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

Mình bám đúng các ví dụ và khả năng README đã nêu. Dưới đây là cách áp dụng cho người Việt.

### Chủ shop cần slide báo cáo cuối tháng

Bạn có vài file doanh số và ghi chú rời. Đưa các file vào, rồi gõ yêu cầu mẫu theo đúng tinh thần README:

```text
Hãy gom các tài liệu này thành slide báo cáo và tổng hợp số liệu chính từ bảng.
```

Kết quả mong đợi: một bản slide có cấu trúc và phần số liệu tóm tắt. Bạn vẫn nên đọc lại và chỉnh các con số quan trọng trước khi gửi đi.

> Dùng AI để làm việc văn phòng không khó, cái khó là cả nhóm dùng chung một cách, có quyền hạn rõ ràng.
>
> — Ông T

### Nhân viên văn phòng phân tích một bảng dữ liệu

Kế toán hoặc hành chính có một bảng dài và cần nhanh chóng biết điểm chính. README ghi người không biết lập trình cũng dùng được: đưa file, nói mục tiêu và yêu cầu đầu ra, chẳng hạn "phân tích bảng này và liệt kê các điểm bất thường". Kết quả là phần nhận xét tổng hợp để bạn đối chiếu lại với số gốc.

### Lập trình viên giao việc cho AI

Bạn có một yêu cầu tính năng bằng văn bản. Dùng mẫu của README:

```text
Làm tính năng theo yêu cầu này, bổ sung test và sửa các lỗi phát sinh khi chạy.
```

Kết quả: AI tham gia từ viết code tới sửa lỗi, bạn tập trung vào phần quyết định kỹ thuật và duyệt code. Đây là kiểu việc mà repo ban đầu (MonkeyCode) vốn nhắm tới.

### Trưởng nhóm dựng AI chung cho cả team

Bạn tự dựng máy chủ, nối mô hình của công ty, thêm kho tri thức nội bộ và quy tắc làm việc, rồi cấp quyền cho từng thành viên (miễn phí tối đa 10 chỗ). Kết quả: mọi người dùng chung một nguồn tài nguyên, bạn xem được thống kê sử dụng và log truy cập thay vì mỗi người một tài khoản riêng lẻ.

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

**Không nhận được mã xác thực qua email.** Kiểm tra thư mục spam, đúng địa chỉ email, thử gửi lại sau một lúc. Với máy chủ tự dựng, mã được gửi qua cấu hình email của bạn, xem tài liệu triển khai.

**Lệnh cài một dòng báo lỗi hoặc dừng giữa chừng.** Thường do máy chủ không ra được Internet, thiếu `curl`, hoặc không đủ quyền. Kiểm tra mạng và quyền, rồi chạy lại. README không ghi từng mã lỗi, nên nếu vẫn kẹt, xem tài liệu triển khai hoặc mở issue trên GitHub của dự án.

**Mở trang quản trị demo không được hoặc đăng nhập sai.** Gõ lại đúng tài khoản và mật khẩu demo, đúng chữ hoa chữ thường. Đây là tài khoản công khai nên có thể có người khác cùng dùng, đừng lưu gì quan trọng ở đó.

**AI không trả lời hoặc báo lỗi khi tự dựng máy chủ.** Thường do chưa cấu hình dịch vụ mô hình hoặc khoá chưa đúng. Cấu hình mô hình thực hiện ở phía quản trị, xem tài liệu sản phẩm. Đừng dán khoá mô hình vào chỗ người khác nhìn thấy.

**Khó đọc vì giao diện và tài liệu bằng tiếng Trung.** Dùng tính năng dịch của trình duyệt cho tài liệu. Với giao diện ứng dụng, README không nói có bản tiếng Việt hay không, nên bạn nên thử bản demo xem có chịu được không trước khi triển khai cho cả nhóm.

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

Điểm mạnh:

- Mã nguồn mở, tự cài trên máy chủ nhẹ, dữ liệu nhóm do bạn nắm.
- Có sẵn phần quản trị: chia sẻ tài nguyên, phân quyền, kiểm toán, thống kê, tính phí.
- Nối được mô hình riêng và công cụ qua MCP; bản Web và máy khách chạy được trên nhiều hệ điều hành.
- Bản miễn phí đủ để một nhóm nhỏ (tối đa 10 chỗ) thử nghiệm.

Giới hạn cần biết:

- Giao diện và tài liệu chủ yếu tiếng Trung, người Việt sẽ cần dịch.
- Giấy phép AGPL-3.0: bạn được xem, sửa, làm bản riêng, nhưng việc dùng, sửa và phân phối phải tuân thủ giấy phép này. Nếu định đưa vào sản phẩm thương mại, hãy đọc kỹ.
- Bản miễn phí không có máy tính đám mây và không có hỗ trợ kỹ thuật; muốn có thì phải liên hệ gói trả phí.
- Bản Android, iOS và Linux ARM64 chưa có.
- Dùng mô hình bên ngoài thì nội dung vẫn đi ra ngoài.

Nếu bạn chỉ là một người dùng cá nhân cần chat AI vài việc, một công cụ chat thông thường có thể đơn giản hơn. Nếu bạn là nhóm vài người đến vài chục người, cần quản lý quyền và dữ liệu, thì đây là thứ đáng thử bằng bản demo trước khi tự cài.

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

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

Mã nguồn mở theo giấy phép AGPL-3.0. Theo README có bản miễn phí với tối đa 10 chỗ, giá 0 đồng, còn bản trả phí cần liên hệ để biết giá. Chi phí gọi mô hình AI bên ngoài (nếu có) README không nói rõ.

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

README chỉ nêu cấu hình nhẹ cho máy chủ là 1 nhân CPU và 1 GB RAM, có thể tăng theo quy mô nhóm. Không thấy nhắc yêu cầu GPU; việc chạy mô hình tuỳ vào dịch vụ mô hình bạn cấu hình.

### Dùng được trên Windows không?

Được. Có bản cài máy khách cho Windows x64, cùng macOS (Apple Silicon và Intel) và Linux x64, ngoài ra còn bản Web. Lệnh cài máy chủ là lệnh bash; README chưa ghi rõ hệ điều hành máy chủ được hỗ trợ.

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

Khi tự cài máy chủ, dữ liệu của nhóm nằm trên máy chủ của bạn và bạn tự quyết quyền truy cập, sao lưu. Tuy nhiên nếu dùng mô hình hay công cụ bên ngoài thì nội dung liên quan vẫn gửi tới dịch vụ đó, và bản demo không nên dùng cho dữ liệu thật.

### Không biết lập trình có dùng được không?

README khẳng định được. Công việc văn phòng và sáng tạo có thể mô tả bằng ngôn ngữ thường, đưa kèm tệp, nêu mục tiêu và yêu cầu đầu ra. Phần tự dựng máy chủ thì cần biết dùng terminal ở mức cơ bản.

### Có sửa mã nguồn hoặc phát triển thêm được không?

Được. README cho phép xem, sửa và phát triển thêm, miễn là tuân thủ giấy phép AGPL-3.0. Trong repo có các thư mục như backend, frontend, desktop, browser-extension, plugins.

### Có tiếng Việt không?

Chưa có thông tin trong tư liệu. README và tài liệu viết bằng tiếng Trung, bạn nên thử bản demo để xem giao diện thực tế.
