OpenMausBot
Mã nguồn mở bởi milind-soni
OpenMausBot là ứng dụng chat mã nguồn mở trong đó mỗi liên hệ là một AI agent, chạy bằng Claude Code, Codex hoặc Grok CLI có sẵn trên máy bạn. Mỗi bot có tính cách, mô hình, máy tính và ứng dụng kết nối riêng. Ứng dụng có bản desktop và có thể chạy thường trực trên VPS bằng Docker.
OpenMausBot dùng để làm gì?
- Tạo một nhóm bot AI, mỗi bot một vai trò, và trò chuyện với chúng như danh bạ chat
- Giao việc cho bot dùng máy tính đám mây, máy ảo cục bộ hoặc chính máy của bạn
- Duyệt hoặc từ chối từng lệnh shell, sửa file của bot ngay trong khung chat
- Nối bot với Gmail, Slack, GitHub, Notion qua Composio
- Hẹn bot chạy theo lịch, theo webhook hoặc khi có sự kiện từ ứng dụng kết nối
Giao diện
Ảnh và video lấy từ README của dự án trên GitHub, bản quyền thuộc nhóm phát triển.
Cần biết trước khi dùng
- Nghiêm trọng9 lỗ hổng đã biết trong dependency khai báo, trong đó mức Cao/Nghiêm trọng: GHSA-2m5v-pch6-74hx (undici@8.11.2, HIGH); GHSA-4w7w-5xrc-9h26 (undici@8.11.2, HIGH); GHSA-qrxm-fqhp-jwvm (undici@8.11.2, HIGH); GHSA-xjj6-f33q-929c (undici@8.11.2, HIGH). Phiên bản lấy từ file khai báo nên có thể khác bản thật khi cài.
- Lưu ýTino chưa kiểm thử việc cài ứng dụng này lên VPS.
Kiểm tra tự động ngày 04/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.
OpenMausBot là gì?
OpenMausBot lấy ý tưởng "AI là một ứng dụng nhắn tin": thanh bên là danh sách bot, mỗi bot là một agent thật với tính cách, bộ nhớ hội thoại, mô hình, máy tính và ứng dụng kết nối riêng. Thay vì tự gọi API, bot chạy qua các CLI claude, codex, grok đã cài và đăng nhập trên máy, nên dùng luôn tài khoản, gói thuê bao bạn đang có.
Ứng dụng gồm hai phần. Máy chủ harness chạy ở 127.0.0.1:8799, quản lý mọi tiến trình agent và gom sự kiện thành một luồng SSE. Giao diện React nhận luồng này qua HTTP. Mọi thao tác rủi ro (lệnh shell, sửa file, câu hỏi) đi qua một bộ môi giới quyền và hiện thành thẻ Allow/Deny trong chat. Bản ghi hội thoại, khoá và sự kiện lưu trong thư mục ~/.openmausbot.
Bản desktop có cho macOS, Windows và Ubuntu 24.04. Để bot làm việc cả khi laptop tắt, tài liệu hướng dẫn chạy trên VPS theo ba cách: đường hầm công khai do dự án cung cấp (cần tài khoản OpenMausBot), tên miền riêng qua Docker và Caddy, hoặc chỉ trong mạng Tailscale. Thiết bị đăng nhập bằng mã ghép nối (pairing) thay vì mật khẩu.
Mã nguồn theo giấy phép Apache 2.0, trừ thư mục enterprise/ dùng giấy phép riêng. Dự án độc lập, không liên kết với xAI; README cũng cảnh báo mọi đồng coin mang tên OpenMausBot hay Maus đều không liên quan tới dự án.
Nên dùng khi
- Bạn đã có Claude Code, Codex hoặc Grok CLI và muốn chia việc cho nhiều bot chuyên trách
- Bạn muốn bot chạy việc định kỳ trên VPS và theo dõi, duyệt từ laptop hoặc điện thoại
- Bạn cần agent dùng máy tính và ứng dụng kết nối nhưng vẫn duyệt từng thao tác quan trọng
Không nên dùng khi
- Bạn chưa có tài khoản hay gói thuê bao Claude, Codex hoặc Grok: bot cần ít nhất một CLI đã đăng nhập
- Bạn không chấp nhận việc agent chạy lệnh shell, dùng trình duyệt và giữ phiên đăng nhập các ứng dụng của bạn trên máy chủ
- Nhiều người dùng chung một máy chủ mà cần cách ly chặt: mọi tiến trình truy cập được 127.0.0.1:8799 đều có toàn quyền
- Bạn cần sản phẩm ổn định: README ghi dự án còn sớm, bản Ubuntu đang beta, điều khiển máy trên Ubuntu Wayland bị tắt
- Bạn không muốn phụ thuộc dịch vụ bên thứ ba: máy tính đám mây (Boat) tính phí sau thời gian dùng thử, ứng dụng kết nối đi qua Composio
Tính năng chính
- Chọn mô hình cho từng bot, đổi mô hình ngay giữa hội thoại; thêm CLI tuỳ chỉnh, endpoint tương thích OpenAI
- Máy tính riêng cho bot: Linux đám mây qua Boat, máy ảo cục bộ hoặc máy của bạn (macOS, Ubuntu Xorg, phải bật rõ ràng)
- Thẻ duyệt Allow/Deny cho lệnh shell, sửa file và câu hỏi của bot
- Kênh (channel) theo ngữ cảnh: mỗi kênh có hội thoại, chỉ dẫn chung, thư mục và danh sách bot riêng
- Trigger theo lịch, webhook và sự kiện từ ứng dụng kết nối
- Bot đọc câu trả lời thành tiếng và gọi thoại (ElevenLabs, Fish Audio, Grok, giọng Mac, Chatterbox)
- Chia sẻ, nhập cả nhóm bot bằng một file Markdown; khoá, mật khẩu không đi kèm
- Máy chủ MCP và lệnh openmausbot để điều khiển từ script, CI
Cách deploy OpenMausBot lên VPS bằng Docker
- Tạo VPS Chọn gói VPS 30 GB NVMe (2 vCPU · 2 GB RAM · 30 GB NVMe), hệ điều hành Ubuntu 24.04. VPS khởi tạo trong khoảng 5 phút. Tạo VPS cho OpenMausBot
-
Cài Docker trên VPS (Ubuntu 24.04)
Đăng nhập VPS bằng SSH với tài khoản root rồi chạy. Docker lấy từ kho phần mềm chính thức của Ubuntu.
apt update && apt install -y docker.io docker-compose-v2 git systemctl enable --now docker -
Trỏ tên miền và lấy file triển khai
Trước đó, tạo bản ghi A trỏ tên miền (ví dụ maus.example.com) về IP VPS và mở cổng 80, 443. Trong .env, DOMAIN là tên miền, ENGINES là danh sách gói CLI agent cài sẵn trong image, cách nhau bởi dấu cách.
git clone https://github.com/milind-soni/OpenMausBot && cd OpenMausBot/deploy cp .env.example .env nano .env # DOMAIN=maus.example.com ; ENGINES=@anthropic-ai/claude-code @openai/codex -
Khởi động
Chạy container omb (máy chủ harness) và Caddy. Caddy tự xin chứng chỉ HTTPS; sau khoảng một phút, tên miền hiện trang hỏi mã ghép nối.
docker compose pull omb && docker compose up -d docker compose ps # omb "healthy", caddy "running" -
Đăng nhập CLI agent trong container
Làm theo hướng dẫn đăng nhập của CLI. Với Codex, tài liệu dùng codex login --device-auth để đăng nhập trên máy chủ không có màn hình.
docker compose exec omb claude -
Tạo mã ghép nối cho thiết bị đầu tiên
Lệnh in mã và đường link dùng một lần. Mở link trên trình duyệt rồi bấm Connect; phiên ghép nối giữ 30 ngày và tự gia hạn khi dùng, tối đa 180 ngày.
docker compose exec omb node dist-server/openmausbot.js pair --label "My MacBook" -
Mở ứng dụng
Truy cập
https://TEN-MIEN-CUA-BAN (Caddy phục vụ HTTPS qua cổng 80, 443; không mở cổng 8799 ra ngoài)(thay IP-VPS bằng địa chỉ IP của VPS). Nên gắn tên miền và SSL trước khi dùng thật.
Lệnh cài ứng dụng chép từ README của dự án. Đọc trước khi chạy trên máy chủ thật.
Biến môi trường quan trọng
| Biến | Ý nghĩa |
|---|---|
DOMAIN | Tên miền trỏ về VPS, dùng để Caddy xin chứng chỉ HTTPS và tạo link ghép nối |
ENGINES | Các gói npm CLI agent cài vào image, ví dụ @anthropic-ai/claude-code @openai/codex; đổi thì phải build lại |
OMB_SIGNIN_EMAILS, OMB_SIGNIN_MEMBER_EMAILS | Email hoặc @tên-miền được đăng nhập bằng mã gửi qua email; admin toàn quyền, member chỉ chat và duyệt. Để trống thì chỉ dùng mã ghép nối |
OMB_SESSION_TTL_DAYS, OMB_SESSION_MAX_DAYS | Thời hạn phiên ghép nối (mặc định 30 ngày) và thời hạn tối đa (mặc định 180 ngày) |
OMB_WEBHOOK_PORT | Cổng nhận webhook, mặc định 8800 |
Cách dùng sau khi cài
- Ghép nối thiết bịTrình duyệt: mở link ghép nối rồi bấm Connect. Ứng dụng desktop: chép link, vào menu Server → Add Server from Copied Pairing Link…. Điện thoại: quét mã QR trong ứng dụng iOS hoặc dán link.
- Tạo bot và chọn mô hìnhTạo bot mới, đặt tính cách, chọn mô hình trong bộ chọn; các CLI đã đăng nhập tự xuất hiện trong danh sách.
- Duyệt thao tácKhi bot muốn chạy lệnh shell hay sửa file, chat hiện thẻ Allow/Deny để bạn quyết định.
- Bật trình duyệt và ứng dụng kết nốiBản Docker có sẵn Chrome; bật trong Settings → Computers và cho từng bot. Dán khoá Composio để nối Gmail, Slack, GitHub; khoá Boat để có máy tính Linux đám mây (tính phí sau dùng thử).
- Hẹn việc định kỳNói với bot, ví dụ "mỗi sáng thứ Hai tới thứ Sáu lúc 9 giờ tóm tắt hộp thư", bot tự tạo trigger; danh sách lịch và webhook nằm ở mục Triggers.
Cập nhật và sao lưu
Cập nhật: cd OpenMausBot/deploy && docker compose pull omb && docker compose up -d.
Sao lưu: dừng omb rồi nén volume dữ liệu (mặc định deploy_data, gồm cả thư mục đăng nhập của các CLI):
docker compose stop omb
backup_dir=$(mktemp -d "$PWD/openmausbot-backup.XXXXXX")
docker run --rm -v deploy_data:/data:ro -v "$backup_dir":/b alpine sh -c 'umask 077; tar czf /b/openmausbot-data.tgz -C /data .'
Sau đó chạy lại bằng docker compose start omb. Giữ file sao lưu ở nơi riêng tư vì có chứa phiên đăng nhập.
Câu hỏi thường gặp
OpenMausBot có phải sản phẩm của xAI hay Grok không?
Không. Đâ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. README cũng nói dự án không phát hành coin hay token nào.
Dùng OpenMausBot có tốn tiền không?
Phần mềm miễn phí theo Apache 2.0. Chi phí nằm ở gói Claude, Codex, Grok bạn dùng cho bot, cùng các dịch vụ tuỳ chọn như Boat (tính phí sau dùng thử), ElevenLabs, Fish Audio.
Nên cài trên máy tính hay trên VPS?
Cài bản desktop nếu chỉ dùng khi đang ngồi máy. Cài trên VPS nếu muốn bot chạy việc định kỳ cả khi laptop tắt và truy cập từ điện thoại.
Đưa máy chủ OpenMausBot ra Internet có an toàn không?
Chỉ nên đi qua Caddy, đường hầm của dự án hoặc Tailscale. Tài liệu cảnh báo không bao giờ mở cổng 8799 ra ngoài, vì ai vào được cổng này có toàn quyền, kể cả shell mà bot dùng.
Bản Windows có bị báo không an toàn khi cài không?
Có. Bộ cài Windows chưa ký số nên SmartScreen báo "unknown publisher"; README hướng dẫn chọn More info → Run anyway.
Ứng dụng liên quan
Miễn trừ trách nhiệm
Tino không phát triển, không sở hữu và không liên kết với OpenMausBot hay nhóm phát triển milind-soni. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.
OpenMausBot được phân phối theo giấy phép Apache-2.0 của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.
Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.
