Bỏ qua tới nội dung
Ông T.vn

OpenMausBot: đội bot AI chạy trên máy bạn, có máy tính riêng — hướng dẫn cài đặt và dùng

11 phút đọcCập nhật
OpenMausBot: đội bot AI chạy trên máy bạn, có máy tính riêng — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

OpenMausBot là ứng dụng desktop mã nguồn mở (Apache-2.0) giúp bạn lập một đội bot AI trong giao diện giống app nhắn tin. Mỗi bot chạy bằng các CLI claude, codex hoặc grok có sẵn trên máy bạn, có thể dùng máy tính ảo và nối với hàng trăm ứng dụng như Gmail, Slack, GitHub. Cài bản dựng sẵn cho macOS, Windows hoặc Ubuntu khá đơn giản, vì máy chủ điều phối đã nằm sẵn trong app.

OpenMausBot là một ứng dụng chat mã nguồn mở, trong đó bạn nhắn tin với cả một đội bot AI như nhắn với danh bạ. Mỗi bot ở thanh bên là một agent thật: Claude hoặc Codex chạy ngay trên máy bạn, có tính cách riêng, mô hình riêng, máy tính riêng và các ứng dụng được kết nối riêng. Tác giả mô tả đây là bản thay thế mã nguồn mở cho Grok Bot, lấy cảm hứng từ Grok Bot nhưng là dự án độc lập, không liên kết với xAI, Meta, OpenAI hay Manus.

Vấn đề repo giải quyết khá rõ: một trợ lý AI nằm trong một cái hộp thường không đủ cho công việc thật. Bạn cần một bot lo email, một bot lo code, một bot theo dõi dự án, mỗi bot nhớ cuộc trò chuyện riêng của nó. OpenMausBot gom chúng vào một app, dùng chính các đăng nhập và gói đăng ký AI bạn đang có, nên không phải mở thêm tài khoản mới và không có máy chủ trung gian.

Người nên thử là chủ doanh nghiệp nhỏ, nhân viên văn phòng muốn giao việc lặp lại cho AI, và lập trình viên mới muốn một giao diện dễ nhìn để điều khiển nhiều agent cùng lúc. Điểm đáng giá nhất là cơ chế “hỏi trước khi làm”: lệnh shell, sửa file hay câu hỏi của bot đều hiện thành thẻ để bạn bấm Allow hoặc Deny. Hiện repo có khoảng 21.946 sao và 3.043 fork.

Ứng dụng

milind-soni/OpenMausBot

Ứng dụng chat mã nguồn mở: mỗi bot là một agent Claude/Codex/Grok chạy trên máy bạn, có máy tính ảo riêng, hỏi bạn duyệt trước khi làm việc rủi ro.

★ 22kTypeScriptApache-2.0
Xem repo trên GitHub

I.OpenMausBot làm được gì

A.Mỗi bot một “bộ não” riêng

Bạn chọn mô hình cho từng bot qua bộ chọn có cột nhà cung cấp, nơi các mô hình Claude và Codex nằm cạnh nhau. Nhà cung cấp nào chưa dùng được sẽ bị làm mờ kèm lý do. Bạn đổi mô hình giữa chừng cuộc trò chuyện được, ví dụ dùng mô hình mạnh cho việc khó rồi chuyển sang mô hình rẻ hơn cho việc đơn giản.

B.Mỗi bot có một máy tính

Mở bảng Computer, máy tính trên đám mây của bot tự khởi động. Bạn xem màn hình trực tiếp khi bot làm việc, hoặc bấm “Open desktop” để tự điều khiển trên trình duyệt. Ngoài ra bot có thể dùng một máy ảo Local VM cô lập, hoặc chính máy của bạn ở nơi nền tảng đã được kiểm chứng an toàn. Theo README, điều khiển máy thật chỉ có trên macOS và Ubuntu Xorg, phải bật thủ công, còn Ubuntu Wayland hiện bị tắt.

C.Bot hỏi trước khi hành động

Một “permission broker” biến mọi hành động rủi ro thành quyết định của bạn. Lệnh shell, sửa file, câu hỏi đều hiện thẻ ngay trong khung chat. Với người không rành kỹ thuật, đây là lớp an toàn đáng giá nhất.

D.Ứng dụng kết nối

Qua Composio, bạn có kho ứng dụng bấm một lần: Gmail, Slack, GitHub, Notion, Linear và hàng trăm ứng dụng khác. Đăng nhập OAuth một lần là mọi bot dùng được như công cụ.

E.Kênh, đội bot và giọng nói

  • Kênh (channel): tách Công việc, Cá nhân và từng dự án, mỗi kênh có bản ghi riêng, hướng dẫn chung, thư mục làm việc và danh sách bot riêng.
  • Cài cả đội từ một file Markdown: bạn có thể nhập đội bot qua Teams → Import. Kết nối mặc định tắt, routine tạm dừng, và gói không chứa khóa hay hội thoại.
  • Chia sẻ cả phòng ban: xuất bot, group chat, routine và hướng dẫn thành một file. Lịch sử chat, khóa và mật khẩu không bao giờ bị đưa vào.
  • Bot biết nói: nghe câu trả lời, hoặc bấm call để trò chuyện bằng giọng. Giọng có thể là ElevenLabs, Fish Audio, Grok (xAI), giọng Mac có sẵn hoặc máy chủ Chatterbox cục bộ.
  • MCP và dòng lệnh: app có sẵn máy chủ MCP kiểu stdio cho Claude Desktop hoặc Cursor, và lệnh openmausbot để chạy từ script hay CI.

II.Cần chuẩn bị gì

  • Hệ điều hành: macOS (Apple silicon và Intel), Windows x64, hoặc Ubuntu 24.04 x64. Bản Ubuntu còn ở dạng beta, màn hình GNOME được hỗ trợ.
  • Agent CLI: các bot chạy trên CLI claude, codex và grok cài trên máy bạn, dùng đăng nhập và gói đăng ký sẵn có. README không dạy cài các CLI này, nên bạn cần cài và đăng nhập theo hướng dẫn riêng của từng hãng.
  • Node: nếu bạn chạy từ mã nguồn, package.json yêu cầu Node từ phiên bản 24 trở lên. Dùng bản dựng sẵn thì không cần, vì máy chủ đã nhúng trong app.
  • Khóa tùy chọn: khóa Composio cho ứng dụng kết nối, khóa xAI cho giọng Grok, khóa ElevenLabs hoặc Fish Audio cho giọng bot, token Cloudflare Workers AI, khóa Jev hoặc OpenRouter cho tính năng chọn bot tự động. Tất cả đều không bắt buộc để bắt đầu.
  • Phần cứng: tư liệu không nói yêu cầu GPU hay cấu hình tối thiểu.

Khóa API bạn dán vào Settings được lưu cục bộ và là write-only: giao diện chỉ hiện trạng thái “configured”. Dù vậy, hãy chỉ dán khóa của chính bạn, và nhớ rằng bot dùng mô hình trả phí vẫn tốn quota hoặc tiền theo gói đăng ký của bạn.

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

  1. Tải bản càiVào trang Releases của repo và tải file đúng hệ điều hành
  2. Cài appKéo vào Applications (Mac), chạy file setup (Windows) hoặc cài .deb (Ubuntu)
  3. Chuẩn bị CLI agentCài và đăng nhập claude, codex hoặc grok trên máy
  4. Mở app và tạo botChọn mô hình, nhắn thử một câu
  5. Điền khóa nếu cầnDán khóa trong Settings cho giọng nói, ứng dụng kết nối

A.Tải bản cài đặt đúng hệ điều hành

Bản dựng sẵn là cách dễ nhất, vì máy chủ điều phối đã nhúng trong app. Bạn không cần cài máy chủ riêng. Các đường dẫn tải theo README:

text
macOS (Apple silicon): https://github.com/milind-soni/OpenMausBot/releases/latest/download/OpenMausBot.dmg
macOS (Intel):         https://github.com/milind-soni/OpenMausBot/releases/latest/download/OpenMausBot-intel.dmg
Windows (x64):         https://github.com/milind-soni/OpenMausBot/releases/latest/download/OpenMausBot-setup.exe
Ubuntu 24.04 (x64):    https://github.com/milind-soni/OpenMausBot/releases/latest/download/OpenMausBot-amd64.deb
Ubuntu (AppImage):     https://github.com/milind-soni/OpenMausBot/releases/latest/download/OpenMausBot.AppImage

Máy Mac đời mới (chip M1 trở lên) chọn bản Apple silicon, máy Mac đời cũ chọn bản Intel. Nếu không chắc, mở menu Apple → About This Mac để xem.

B.Cài theo từng hệ điều hành

  • macOS: mở file .dmg, kéo OpenMausBot vào Applications rồi mở. Bản này đã được ký và notarize.
  • Windows: chạy file setup. Trình cài đặt chạy một chạm, cài theo người dùng, không cần quyền admin. Vì chưa ký mã, SmartScreen sẽ báo “unknown publisher”. Đây là chuyện README đã nói trước: bấm More info → Run anyway. Hãy chắc chắn bạn tải file từ đúng trang Releases của repo.
  • Ubuntu 24.04: README khuyên cài file .deb bằng APT. Với AppImage, bạn cấp quyền thực thi cho file rồi chạy. README không ghi lệnh cụ thể ở phần này và dẫn sang hướng dẫn Ubuntu Desktop trong thư mục docs/ của repo, bạn xem ở đó.

C.Chuẩn bị CLI agent

Đây là chỗ người mới hay vấp nhất. OpenMausBot không tự mang theo “bộ não”. Nó điều khiển các CLI claude, codex, grok đã có trên máy. Nếu chưa có CLI nào, mô hình sẽ hiện mờ kèm lý do trong bộ chọn. Hãy cài và đăng nhập ít nhất một CLI theo tài liệu của chính hãng đó, rồi mở lại app. Nếu bạn muốn trỏ app sang một bản CLI khác (bản có phiên bản cố định hoặc một wrapper), vào Settings → Engines.

D.Chạy từ mã nguồn (cho lập trình viên)

Repo có package.json, Dockerfile và compose.yaml, và tệp .env.example liệt kê các biến như OMB_HTTP_PORT, OMB_PUBLIC_URL, ENGINES. Phần README mà mình có không ghi lệnh build hay lệnh chạy Docker, nên mình không đoán. Bạn lấy mã về như sau rồi đọc README.md, compose.yaml và thư mục docs/ để biết bước tiếp theo:

Terminal
git clone https://github.com/milind-soni/OpenMausBot.git
cd OpenMausBot

E.Dùng lệnh openmausbot

Lệnh openmausbot điều khiển một workspace đang chạy mà không cần màn hình. README cho hai ví dụ:

Terminal
openmausbot team apply team.yaml
openmausbot run "Room Lead" "Rehearse the launch of https://example.com" --export ./out

Lệnh đầu dựng đội bot từ một file. Lệnh sau giao cho bot “Room Lead” một việc, chờ bot và các đồng đội được nhờ xong, rồi xuất kết quả ra thư mục ./out. Cách cài lệnh này không có trong phần README mình đọc được. Gói npm có tên openmausbot, nhưng bạn nên xem mục “Run OpenMausBot from scripts and CI” trong docs/ để lấy đúng cách cài.

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

Tư liệu không nêu một lệnh kiểm tra cố định, nhưng dấu hiệu thành công khá dễ thấy:

  1. App mở lên và bạn thấy giao diện chat với danh sách bot ở thanh bên.
  2. Bộ chọn mô hình hiện ít nhất một nhà cung cấp không bị mờ (Claude, Codex hoặc Grok), nghĩa là app đã thấy CLI tương ứng.
  3. Bạn tạo một bot, nhắn một câu ngắn và thấy câu trả lời chạy dần ra khung chat.
  4. Thử nhờ bot làm việc cần quyền, ví dụ tạo một file. Một thẻ Allow / Deny phải hiện ra để bạn duyệt.

Nếu cả bốn điều trên đều ổn, cài đặt đã xong. Nếu bộ chọn mô hình mờ hết, quay lại bước chuẩn bị CLI.

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

A.Chủ shop nhờ bot soạn và kiểm tra email khách

Chị Lan bán đồ handmade, mỗi sáng có hàng chục email hỏi hàng. Chị tạo một bot “Trợ lý CSKH”, vào kho kết nối bấm kết nối Gmail bằng OAuth, rồi nhắn: “Đọc các email chưa trả lời từ hôm qua, tóm tắt từng cái và soạn nháp trả lời lịch sự.” Bot trả về danh sách tóm tắt kèm bản nháp. Mọi hành động gửi hoặc thao tác có rủi ro đều hiện thẻ để chị duyệt trước. Chị vẫn là người quyết định cuối cùng.

B.Nhân viên văn phòng tách việc theo kênh

Anh Minh làm marketing, vừa lo chiến dịch vừa lo báo cáo tuần. Anh tạo hai kênh “Chiến dịch” và “Báo cáo”, mỗi kênh có thư mục làm việc và danh sách bot riêng. Nhờ vậy bot ở kênh báo cáo không lẫn thông tin chiến dịch. Anh có thể đổi mô hình của một bot sang loại rẻ hơn khi chỉ cần việc đơn giản như đổi định dạng bảng.

Bot nào cũng phải hỏi bạn trước khi làm việc rủi ro, nên giao việc thật mà vẫn yên tâm.

Ông T

C.Lập trình viên mới giao việc cho nhiều agent

Bạn mới học lập trình và muốn một bot đọc repo, một bot viết test. Bạn tạo hai bot, chọn Claude cho bot đầu, Codex cho bot sau, và đặt cả hai vào cùng một kênh có thư mục dự án. Khi bot muốn chạy lệnh shell hay sửa file, thẻ duyệt hiện ra, và bạn học được khá nhiều chỉ nhờ đọc xem bot định làm gì. Muốn bot làm việc trong môi trường tách biệt khỏi máy thật, bạn dùng máy ảo Local VM hoặc máy tính đám mây.

D.Dev đưa bot vào script hoặc CI

Một nhóm nhỏ muốn chạy một việc lặp đi lặp lại mà không cần mở giao diện. Họ viết file team.yaml, chạy openmausbot team apply team.yaml, rồi giao việc bằng openmausbot run và thêm --export ./out để lấy kết quả. README nói có thể thêm --json để nhận một tài liệu JSON và có mã thoát để script rẽ nhánh theo kết quả.

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

A.Bộ chọn mô hình bị mờ, bot không trả lời

Thường là máy chưa có CLI claude, codex hay grok, hoặc CLI chưa đăng nhập. Hãy cài và đăng nhập CLI theo tài liệu của hãng, rồi mở lại app. Nếu dùng bản CLI đặt ở chỗ khác, khai báo trong Settings → Engines.

B.Windows báo “unknown publisher”

Đây là hành vi được README ghi sẵn vì trình cài chưa được ký mã. Chỉ tải từ trang Releases chính thức của repo, rồi chọn More info → Run anyway. Nếu bạn không yên tâm, có thể chọn cách chạy từ mã nguồn.

C.Giọng nói không phát

Bot cần khóa của nhà cung cấp giọng (ElevenLabs, Fish Audio hoặc khóa xAI cho giọng Grok). Kiểm tra bạn đã dán khóa trong Settings chưa. Với Grok, README yêu cầu lưu khóa xAI ở Settings → Connections rồi chọn Grok (xAI) và một giọng trong mục Voice & alerts của bot. Ngôn ngữ ngoài danh sách chính thức của xAI có thể cho chất lượng không đều.

D.Chế độ Auto không chọn được bot

Tính năng này cần token Cloudflare Workers AI kèm account ID, hoặc khóa TypeSafe Jev, hoặc khóa OpenRouter kèm mô hình, đặt ở Settings › AI › Routing and extraction. Nếu chưa có, hoặc mô hình quyết định không chắc, phòng sẽ quay về bot trưởng của phòng. Đó là thiết kế, không phải lỗi.

E.Không điều khiển được máy thật trên Ubuntu Wayland

Theo README, điều khiển máy thật trên Ubuntu Wayland hiện đang bị tắt có chủ đích. Bạn hãy dùng phiên Xorg, hoặc dùng máy tính đám mây hay Local VM thay thế.

VII.Có nên dùng không

Điểm mạnh: mã nguồn mở theo Apache-2.0, dữ liệu và khóa lưu cục bộ trong thư mục ~/.openmausbot, dùng lại đăng nhập AI bạn đang có, mỗi bot có mô hình và máy tính riêng, và có cơ chế duyệt trước rất rõ ràng. Có bản dựng sẵn cho ba hệ điều hành nên cài không khó.

Giới hạn: bạn vẫn phải tự cài và đăng nhập các CLI agent. Bản Ubuntu còn là beta. Trình cài Windows chưa ký mã. Điều khiển máy thật bị giới hạn theo nền tảng. Máy tính đám mây của bot dựa vào dịch vụ Boat, và ứng dụng kết nối dựa vào Composio, nên đây không phải thứ chạy hoàn toàn khép kín. Tư liệu cũng không nói chi phí các dịch vụ này.

Khi nên chọn cách khác: nếu bạn chỉ cần một khung chat AI đơn giản, dùng thẳng app của hãng mô hình sẽ gọn hơn. Nếu bạn cần mọi thứ chạy hoàn toàn ngoại tuyến, hãy kiểm tra kỹ từng tính năng, vì nhiều tính năng cần dịch vụ ngoài. Với người muốn thử một đội bot có kiểm soát, đây là lựa chọn đáng cài thử.

Cuối cùng, README cảnh báo rõ: OpenMausBot không có token tiền mã hoá nào. Mọi đồng coin dùng tên OpenMausBot, Maus hay SupaMaus đều không liên quan đến dự án.

4.5/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

OpenMausBot có miễn phí không?

Bản thân ứng dụng là mã nguồn mở theo giấy phép Apache-2.0. Tuy vậy, bot chạy bằng các CLI claude, codex, grok bằng đăng nhập và gói đăng ký của bạn, nên chi phí phụ thuộc gói đó. Tư liệu không nêu giá của các dịch vụ như Boat hay Composio.

OpenMausBot chạy được trên Windows không?

Được. Repo có trình cài Windows x64, chạy một chạm, theo người dùng, không cần quyền admin. Vì chưa ký mã, SmartScreen sẽ báo unknown publisher và bạn chọn More info rồi Run anyway. App cũng có bản cho macOS và Ubuntu 24.04.

Có cần GPU không?

Tư liệu không nêu yêu cầu GPU hay cấu hình phần cứng. Các bot chạy qua CLI của Claude, Codex hoặc Grok, và README không nói phải có card đồ họa.

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

Theo README, một máy chủ nhỏ trên 127.0.0.1 điều khiển mọi tiến trình agent, còn bản ghi hội thoại, khóa và sự kiện lưu trong thư mục ~/.openmausbot chứ không lưu trên đám mây. Khóa trong Settings là write-only, giao diện chỉ thấy cờ configured. Khi bạn dùng máy tính đám mây hay ứng dụng kết nối thì dữ liệu đi qua các dịch vụ đó, nên bạn nên cân nhắc.

OpenMausBot khác gì Grok Bot?

README nói đây là dự án độc lập lấy cảm hứng từ Grok Bot. Điểm khác theo bảng so sánh của tác giả: mỗi bot dùng được mô hình bạn chọn, chạy trên máy của bạn, và có thẻ duyệt hành động. Grok Bot theo README thì chỉ dùng Grok trên một máy tính đám mây dùng chung.

Bot có tự ý làm việc nguy hiểm trên máy tôi không?

Theo README, lệnh shell, sửa file và câu hỏi đều hiện thành thẻ Allow / Deny để bạn quyết định, cho cả máy tính đám mây và máy cục bộ. Điều khiển máy thật phải bật thủ công và chỉ có trên macOS và Ubuntu Xorg. Tuy vậy bạn vẫn nên đọc kỹ từng thẻ trước khi duyệt.

Dùng bot từ Claude Desktop hay Cursor được không?

Được ở mức giới hạn. OpenMausBot có sẵn máy chủ MCP kiểu stdio cho các ứng dụng như Claude Desktop và Cursor. Máy chủ này cho xem bot và kênh, đọc bản ghi, tạo hoặc cấu hình bot, giao việc và ngắt lượt chạy, nhưng không cho cấp quyền duyệt, xoá, đọc khóa hay quản lý máy tính. Chi tiết nằm trong tài liệu MCP của repo.

Chuyển nhanh tới mục

  1. I.OpenMausBot làm được gì
    1. A.Mỗi bot một “bộ não” riêng
    2. B.Mỗi bot có một máy tính
    3. C.Bot hỏi trước khi hành động
    4. D.Ứng dụng kết nối
    5. E.Kênh, đội bot và giọng nói
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Tải bản cài đặt đúng hệ điều hành
    2. B.Cài theo từng hệ điều hành
    3. C.Chuẩn bị CLI agent
    4. D.Chạy từ mã nguồn (cho lập trình viên)
    5. E.Dùng lệnh openmausbot
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop nhờ bot soạn và kiểm tra email khách
    2. B.Nhân viên văn phòng tách việc theo kênh
    3. C.Lập trình viên mới giao việc cho nhiều agent
    4. D.Dev đưa bot vào script hoặc CI
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Bộ chọn mô hình bị mờ, bot không trả lời
    2. B.Windows báo “unknown publisher”
    3. C.Giọng nói không phát
    4. D.Chế độ Auto không chọn được bot
    5. E.Không điều khiển được máy thật trên Ubuntu Wayland
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.