OpenMausBot: đội bot AI chạy trên máy bạn như app chat — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về milind-soni/OpenMausBot — 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: 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), cho bạn một danh sách bot AI như danh bạ trong 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. Người dùng thường chỉ cần tải bản cài cho macOS, Windows hoặc Ubuntu, nên cài khá dễ; phần khó hơn là chuẩn bị sẵn CLI và đăng nhập của các agent.
OpenMausBot là một ứng dụng chat mã nguồn mở, trong đó bạn có cả một đội bot AI thay vì một trợ lý duy nhất. Mỗi bot nằm trong thanh bên như một người trong danh bạ. Bên dưới, mỗi bot 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, model riêng, máy tính riêng và các app kết nối riêng.
Repo này hợp với người muốn dùng agent AI mà không phải gom mọi thứ vào một hộp duy nhất của một hãng. Nó cũng hợp với chủ shop, nhân viên văn phòng hay lập trình viên đã có gói Claude, ChatGPT hoặc Grok và muốn tận dụng đúng các đăng nhập đó. Hiện có khoảng 21.718 sao và 3.020 fork trên GitHub, giấy phép Apache-2.0. Theo tác giả, đây là dự án độc lập lấy cảm hứng từ Grok Bot, không liên kết với xAI, Meta, OpenAI hay Manus.
Điểm đáng giá nhất: dữ liệu (nhật ký hội thoại, key, sự kiện) nằm trong thư mục ~/.openmausbot trên máy bạn, không nằm trên cloud của dự án. Và mọi hành động rủi ro của bot đều hiện thành thẻ để bạn bấm Cho phép hoặc Từ chối.
milind-soni/OpenMausBot
OpenMausBot là app 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 riêng và kết nối app như Gmail, Slack.
I.OpenMausBot làm được gì
A.Mỗi bot một “bộ não” riêng
Bạn chọn model cho từng bot qua bộ chọn model. Model của 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 còn đổi model ngay giữa cuộc trò chuyện. Ví dụ: bot viết nội dung dùng một model, bot soạn code dùng model khác.
B.Mỗi bot có một máy tính
Mở bảng Computer, bot sẽ có một màn hình làm việc. Theo README, đó có thể là máy Linux trên cloud, một máy ảo cục bộ (Local VM), hoặc chính máy của bạn ở nơi nền tảng đã được chứng nhận an toàn. Bạn xem trực tiếp bot làm gì, hoặc bấm “Open desktop” để tự tay thao tác trên trình duyệt. Điều khiển máy thật hiện chỉ có trên macOS và Ubuntu Xorg, và chỉ sau khi bạn chủ động bật. Ubuntu Wayland đang bị tắt.
C.Bot hỏi trước khi làm
Lệnh shell, sửa file hay câu hỏi của bot hiện thành thẻ ngay trong chat: Allow, Deny hoặc trả lời. Có một bộ “môi giới quyền” (permission broker) biến mỗi hành động rủi ro thành quyết định của bạn, cả với máy cloud lẫn máy cục bộ.
D.Kết nối app qua Composio
Có một chợ app một chạm: Gmail, Slack, GitHub, Notion, Linear và hàng trăm app khác (README ghi hơn 500 app). Bạn đăng nhập OAuth một lần, mọi bot đều dùng được như công cụ.
E.Kênh, đội nhóm và giọng nói
- Kênh (channels): tách Công việc, Cá nhân và từng dự án thành các kênh riêng, mỗi kênh có nhật ký, hướng dẫn chung, thư mục làm việc và danh sách bot riêng.
- Cài cả một đội từ một file Markdown: bạn duyệt các đội mẫu, app mở màn hình xem lại trước khi tạo bot, kênh và routine. Kết nối để tắt cho đến khi bạn đồng ý, routine tạo ra ở trạng thái tạm dừng, và gói không chứa key hay hội thoại.
- Chia sẻ cả phòng ban: xuất bot, nhóm chat, routine thành một file để người khác nhập. Lịch sử chat, key, mật khẩu không đi theo.
- Bot biết nói: nghe câu trả lời bằng ElevenLabs, Fish Audio, Grok (xAI), giọng Mac có sẵn hoặc máy chủ Chatterbox cục bộ. Có cả chế độ “call” để nói chuyện trực tiếp.
- Chọn bot tự động (Jev): nếu bạn thêm token Cloudflare Workers AI, key Jev hoặc key OpenRouter, phòng đặt chế độ Auto sẽ chọn bot phù hợp cho tin nhắn không nhắc tên ai.
- MCP và dòng lệnh: có sẵn máy chủ MCP kiểu stdio cho Claude Desktop, Cursor, và lệnh
openmausbotđể chạy bằng script hoặc CI.
II.Cần chuẩn bị gì
Theo tư liệu, bản cài sẵn đã nhúng sẵn máy chủ “harness”, nên bạn không phải dựng server riêng. Bạn cần:
- Hệ điều hành: macOS (Apple silicon hoặc Intel), Windows x64, hoặc Ubuntu 24.04 x64 (bản beta, desktop hỗ trợ là GNOME).
- Ít nhất một agent CLI trên máy:
claude,codexhoặcgrok. README nói bot chạy bằng các CLI này với đăng nhập và gói đăng ký bạn đã có, không cần tài khoản mới. Đoạn README mình có chưa ghi cách cài từng CLI, bạn xem hướng dẫn của chính các công cụ đó. - Key tùy chọn: key xAI nếu muốn giọng Grok; key ElevenLabs hoặc Fish Audio nếu muốn giọng cloud; token Cloudflare, Jev hoặc OpenRouter nếu muốn chọn bot tự động.
- Node >= 24 chỉ cần nếu bạn tự chạy từ mã nguồn (theo package.json). Dùng bản cài sẵn thì không cần.
Key và đăng nhập là thứ nhạy cảm. README nói key được lưu cục bộ và giao diện chỉ thấy cờ “đã cấu hình”. Dù vậy, bạn nên chỉ cấp cho bot những quyền thật cần, và đọc kỹ thẻ Allow/Deny trước khi bấm. Gọi model qua gói của bạn có thể tốn lượt dùng hoặc tiền theo gói đó.
III.Cài đặt từng bước
- Chuẩn bị agentCó sẵn ít nhất một CLI claude, codex hoặc grok đã đăng nhập trên máy
- Tải bản càiChọn file đúng hệ điều hành ở trang release của repo
- Cài và mở appKéo vào Applications (Mac), chạy file setup (Windows), hoặc cài .deb/AppImage (Ubuntu)
- Cấu hình engine và keyVào Settings để chỉnh engine, dán key khi cần
- Mở bot đầu tiênChọn bot trong thanh bên và bắt đầu trò chuyện
A.Chuẩn bị agent CLI
Trước khi mở OpenMausBot, hãy chắc chắn máy bạn đã có claude, codex hoặc grok và đã đăng nhập. Nếu CLI nằm ở đường dẫn lạ (bản có số phiên bản hoặc script bọc ngoài), README cho biết bạn trỏ engine tới file đó trong Settings → Engines. Chỗ này người mới hay vấp: app chỉ là “vỏ chat”, còn “bộ não” là các CLI bên dưới.
B.Tải bản cài
Vào trang release mới nhất của repo và chọn file theo máy:
- macOS Apple silicon: OpenMausBot.dmg
- macOS Intel: OpenMausBot-intel.dmg
- Windows x64: OpenMausBot-setup.exe
- Ubuntu 24.04 x64: OpenMausBot-amd64.deb hoặc OpenMausBot.AppImage
C.Cài trên macOS
Mở file .dmg, kéo OpenMausBot vào Applications rồi mở app. README cho biết bản này đã được ký và notarize.
D.Cài trên Windows
Chạy OpenMausBot-setup.exe. Trình cài theo kiểu một chạm, cài cho riêng người dùng và không cần quyền admin. Vì trình cài chưa được ký số, Windows SmartScreen sẽ báo “unknown publisher”. README hướng dẫn bấm More info → Run anyway. Đây là chỗ nhiều người dừng lại vì tưởng file lỗi.
E.Cài trên Ubuntu 24.04
README khuyên cài file .deb bằng APT. Mở terminal ở thư mục chứa file vừa tải:
sudo apt install ./OpenMausBot-amd64.debNếu dùng AppImage, bạn cần cấp quyền chạy cho file rồi mở nó:
chmod +x OpenMausBot.AppImage
./OpenMausBot.AppImageBản Ubuntu còn ở mức beta. Phần cài đặt, khả năng hỗ trợ và xử lý lỗi có trong hướng dẫn Ubuntu Desktop của repo (thư mục docs/).
F.Mở app và điền key
Mở OpenMausBot. Mọi key (xAI, ElevenLabs, Fish Audio, Composio…) được dán trong phần cài đặt của app. README cho biết chúng lưu cục bộ và áp dụng ngay, không cần khởi động lại. Ví dụ giọng Grok: lưu key xAI ở Settings → Connections, rồi chọn Grok (xAI) trong Voice & alerts của bot.
G.Tự chạy từ mã nguồn (tùy chọn)
Phần README mình có chưa ghi lệnh dựng từ mã nguồn. Repo có package.json (yêu cầu Node >= 24), pnpm-lock.yaml, Dockerfile, compose.yaml và .env.example, nên bạn có thể tự tìm hiểu theo các file này và thư mục docs/. Phần lệnh chắc chắn đúng chỉ là lấy mã về:
git clone https://github.com/milind-soni/OpenMausBot.git
cd OpenMausBotBiến cấu hình trong .env.example gồm OMB_BIND_ADDRESS, OMB_HTTP_PORT, OMB_PUBLIC_URL, OMB_HTTPS_HOST, ENGINES… Mình khuyên bạn đọc chú thích trong chính file đó trước khi sửa. Nếu chỉ muốn dùng thử, hãy chọn bản cài sẵn cho đỡ vất vả.
IV.Kiểm tra đã chạy được chưa
Cách dễ nhất: mở app, thấy thanh bên có danh sách bot, gửi một tin nhắn và nhận được câu trả lời. README mô tả câu trả lời hiện dần (streaming) kèm các chip báo công cụ đang chạy.
Hãy kiểm tra thêm vài điểm:
- Trong bộ chọn model, model của CLI bạn đã cài có hiện bình thường, không bị làm mờ.
- Khi nhờ bot sửa file hoặc chạy lệnh, thẻ Allow/Deny xuất hiện trong chat.
- Mở bảng Computer, màn hình của bot hiện ra.
Theo sơ đồ trong README, máy chủ harness lắng nghe ở 127.0.0.1:8799 (và giao diện dev ở cổng 5199). Với bản cài sẵn, bạn không cần mở các cổng này thủ công.
V.Dùng vào việc thật
A.Chủ shop: một đội bot cho từng việc
Bạn bán hàng online và muốn một bot trả lời mẫu tin nhắn, một bot soạn bài đăng. Hãy tạo mỗi bot một tính cách riêng, rồi gom vào một kênh “Shop”. Bạn gửi yêu cầu kiểu:
Viết 3 mẫu tin trả lời khách hỏi về thời gian giao hàng, giọng thân thiện, mỗi mẫu dưới 40 chữ.Kết quả là các mẫu tin trong đúng luồng chat của bot đó. Bot khác trong cùng kênh vẫn có nhật ký riêng, nên không lẫn việc.
B.Nhân viên văn phòng: nối Gmail, Slack, Notion
Bạn đăng nhập OAuth một lần trong chợ app (qua Composio), rồi nhờ bot làm việc với các app đó:
Tóm tắt các email chưa đọc hôm nay và gom thành danh sách việc cần làm.Bot dùng Gmail như một công cụ. Nếu cần hành động nhạy cảm, bạn sẽ thấy thẻ xin phép. Với cả đội mẫu cài từ file, README nói kết nối mặc định tắt và routine ở trạng thái tạm dừng, nên bạn bật từng thứ khi đã yên tâm.
Bot nào cũng là một agent thật, và bạn là người bấm Allow.
Ông T
C.Lập trình viên: giao việc cho bot qua dòng lệnh
Bạn muốn chạy bot trong script hoặc CI mà không mở giao diện. README ghi hai lệnh sau (cho một workspace đang chạy):
openmausbot team apply team.yaml
openmausbot run "Room Lead" "Rehearse the launch of https://example.com" --export ./outLệnh đầu dựng đội từ file, lệnh sau giao cho bot một việc, chờ cả bot và đồng đội của nó xong rồi xuất kết quả ra thư mục ./out. Thêm --json để có một tài liệu JSON và mã thoát mà script có thể rẽ nhánh.
D.Dev dùng Claude Desktop hoặc Cursor để điều phối đội bot
OpenMausBot có sẵn máy chủ MCP stdio. Từ Claude Desktop hoặc Cursor, bạn xem danh sách bot và kênh, đọc hoặc tìm trong hội thoại, tạo bot, giao việc, đổi model và dừng lượt đang chạy. Máy chủ này cố tình không mở quyền duyệt hành động, xóa, sửa cài đặt tùy ý, lấy key hay quản lý máy tính. Cách thiết lập nằm trong tài liệu MCP của repo (thư mục docs/).
VI.Lỗi hay gặp và cách xử lý
A.Windows báo “unknown publisher”
Đây là hành vi được ghi rõ: trình cài chưa được ký số. Bạn bấm More info → Run anyway. Chỉ làm vậy khi file tải từ trang release chính thức của repo.
B.Model bị làm mờ, bot không trả lời
Thường là CLI tương ứng chưa cài, chưa đăng nhập, hoặc app không tìm thấy. README nói nhà cung cấp không dùng được sẽ bị mờ kèm lý do, nên hãy đọc lý do đó. Nếu CLI nằm ở đường dẫn riêng, trỏ engine tới file chạy trong Settings → Engines.
C.Không thấy tùy chọn điều khiển máy thật trên Ubuntu
Ubuntu Wayland đang bị tắt điều khiển máy chủ (theo README, đang chờ xử lý một issue). Điều khiển máy thật chỉ có trên macOS và Ubuntu Xorg, sau khi bạn chủ động bật. Hãy đăng nhập phiên Xorg hoặc dùng máy cloud / Local VM thay thế.
D.Giọng Grok không đọc hoặc đọc sai tiếng
Kiểm tra bạn đã lưu key xAI ở Settings → Connections và chọn Grok (xAI) trong Voice & alerts. README cũng nói chất lượng có thể kém với ngôn ngữ ngoài danh sách xAI hỗ trợ chính thức, nên tiếng Việt có thể chưa tốt. Hãy thử giọng khác.
E.Nhập đội mẫu nhưng bot chưa làm gì
Đó là chủ ý an toàn: kết nối tắt, routine tạm dừng, bot mới ở chế độ Ask, kỹ năng tắt. Bạn xem màn hình xem lại, rồi bật từng kết nối và routine khi đã kiểm tra.
VII.Có nên dùng không
Điểm mạnh:
- Mã nguồn mở Apache-2.0, chạy cục bộ, dữ liệu lưu trên máy bạn.
- Dùng lại gói đăng ký và CLI có sẵn, không cần thêm tài khoản hay proxy trung gian.
- Nhiều bot, mỗi bot một model, một máy tính, một bộ app riêng.
- Có thẻ duyệt hành động nên bạn giữ quyền kiểm soát.
- Có cả giao diện, MCP và dòng lệnh, hợp cả người dùng thường lẫn dev.
Giới hạn:
- Bạn vẫn cần tự có và đăng nhập các CLI agent. Chi phí dùng model phụ thuộc gói của bạn.
- Máy tính cloud của bot dựa trên dịch vụ bên thứ ba (Boat), kết nối app dựa trên Composio. Chính sách dữ liệu của các bên đó không nằm trong tư liệu mình có.
- Bản Ubuntu mới ở mức beta, Windows chưa ký số, điều khiển máy thật bị giới hạn theo nền tảng.
- Dự án có nhiều tính năng nên người mới có thể thấy rối lúc đầu. Hãy bắt đầu với một bot và một kênh.
Nên chọn cách khác khi: bạn chỉ cần một chatbot hỏi đáp đơn giản trên web, hoặc không muốn cài thêm CLI và quản lý key. Lúc đó một trợ lý có sẵn trong trình duyệt sẽ nhẹ nhàng hơn.
Lưu ý: README nhấn mạnh dự án không có token tiền mã hóa nào. Mọi đồng coin dùng tên OpenMausBot, Maus hay SupaMaus đều không liên quan đến dự án.
Câu hỏi thường gặp
OpenMausBot có miễn phí không?
Phần mềm là mã nguồn mở theo giấy phép Apache-2.0 nên tải và dùng không mất phí bản quyền. Tuy nhiên bot chạy bằng các CLI claude, codex, grok theo gói đăng ký của bạn, nên chi phí model phụ thuộc gói đó. Tư liệu chưa nêu giá của máy tính cloud hay dịch vụ bên thứ ba.
Có cần GPU không?
Tư liệu không yêu cầu GPU. Các bot chạy qua CLI của Claude, Codex hoặc Grok, nên phần suy luận không do máy bạn tự chạy model cục bộ. Máy bạn chủ yếu cần cài được app và các CLI.
Chạy được trên Windows không?
Có. Có bản Windows x64 dạng file setup, cài cho riêng người dùng và không cần quyền admin. Vì chưa được ký số, SmartScreen sẽ báo “unknown publisher”, bạn chọn More info rồi Run anyway. Ngoài ra còn có bản macOS (Apple silicon và Intel) và Ubuntu 24.04 x64 (beta).
Dữ liệu của tôi có an toàn không?
README nói máy chủ chạy ở 127.0.0.1 và nhật ký, key, sự kiện lưu trong ~/.openmausbot trên máy bạn, còn giao diện chỉ thấy cờ “đã cấu hình” chứ không thấy nội dung key. Khi dùng máy cloud (Boat), kết nối app (Composio) hoặc giọng cloud, dữ liệu liên quan sẽ đi qua các dịch vụ đó. Tư liệu chưa có thông tin chi tiết về chính sách của họ.
Bot có tự làm bừa trên máy tôi không?
Theo README, lệnh shell, sửa file và câu hỏi của bot hiện thành thẻ Allow/Deny để bạn quyết định. Điều khiển máy thật chỉ có trên macOS và Ubuntu Xorg, và chỉ sau khi bạn chủ động bật. Ubuntu Wayland hiện đang bị tắt.
OpenMausBot khác gì Grok Bot?
README mô tả Grok Bot là danh sách bot trên một máy tính cloud dùng chung, chỉ dùng Grok. OpenMausBot giữ ý tưởng đó nhưng cho mỗi bot một model và một máy tính riêng, chạy trên máy bạn với các CLI sẵn có. Đây là dự án độc lập, không liên kết với xAI.
Có tự chạy bằng Docker hoặc từ mã nguồn được không?
Repo có Dockerfile, compose.yaml, .env.example và package.json yêu cầu Node >= 24, nên có đường tự dựng. Phần README mình có chưa ghi lệnh cụ thể, bạn xem các file này và thư mục docs/ trong repo.


