MonkeyCode: AI văn phòng cho cả nhóm, tự dựng server riêng — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về chaitin/MonkeyCode — 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: MonkeyCode: AI làm PPT, tài liệu, code cho cả team, tự host — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
MonkeyCode là một bàn làm việc AI mã nguồn mở dành cho nhóm, hiện mang tên 百智办公 · MonkeyAI. Bạn nói yêu cầu bằng tiếng thường, AI làm PPT, tài liệu, bảng tính, code hay thiết kế, còn quản trị viên quản lý quyền và mức dùng. Cài server chỉ một dòng lệnh, và bạn có thể thử ngay trên bản demo mà không cần cài gì.
MonkeyCode là một bàn làm việc AI mã nguồn mở dành cho cả nhóm. Hiện README của repo giới thiệu nó dưới tên 百智办公 · MonkeyAI, mô tả là "nền tảng quản lý văn phòng AI mã nguồn mở cấp doanh nghiệp". Bạn nhắn yêu cầu bằng ngôn ngữ thường, AI sẽ làm việc văn phòng, lập trình hoặc thiết kế rồi giao kết quả cho bạn.
Vấn đề repo muốn giải quyết khá quen thuộc. Mỗi người trong nhóm tự dùng một công cụ AI riêng, tự trả tiền, tự giữ key. Sếp không biết ai dùng bao nhiêu, dữ liệu nằm ở đâu cũng không rõ. MonkeyCode gom mọi thứ về một chỗ: cả nhóm dùng chung mô hình, kho tri thức, kỹ năng và quy tắc, còn quản trị viên xem được thống kê, phân quyền và ghi nhận lịch sử dùng.
Người nên xem là chủ doanh nghiệp nhỏ, trưởng nhóm, bộ phận IT muốn có "AI nội bộ" và dev muốn tự dựng hệ thống trên server của mình. Điểm đáng giá nhất là bạn có thể tự cài trên máy chủ riêng chỉ với một dòng lệnh, cấu hình nhẹ (1 nhân CPU, 1 GB RAM), và có sẵn bản demo để thử trước khi quyết định. Hiện repo có khoảng 5.194 sao và 779 fork, và vẫn đang được cập nhật.
chaitin/MonkeyCode
MonkeyCode (百智办公 MonkeyAI) là bàn làm việc AI mã nguồn mở cho nhóm: làm PPT, viết code, thiết kế, quản lý quyền và tự dựng server riêng.
I.MonkeyCode làm được gì
Công cụ chia việc thành ba nhóm chính. Cả ba đều dùng cách làm giống nhau: bạn đưa tài liệu, nói rõ mục tiêu và yêu cầu đầu ra.
A.Làm việc văn phòng
AI có thể làm PPT, viết tài liệu, xử lý bảng tính và sắp xếp file. Lợi ích thực tế là bạn không cần bắt đầu từ trang trắng. Bạn gom đống tài liệu rời rạc, AI gom thành một bản báo cáo gọn. Ví dụ trong README: "Hãy sắp xếp các tài liệu này thành PPT báo cáo, và tổng hợp số liệu quan trọng trong bảng".
B.Lập trình
AI tham gia từ thiết kế kiến trúc, viết code đến sửa lỗi. Ví dụ README đưa ra là: làm tính năng theo bản yêu cầu này, bổ sung test và sửa các lỗi phát sinh khi chạy. Với dev, việc lặt vặt được giao đi, bạn giữ lại phần quyết định kỹ thuật.
C.Thiết kế
AI làm áp phích, thiết kế đồ họa, thiết kế giao diện tương tác và cả sản xuất phim ngắn. Ví dụ trong README: làm áp phích theo chủ đề sự kiện kèm thiết kế trang đi cùng.
D.Quản lý cho cả nhóm
Đây là phần làm nó khác một app chat AI thông thường. Bảng quản trị doanh nghiệp cho phép:
- Chia sẻ tài nguyên trong nhóm: mô hình lớn, kho tri thức, kỹ năng, "chuyên gia", MCP connector và quy tắc. Người mới vào nhóm dùng lại ngay, không phải tự cấu hình.
- Theo dõi mức dùng và tính phí: biết tài nguyên nào được dùng nhiều, quản lý chi phí.
- Kiểm soát quyền và kiểm toán: quyết định ai được dùng gì, và ghi lại việc sử dụng.
- Thống kê của nhóm: có số liệu để cân nhắc nên cấu hình tài nguyên thế nào.
Nhóm cũng có thể nối mô hình của riêng mình, nối công cụ nghiệp vụ qua MCP connector, rồi kết hợp với kho tri thức, kỹ năng, chuyên gia và quy tắc cho hợp quy trình làm việc.
II.Cần chuẩn bị gì
Tư liệu của repo chỉ nêu những điều sau, mình không thêm gì ngoài đó:
- Để chỉ dùng thử: một trong các nền tảng có client là Web, Windows x64, macOS Apple Silicon, macOS Intel hoặc Linux x64 (AppImage). Android, iOS, Linux ARM64 và máy tính HarmonyOS ghi là "sắp có".
- Để tự dựng server: một máy chủ, cấu hình nhẹ nhất là 1 nhân CPU và 1 GB RAM. README nói cấu hình thực tế tuỳ quy mô nhóm, dung lượng lưu trữ và khối lượng tác vụ. Bạn cũng cần quyền chạy lệnh
bashvàcurltrên máy đó. - Mô hình AI: nhóm tự cấu hình dịch vụ mô hình của mình. README không nêu cụ thể nhà cung cấp hay key nào, nên bạn xem hướng dẫn trong tài liệu sản phẩm.
- Tài khoản: đăng nhập client bằng email và nhận mã xác thực qua email (theo phần trải nghiệm demo).
- GPU: README không nhắc đến yêu cầu GPU.
Phần lớn tài liệu gốc viết bằng tiếng Trung. Nếu bạn không đọc được, hãy dùng trình dịch của trình duyệt khi xem trang tài liệu.
III.Cài đặt từng bước
Bạn có hai cách: dùng thử ngay trên server demo của tác giả, hoặc dựng server riêng.
- Thử demoTải client hoặc mở bản Web, nhập địa chỉ server demo
- Xem trang quản trịMở trang admin demo để xem phân quyền, thống kê
- Chuẩn bị máy chủMột máy chủ tối thiểu 1 nhân CPU, 1 GB RAM
- Chạy lệnh càiDán một dòng lệnh trong README vào terminal
- Cấu hìnhLàm theo tài liệu sản phẩm để thêm mô hình và công cụ
A.Thử bản demo trước (không cần cài server)
Tải client đúng với máy của bạn từ trang chủ dự án, hoặc mở bản Web của server demo. Trong README, các liên kết tải gồm file .exe cho Windows x64, file .dmg cho macOS (Apple Silicon và Intel) và AppImage cho Linux x64. Bạn có thể tìm chúng ở mục tải client trên trang chủ.
Khi client yêu cầu địa chỉ máy chủ, nhập:
https://demo.work.baizhi.cloud/Sau đó nhập email và lấy mã xác thực gửi về hộp thư để đăng nhập. Lưu ý: đây là server dùng chung do tác giả cung cấp để trải nghiệm. Đừng đưa tài liệu thật hay thông tin nhạy cảm lên đó.
B.Xem trang quản trị demo
Mở trang quản trị demo của dự án để xem cách quản lý tài nguyên, quyền, thống kê và tính phí. README cung cấp tài khoản demo công khai:
Tài khoản: admin@baizhi.cloud
Mật khẩu: work.baizhi.cloudĐây là tài khoản chung cho mục đích xem thử. Bạn chỉ nên xem, không nhập dữ liệu thật vào.
C.Chuẩn bị máy chủ
Bạn cần một máy chủ Linux hoặc môi trường có terminal chạy được bash và curl. Bạn mở terminal trên chính máy chủ đó (thường là kết nối qua SSH), không phải trên máy tính cá nhân. README ghi cấu hình nhẹ là 1 nhân CPU, 1 GB RAM. Nếu nhóm đông hoặc tác vụ nặng, hãy dự phòng nhiều hơn.
D.Chạy lệnh cài đặt
README đưa đúng một lệnh để dựng máy chủ cho nhóm:
bash -c "$(curl -kfsSL https://release.monkeycode-ai.com/public/monkeyai-install.sh)"Lệnh này dùng curl tải một script cài đặt từ địa chỉ của tác giả, rồi bash chạy script đó ngay. Mình lưu ý hai điều. Thứ nhất, cờ -k của curl bỏ qua việc kiểm tra chứng chỉ HTTPS, nên kém an toàn hơn bình thường. Thứ hai, script chạy thẳng trên máy bạn nên nên đọc nội dung trước nếu có thể. Bạn có thể mở địa chỉ script bằng trình duyệt để xem trước khi chạy.
Chỉ chạy lệnh cài trên máy chủ bạn kiểm soát và đã sao lưu. Tốt nhất đừng thử trên máy đang chạy dịch vụ quan trọng. Nếu bạn cấu hình mô hình bên ngoài, nội dung gửi đến mô hình vẫn đi ra khỏi server của bạn đến dịch vụ đó.
E.Cấu hình sau khi cài
README chưa ghi chi tiết các bước sau khi script chạy xong, và chỉ nói bạn xem hướng dẫn trong tài liệu sản phẩm. Tài liệu đó nằm ở trang tài liệu chính thức của dự án (địa chỉ trong README). README còn nhắc việc chạy từ mã nguồn bằng Docker Compose, cấu hình proxy và chứng chỉ, sao lưu và nâng cấp, nhưng phần chính không có lệnh cụ thể, và bạn cần xem mục "triển khai và vận hành" trong thư mục docs/ của repo. Nếu muốn tự clone mã nguồn, lệnh phổ thông là:
git clone https://github.com/chaitin/MonkeyCode.git
cd MonkeyCodeSau đó làm theo tài liệu trong docs/ chứ đừng đoán lệnh.
IV.Kiểm tra đã chạy được chưa
README không đưa lệnh kiểm tra riêng cho server tự dựng. Cách đơn giản và hợp lý là:
- Mở client hoặc bản Web, nhập địa chỉ server của bạn (thay cho địa chỉ demo).
- Đăng nhập được bằng email và mã xác thực như trong phần demo.
- Gửi một yêu cầu ngắn, ví dụ "Tóm tắt giúp mình đoạn văn này", và nhận được kết quả.
- Mở bảng quản trị, xem tài nguyên, quyền và thống kê có hiện ra.
Lưu ý: nếu chưa nối mô hình AI nào, AI sẽ chưa trả lời được. Việc này là bình thường, không phải cài lỗi.
V.Dùng vào việc thật
A.Chủ shop làm báo cáo cuối tháng
Bạn là chủ shop với một đống file bán hàng rời rạc. Bạn đính kèm các file, rồi nhắn theo mẫu trong README:
Hãy sắp xếp các tài liệu này thành PPT báo cáo, và tổng hợp số liệu quan trọng trong bảng.Kết quả là một bản PPT và phần tóm tắt số liệu để bạn rà lại. Bạn vẫn nên tự kiểm tra các con số trước khi gửi cho ai.
B.Nhân viên văn phòng xử lý bảng tính
Bạn nhận một file Excel dài và cần phân tích nhanh. Bạn đưa file lên và nói rõ mục tiêu, như README gợi ý "phân tích bảng này". Bạn nêu thêm đầu ra mong muốn, ví dụ "chọn ra mục quan trọng nhất". AI trả lại bản tổng hợp để bạn dùng tiếp trong báo cáo.
Lợi thế lớn nhất không nằm ở AI, mà ở chỗ cả nhóm dùng chung một bộ tài nguyên và có người nhìn được cách nó đang được dùng.
Ông T
C.Dev giao việc lập trình
Bạn có một bản yêu cầu tính năng. Bạn gửi cho AI câu lệnh mẫu của README:
Hãy làm tính năng theo bản yêu cầu này, bổ sung test, và sửa các lỗi phát sinh khi chạy.Bạn nhận lại mã nguồn kèm test để xem xét. Hãy đọc kỹ code trước khi đưa vào dự án chính, vì AI vẫn có thể sai.
D.Quản trị viên chuẩn hoá cách dùng AI cho nhóm
Bạn phụ trách IT hoặc là trưởng nhóm. Bạn đăng nhập trang quản trị, cấu hình một mô hình chung, thêm kho tri thức của công ty và đặt quy tắc dùng. Thành viên đăng nhập là dùng được ngay, bạn xem được thống kê và lịch sử sử dụng. Bản miễn phí hỗ trợ tối đa 10 chỗ ngồi, đủ để một nhóm nhỏ thử.
VI.Lỗi hay gặp và cách xử lý
A.Chạy lệnh cài không ra kết quả hoặc báo lỗi mạng
Lệnh cài tải script từ địa chỉ bên ngoài. Nếu máy chủ không ra được Internet, hoặc mạng chặn địa chỉ đó, lệnh sẽ thất bại. Kiểm tra kết nối của máy chủ trước. README cũng nhắc việc cấu hình proxy và chứng chỉ trong phần vận hành, nên nếu nhóm bạn dùng proxy thì xem mục đó.
B.Lệnh bị từ chối vì thiếu quyền
Nếu script yêu cầu quyền cao hơn, bạn cần chạy bằng tài khoản có quyền phù hợp trên máy chủ. README không nêu rõ chi tiết này. Hãy xem tài liệu sản phẩm và đừng tự cấp quyền rộng hơn cần thiết.
C.Cài xong nhưng AI không trả lời
Thường là vì chưa cấu hình mô hình. Tài liệu nói nhóm tự thêm dịch vụ mô hình của mình, nên bạn vào trang quản trị để thêm. Cách cấu hình cụ thể xem trong tài liệu sản phẩm.
D.Không nhận được mã xác thực qua email
Kiểm tra thư mục spam trước. Với server demo, đó là dịch vụ chung của tác giả nên có thể có độ trễ. Với server tự dựng, README chưa nói rõ cách cấu hình gửi email, nên bạn cần xem tài liệu.
E.Muốn dùng Android, iOS hoặc Linux ARM64
Hiện README ghi các nền tảng này là "sắp có". Bạn có thể dùng bản Web trong lúc chờ.
VII.Có nên dùng không
Điểm mạnh. Đây là mã nguồn mở theo giấy phép AGPL-3.0, tự dựng được với một dòng lệnh và cấu hình nhẹ. Dữ liệu của nhóm lưu trên server của bạn. Nó có đủ phần quản trị mà các app chat AI cá nhân thường thiếu: chia sẻ tài nguyên, phân quyền, thống kê, tính phí. Nó hỗ trợ MCP, nên nối được công cụ nghiệp vụ. Bạn cũng có bản demo để thử mà không cần cài gì.
Giới hạn. Tài liệu chủ yếu bằng tiếng Trung, nên người không đọc được sẽ cần dịch. Bản miễn phí chỉ có tối đa 10 chỗ ngồi, không có cloud PC, không có hỗ trợ kỹ thuật và nội dung dựng sẵn ở mức cơ bản. Bản trả phí cần liên hệ tư vấn. Dù tự dựng server, nếu bạn dùng mô hình bên ngoài thì nội dung vẫn được gửi đến dịch vụ đó, vì vậy chọn nhà cung cấp mô hình cần cân nhắc. Phần sau khi cài (cấu hình mô hình, email) README chưa nói chi tiết.
Khi nào chọn cách khác. Nếu chỉ một mình bạn dùng AI và không cần quản lý nhóm, một công cụ AI cá nhân sẽ đơn giản hơn. Nếu bạn cần hỗ trợ kỹ thuật chính thức hay đông người dùng hơn 10 chỗ, hãy cân nhắc bản trả phí. Còn nếu muốn quản lý AI cho nhóm nhỏ và giữ dữ liệu trong tay, MonkeyCode đáng thử, bắt đầu bằng bản demo.
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. Bản miễn phí có giá ¥0 và hỗ trợ tối đa 10 chỗ ngồi, không có cloud PC và không có hỗ trợ kỹ thuật. Bản trả phí cần liên hệ để được tư vấn. README không nói về chi phí của mô hình AI mà bạn kết nối.
Không biết lập trình có dùng được không?
Được. README nói việc văn phòng và sáng tạo có thể mô tả bằng ngôn ngữ thường, ví dụ nhờ làm PPT hoặc phân tích bảng. Bạn đưa file, nêu mục tiêu và yêu cầu đầu ra là đủ. Phần tự dựng server thì cần biết dùng terminal cơ bản.
Có cần GPU để cài không?
README không nhắc đến yêu cầu GPU. Cấu hình nhẹ nhất được nêu là 1 nhân CPU và 1 GB RAM, và có thể tăng theo quy mô nhóm. Việc AI chạy ở đâu phụ thuộc vào mô hình bạn cấu hình, phần này chưa có thông tin chi tiết.
Chạy được trên Windows không?
Client có bản cho Windows x64, ngoài ra có macOS (Apple Silicon và Intel), Linux x64 và bản Web. Android, iOS, Linux ARM64 và máy tính HarmonyOS ghi là sắp có. Lệnh cài server là lệnh bash, chạy trên máy chủ.
Dữ liệu của mình có an toàn không?
Khi tự dựng, dữ liệu của nhóm được lưu trên server của bạn, và bạn tự quyết định quyền truy cập, sao lưu và thời gian lưu giữ. Tuy nhiên, nếu dùng mô hình hay công cụ bên ngoài, nội dung liên quan vẫn được gửi đến dịch vụ đó. Server demo là dịch vụ chung, nên đừng đưa dữ liệu thật lên.
Có thể nối mô hình AI và công cụ của riêng mình không?
Có. Nhóm có thể cấu hình dịch vụ mô hình riêng và nối công cụ qua MCP connector, kết hợp kho tri thức, kỹ năng, chuyên gia và quy tắc. Cách cấu hình chi tiết nằm trong tài liệu sản phẩm, README chính không ghi từng bước.
Có thể sửa mã nguồn hoặc phát triển thêm không?
Có. Bạn có thể xem, sửa và phát triển thêm, nhưng việc dùng, sửa đổi và phân phối phải tuân theo giấy phép AGPL-3.0 của repo. Nếu định đưa vào sản phẩm thương mại, bạn nên đọc kỹ điều khoản giấy phép.


