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

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

10 phút đọcCập nhật

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 →

OpenMausBot: đội bot AI trong app chat, chạy trên máy bạn — 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 phép bạn trò chuyện với cả một đội bot AI như trong app nhắn tin. Mỗi bot chạy bằng Claude, Codex hoặc Grok CLI cài sẵn trên máy bạn, có thể dùng máy tính riêng và app kết nối. Cài bản dựng sẵn cho macOS, Windows hoặc Ubuntu khá dễ, chỉ cần tải và chạy.

OpenMausBot là ứng dụng mã nguồn mở biến các AI agent thành một danh sách liên hệ trong app chat. Mỗi bot là một agent thật, chạy bằng Claude, Codex hoặc Grok CLI cài trên máy bạn. Bot 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. Tác giả nói đây là bản thay thế mã nguồn mở cho Grok Bot, lấy cảm hứng từ ý tưởng đó và không liên kết với xAI, Meta, OpenAI hay Manus.

Nếu bạn đã trả tiền cho Claude, ChatGPT hoặc Grok và muốn dùng chúng như một đội nhân viên (một bot lo email, một bot lo nghiên cứu, một bot lo code), repo này dành cho bạn. Chủ shop, nhân viên văn phòng và lập trình viên mới đều dùng được, vì bản cài đặt là file tải về, không phải gõ lệnh build.

Điểm đáng giá nhất: dữ liệu (lịch sử trò chuyện, khoá, sự kiện) nằm trong thư mục ~/.openmausbot trên máy bạn, và mọi hành động rủi ro đều hiện thành thẻ để bạn bấm Cho phép hoặc Từ chối. Repo hiện có khoảng 21.946 sao và 3.043 fork, vẫn được cập nhật trong 3 tháng gần đây.

Ứng dụng

milind-soni/OpenMausBot

OpenMausBot là ứng dụng desktop mã nguồn mở: một danh sách bot AI như danh bạ chat, chạy bằng Claude, Codex hoặc Grok CLI có sẵn trên máy bạn.

★ 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 model cho từng bot, Claude và Codex nằm cạnh nhau trong bộ chọn. Provider nào chưa dùng được sẽ bị làm mờ kèm lý do. Bạn có thể đổi model ngay giữa cuộc trò chuyện, ví dụ dùng model mạnh cho việc khó và model nhẹ cho việc vặt.

B.Dùng tài khoản bạn đã có

Bot chạy qua các CLI claude, codex, grok đã cài trên máy. Bạn dùng đăng nhập và gói đăng ký hiện có, không cần tài khoản mới và không có máy chủ trung gian. Trong Settings → Engines bạn còn trỏ được tới một bản CLI tuỳ chỉnh.

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

Mở bảng Computer, bot sẽ có một màn hình Linux trên đám mây (qua Boat), hoặc một máy ảo Local VM cô lập. Ở nơi nền tảng đã được chứng nhận an toàn, bot có thể điều khiển máy của bạn, nhưng chỉ khi bạn chủ động bật. README nói điều khiển máy thật có trên macOS và Ubuntu Xorg. Ubuntu Wayland hiện bị tắt.

D.Bot hỏi trước khi làm

Lệnh shell, sửa file và câu hỏi hiện thành thẻ ngay trong khung chat: Allow, Deny hoặc trả lời. Đây là phần giúp người mới yên tâm nhất.

E.Kết nối app

Qua Composio, bạn bấm kết nối Gmail, Slack, GitHub, Notion, Linear và hàng trăm app khác bằng OAuth một lần. Sau đó mọi bot dùng được chúng như công cụ.

F.Kênh, nhóm và đội dựng sẵn

  • Kênh (channels): tách Công việc, Cá nhân và từng dự án, mỗi kênh có lịch sử, hướng dẫn chung và danh sách bot riêng.
  • Cài cả đội từ một file Markdown: bạn nhập file .md hoặc dán link GitHub công khai trong Teams → Import. App hiện màn hình xem lại trước khi tạo bot. Kết nối mặc định tắt, routine ở trạng thái tạm dừng, file không chứa khoá hay lịch sử chat.
  • Chia sẻ cả phòng ban: chuột phải vào phòng ban rồi chọn Share department…. Lịch sử chat, khoá, mật khẩu và máy tính không bị đưa vào file.
  • Chọn bot tự động: với phòng đặt chế độ Auto, một model quyết định nhanh sẽ chọn bot hợp với tin nhắn không gắn tên (cần khoá Cloudflare Workers AI, TypeSafe Jev hoặc OpenRouter).

G.Bot biết nói

Bạn bấm biểu tượng loa để nghe câu trả lời, hoặc bấm call để trò chuyện bằng giọng nói. Giọng đọc có thể là ElevenLabs, Fish Audio, Grok (xAI), giọng có sẵn của Mac hoặc máy chủ Chatterbox cục bộ.

H.Điều khiển bằng MCP và dòng lệnh

Repo có sẵn một MCP server (stdio) cho Claude Desktop hoặc Cursor. Nó cho xem bot, kênh, gửi việc, chờ xong, đổi model, nhưng cố ý không cho duyệt quyền, xoá hay đụng tới khoá. Lệnh openmausbot cho phép chạy từ script và CI.

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

Theo README, bản cài dựng 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 GNOME được hỗ trợ).
  • Ít nhất một CLI agent đã đăng nhập: claude, codex hoặc grok. Đây là phần README nói bot chạy trên đó.
  • Khoá tuỳ chọn: khoá ElevenLabs/Fish Audio nếu muốn giọng đọc đám mây, khoá xAI để dùng giọng Grok, tài khoản Composio khi nối app, tài khoản Boat cho máy tính đám mây. Mình chưa thấy trong tư liệu mức giá của các dịch vụ này.
  • Nếu chạy từ mã nguồn: package.json yêu cầu Node 24 trở lên. Repo có Dockerfile, compose.yaml và .env.example.

Bot có thể chạy lệnh shell, sửa file và dùng app như Gmail. Hãy đọc kỹ từng thẻ Allow / Deny trước khi bấm. Khoá API nhập vào App Settings chỉ lưu trên máy, nhưng bạn vẫn không nên chia sẻ ảnh chụp màn hình có chứa khoá. Việc dùng Claude, Codex hay Grok vẫn tính vào gói hoặc hạn mức của chính bạn.

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

  1. Cài CLI agentCó ít nhất một trong claude, codex, grok trên máy và đã đăng nhập
  2. Tải bản càiLấy file đúng hệ điều hành từ trang Releases
  3. Cài và mở appChạy file cài, mở OpenMausBot
  4. Nhập khoáDán khoá cần thiết trong Settings
  5. Tạo bot đầu tiênChọn model, chat thử

A.Cài CLI agent trước

Bot chạy trên các CLI có sẵn, nên bạn cần cài và đăng nhập ít nhất một cái. Phần được cắt của README mà mình có không ghi lệnh cài cho từng CLI, vì vậy mình không đoán. Hãy xem hướng dẫn chính thức của Claude, Codex hoặc Grok để cài và đăng nhập.

B.Tải bản cài

Vào trang Releases của repo, chọn bản mới nhất, tải đúng file:

  • 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 thư mục Applications rồi mở. README nói bản này đã ký và notarized, nên máy sẽ không cảnh báo lạ.

D.Cài trên Windows

Chạy OpenMausBot-setup.exe. Trình cài một chạm, cài theo người dùng, không cần quyền admin. Chỗ người mới hay vấp: bản này chưa được ký mã nên Windows SmartScreen báo "unknown publisher". README hướng dẫn bấm More info → Run anyway. Chỉ làm vậy với file tải từ trang Releases chính thức của repo.

E.Cài trên Ubuntu

README khuyên cài file .deb bằng APT. Bạn mở terminal tại thư mục chứa file đã tải. Lệnh dưới là lệnh APT phổ thông, thay tên file nếu khác:

Terminal
sudo apt install ./OpenMausBot-amd64.deb

Cách khác là cấp quyền chạy cho file AppImage rồi mở nó. Đây là bản beta và README chỉ nói GNOME được hỗ trợ.

F.Nhập khoá và tạo bot

Mở App Settings và dán các khoá cần dùng. Theo README, khoá được lưu trên máy, đội provider tự nạp lại ngay, và giao diện chỉ hiện cờ "configured" chứ không hiện lại khoá. Sau đó tạo bot mới, chọn model rồi nhắn thử.

G.Chạy từ mã nguồn (cho người muốn tự build)

Tải mã về:

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

Phần README mình có ở đây đã bị cắt trước đoạn hướng dẫn build, nên mình không ghi lệnh cài phụ thuộc hay chạy dev. Bạn xem mục scripts trong package.json (cần Node 24 trở lên) và thư mục docs/ trong repo. Nếu muốn chạy bằng Docker, repo có Dockerfile và compose.yaml. Các biến cấu hình mẫu trong .env.example gồm OMB_BIND_ADDRESS, OMB_HTTP_PORT, OMB_PUBLIC_URL, ENGINES, OMB_DATA_VOLUME… Hãy đọc kỹ tệp này trước khi sửa. Người mới nên dùng bản cài dựng sẵn.

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

Dấu hiệu thành công theo tư liệu:

  • App mở lên với danh sách bot ở thanh bên và khung chat.
  • Trong bộ chọn model, provider bạn đã đăng nhập (Claude hoặc Codex) không bị làm mờ. Nếu bị mờ, app ghi lý do.
  • Bạn tạo một bot, nhắn thử, thấy câu trả lời hiện dần cùng các chip hoạt động khi bot dùng công cụ.
  • Khi bot muốn chạy lệnh hoặc sửa file, một thẻ Allow / Deny hiện ra trong chat.

Kiến trúc theo README: app giao diện chạy ở cổng 5199 còn máy chủ harness nghe ở 127.0.0.1:8799 (chỉ nội bộ). Với bản cài dựng sẵn, máy chủ được nhúng sẵn nên bạn không phải mở thủ công.

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

A.Chủ shop: một đội trợ lý theo mảng

Bạn tạo ba bot: "Bán hàng", "Nội dung", "Sổ sách", mỗi bot một kênh. Bạn nhắn cho bot Nội dung: "Viết 5 mẫu tin nhắn chăm sóc khách vừa mua hàng, giọng thân thiện, ngắn gọn." Kết quả là bản nháp nằm trong đúng kênh, không lẫn với việc khác. Mỗi kênh có hướng dẫn chung riêng nên bạn không phải dặn lại.

Đừng dùng một trợ lý cho mọi việc; hãy cho mỗi việc một đồng nghiệp riêng.

Ông T

B.Nhân viên văn phòng: bot đọc mail, bạn duyệt

Bạn nối Gmail qua mục app kết nối (OAuth một lần). Rồi nhắn bot: "Tóm tắt các email chưa đọc hôm nay và soạn nháp trả lời cho những mail cần phản hồi." Bot làm việc, và các hành động nhạy cảm hiện thành thẻ để bạn quyết định. Kết quả là bạn có danh sách tóm tắt và các bản nháp, trong khi quyền kiểm soát vẫn ở tay bạn.

C.Lập trình viên mới: giao việc cho bot có máy riêng

Bạn mở bảng Computer của bot để nó có một Linux desktop đám mây hoặc Local VM. Bạn nhắn: "Cài thử dự án này trong máy của bạn và báo lại lỗi nếu có." Bạn xem màn hình trực tiếp khi bot làm, và bấm "Open desktop" để tự tiếp quản trong trình duyệt. Cách này an toàn hơn cho máy chính vì mọi thứ chạy trong môi trường cô lập.

D.Người làm tự động hoá: chạy bot từ script

Nếu đã có workspace OpenMausBot đang chạy, README cho thấy hai lệnh. Lệnh thứ nhất dựng đội từ file YAML, lệnh thứ hai giao một việc cho bot và xuất kết quả:

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

Lệnh chờ bot và các đồng đội được nó nhờ làm xong, rồi xuất kết quả vào thư mục ./out. README nói thêm có tuỳ chọn --json và mã thoát để script rẽ nhánh. Hướng dẫn chi tiết nằm trong tài liệu "Run OpenMausBot from scripts and CI" của repo.

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

A.Provider bị làm mờ trong bộ chọn model

Thường là CLI tương ứng chưa cài hoặc chưa đăng nhập. Mở terminal, kiểm tra CLI đó chạy được và đã đăng nhập, rồi mở lại app. App ghi lý do ngay trên mục bị mờ, hãy đọc dòng đó trước.

B.Windows báo "unknown publisher"

Đây là chuyện đã biết: trình cài chưa được ký mã. Chỉ bấm More info → Run anyway khi bạn chắc file tải từ trang Releases chính thức của repo.

C.Ubuntu: bot không điều khiển được máy thật

README nói điều khiển máy thật trên Ubuntu chỉ bật cho Xorg và phải opt-in. Wayland hiện bị tắt có chủ ý (đang theo dõi ở issue #345). Nếu bạn đang dùng Wayland, hãy dùng máy tính đám mây hoặc Local VM thay thế.

D.Gọi lệnh openmausbot không chạy

Lệnh này điều khiển một workspace đang chạy, nên hãy mở app trước. Nếu vẫn lỗi, xem tài liệu CLI trong thư mục docs/ của repo. Mình chưa có thông tin về cách cài lệnh này ngoài tên gói npm openmausbot.

E.Giọng đọc không phát

Kiểm tra bạn đã lưu đúng khoá trong Settings (ví dụ khoá xAI trong Settings → Connections cho giọng Grok) và đã chọn giọng trong phần Voice & alerts của bot. README cũng nói chất lượng giọng Grok có thể kém hơn với ngôn ngữ nằm ngoài danh sách xAI hỗ trợ chính thức, nên tiếng Việt có thể chưa tốt.

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

Điểm mạnh:

  • Mã nguồn mở, giấy phép Apache-2.0.
  • Dùng lại CLI và gói đăng ký bạn đã có, dữ liệu lưu cục bộ.
  • Thẻ duyệt hành động giúp kiểm soát việc bot làm.
  • Có đội dựng sẵn, chia sẻ phòng ban, MCP và dòng lệnh cho người muốn đi sâu.
  • Có bản cài sẵn cho cả ba hệ điều hành.

Giới hạn:

  • Bạn vẫn cần ít nhất một CLI agent (Claude, Codex hoặc Grok) và hạn mức của nó.
  • Máy tính đám mây, kết nối app và giọng đọc phụ thuộc dịch vụ bên thứ ba (Boat, Composio, ElevenLabs/Fish Audio), có thể cần tài khoản hoặc khoá riêng.
  • Bản Ubuntu còn là beta, bản Windows chưa ký mã, điều khiển máy thật chưa có trên Ubuntu Wayland.
  • README lưu ý dự án không liên quan tới bất kỳ đồng tiền mã hoá nào. Hãy cảnh giác với mọi token mang tên OpenMausBot, Maus hay SupaMaus.

Nên chọn cách khác khi: bạn chỉ cần một trợ lý chat đơn giản (app chat của chính nhà cung cấp là đủ), hoặc bạn không muốn cài và quản lý CLI agent trên máy. Còn nếu bạn muốn một đội bot, mỗi bot một việc, có kiểm soát và chạy trên máy mình, OpenMausBot đáng để thử.

4.9/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 trên các CLI Claude, Codex hoặc Grok nên vẫn dùng gói đăng ký hoặc hạn mức của bạn ở các dịch vụ đó. Chi phí của Boat, Composio hay giọng đọc đám mây chưa có trong tư liệu mình có.

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

Có. Repo cung cấp trình cài Windows x64 là OpenMausBot-setup.exe, cài theo người dùng và không cần quyền admin. Trình cài chưa được ký mã nên SmartScreen sẽ báo "unknown publisher", bạn bấm More info rồi Run anyway.

Có cần GPU hay máy cấu hình mạnh không?

Tư liệu không nêu yêu cầu GPU hay RAM. Các agent chạy qua CLI của Claude, Codex hoặc Grok, còn máy tính của bot có thể là desktop đám mây hoặc máy ảo cô lập. Về cấu hình tối thiểu, mình chưa có thông tin.

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

README nói lịch sử trò chuyện, khoá và sự kiện được lưu trong thư mục ~/.openmausbot trên máy bạn, không lưu trên đám mây của dự án. Khoá chỉ ghi vào, giao diện chỉ thấy cờ "configured". Khi bạn dùng máy tính đám mây hay app kết nối thì dữ liệu liên quan sẽ đi qua các dịch vụ đó.

Bot có tự ý làm việc nguy hiểm 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 đám mây lẫn máy cục bộ. Điều khiển máy thật chỉ có khi bạn chủ động bật. Kết nối app mặc định tắt cho đến khi bạn duyệt.

OpenMausBot khác gì Grok Bot?

README mô tả Grok Bot của xAI là danh sách bot chạy trên một máy tính đám mây 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 của bạn. Dự án độc lập và không liên kết với xAI.

Có dùng được từ Claude Desktop hoặc Cursor không?

Có. Repo kèm một MCP server stdio cho các ứng dụng như Claude Desktop và Cursor. Nó cho xem bot và kênh, gửi việc, đổi model, nhưng không cho duyệt quyền, xoá, đụng vào khoá hay quản lý máy tính. Cách thiết lập chi tiết nằm trong tài liệu 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.Dùng tài khoản bạn đã có
    3. C.Mỗi bot có một máy tính
    4. D.Bot hỏi trước khi làm
    5. E.Kết nối app
    6. F.Kênh, nhóm và đội dựng sẵn
    7. G.Bot biết nói
    8. H.Điều khiển bằng MCP và dòng lệnh
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cài CLI agent trước
    2. B.Tải bản cài
    3. C.Cài trên macOS
    4. D.Cài trên Windows
    5. E.Cài trên Ubuntu
    6. F.Nhập khoá và tạo bot
    7. G.Chạy từ mã nguồn (cho người muốn tự build)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop: một đội trợ lý theo mảng
    2. B.Nhân viên văn phòng: bot đọc mail, bạn duyệt
    3. C.Lập trình viên mới: giao việc cho bot có máy riêng
    4. D.Người làm tự động hoá: chạy bot từ script
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Provider bị làm mờ trong bộ chọn model
    2. B.Windows báo "unknown publisher"
    3. C.Ubuntu: bot không điều khiển được máy thật
    4. D.Gọi lệnh openmausbot không chạy
    5. E.Giọng đọc không phát
  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ỏ.