Nếu hay dùng claude, codex hay grok trong terminal, hẳn bạn từng phải mở nhiều tab rồi copy-paste qua lại giữa các bot. OpenMausBot gom các CLI đó thành từng đồng đội riêng trong một khung chat kiểu Telegram. Mọi thứ chạy ngay trên máy bạn. Prompt và secret không đi qua cloud bên thứ ba.
Khung chat chỉ nhận tin và hiện trạng thái. Phía sau là server Node.js tại 127.0.0.1:8799 giữ kết nối tới từng AI, dừng hỏi bạn trước thao tác rủi ro và lưu lịch sử về đĩa.
Bài viết đi theo hành trình một tin nhắn, cùng các ranh giới bảo mật, cách lưu secret và vài đánh đổi thực tế.

Chuyện gì xảy ra khi bạn gửi một tin nhắn?
OpenMausBot tách hẳn giao diện React khỏi tầng xử lý. Giao diện không gọi thẳng tới Anthropic, OpenAI hay xAI mà đẩy mọi yêu cầu qua server điều phối cục bộ.
flowchart LR
UI["Chat UI / CLI / openmausbot mcp"] -->|HTTP 127.0.0.1:8799| Server["Server Node.js"]
Server --> Registry["Bộ driver (31 driver)"]
Registry --> Claude["claude (stream-json)"]
Registry --> Codex["codex (app-server JSON-RPC)"]
Registry --> Grok["grok (ACP stdio / xAI API)"]
Server <--> Broker["Duyệt quyền & màn hình"]
Broker -->|Thẻ xin phép| UI
Server --> Bus["Event bus trung tâm"]
Bus -->|Log NDJSON| Disk["~/.openmausbot"]
Bus -->|1 luồng SSE| UI
Luồng xử lý gồm 6 bước:
- Giao diện gửi HTTP về cổng
8799(đổi quaOMB_PORThoặc--port; mặc định chỉ nhận kết nối nội bộ). - Server chuyển lượt tới bộ quản lý driver. OpenMausBot có tổng cộng 31 driver tích hợp sẵn, gồm
claude,codex,grokcùng các driver CLI, ACP và API tương thích OpenAI như Gemini, Kimi, Cursor, OpenCode hay endpoint tương thích Ollama. - Nếu cấu hình sai tên driver hoặc nạp lỗi, server không sập theo mà đánh dấu bot đó không khả dụng để các bot khác chạy tiếp.
- Driver gọi từng công cụ theo giao thức riêng:
claude: giữ tiến trình con theo hội thoại quastream-jsonhai chiều.codex: gọiapp-serverqua JSON-RPC trên luồng NDJSON và gửi ngược thẻ xin phép để bạn duyệt.grok: chạygrokCLI qua ACP bằng phiên đăng nhập sẵn trên máy, hoặc gọi thẳng API xAI qua API key.
- Tín hiệu trả về đi qua bộ điều phối sự kiện trung tâm để kiểm tra danh tính provider tránh lẫn luồng, tự che secret và gom đoạn chữ nhỏ theo nhịp 50 ms.
- Dữ liệu tách hai nhánh: một qua một luồng SSE duy nhất về giao diện, nhánh kia vào hàng đợi (tối đa 4.096 sự kiện hoặc 32 MiB) ghi log NDJSON theo hội thoại trong
~/.openmausbot.
Trình duyệt kiểm tra kết nối SSE treo sau 40 giây. Khi rớt mạng, nó tự nối lại kèm mã sự kiện cuối để server phát bù từ vùng đệm và giữ kết nối định kỳ.
Ranh giới bảo mật, quyền riêng tư và điều khiển máy tính
Chạy agent tại máy giúp giữ dữ liệu, nhưng bot bấm chuột hay chạy lệnh bừa sẽ tác động trực tiếp lên máy thật. OpenMausBot đặt nhiều chốt chặn tùy chế độ.
Xin phép từng lượt và giữ trạng thái trên RAM
Khi bot gọi công cụ nhạy cảm hoặc xin điều khiển màn hình (“Your Computer”), lượt chạy dừng lại ngay. Khung chat hiện thẻ xin phép: Allow once, Allow for this session (chỉ có khi thẻ cho phép) hoặc Deny.
Thẻ chờ duyệt chỉ nằm trên RAM, không ghi đĩa. Server kiểm tra lại chế độ truy cập trước và sau khi bàn giao quyền điều khiển máy; khởi động lại server sẽ hủy toàn bộ thẻ cũ.
Giới hạn điều khiển màn hình theo hệ điều hành
Điều khiển desktop cục bộ hiện chỉ hỗ trợ macOS 13 trở lên và Ubuntu Xorg. Trên Wayland tiêu chuẩn của Linux, tính năng này bị chặn hoàn toàn để bảo vệ phiên nhập liệu; ngoại lệ duy nhất là Hyprland bật plugin Cua.
Lưu API key: bản desktop và bản CLI khác hẳn nhau
Cách lưu secret khác nhau giữa bản desktop và CLI.
Ở chế độ CLI/server (openmausbot setup hoặc openmausbot serve), API key trong config.json và thông tin tunnel trong tunnel-account.json lưu dạng text thuần (plaintext) với quyền Unix 0600 (chỉ chủ sở hữu đọc được). Đó chỉ là phân quyền file, không phải mã hóa.
Trên bản desktop đóng gói (Electron), API key của nhà cung cấp AI và dịch vụ được hỗ trợ sẽ mã hóa qua trình quản lý khóa của hệ điều hành. Nếu môi trường đóng gói thiếu mã hóa OS thật, app từ chối lưu hoặc ghi đè credential chứ không từ chối khởi chạy toàn bộ app. Riêng máy Linux thiếu secret store hệ thống thì Electron chỉ dùng lớp che giấu cơ bản, và luồng đăng nhập cloud/managed trên desktop sẽ từ chối lớp fallback này.
Hai ngoại lệ trên desktop: khóa OpenCode provider, cấu hình ghi đè từng engine và header MCP vẫn nằm plaintext trong config.json; secret do bot tự lưu nằm trong Vault riêng, khóa bằng file key 0600 trên đĩa thay vì keychain.
Mở mạng LAN và giới hạn của MCP server
Mặc định server nghe trên 127.0.0.1. Bật --lan hoặc OMB_LAN=1 thì server nghe trên 0.0.0.0 qua HTTP thuần, và bộ lọc tầng socket sẽ ngắt kết nối nếu IP cả hai đầu không thuộc mạng riêng tư (RFC1918 hoặc link-local).
Lệnh openmausbot mcp chạy MCP server qua stdio cho IDE hoặc agent ngoài, trỏ về server cục bộ bằng OPENMAUSBOT_URL hoặc OMB_PORT (mặc định http://127.0.0.1:8799) kèm OPENMAUSBOT_TOKEN khi cần. Mọi địa chỉ public không dùng HTTPS đều bị từ chối.
MCP server chỉ được xem danh sách bot, tạo/sửa profile, gửi tin, chờ hội thoại xong, đổi model hoặc ngắt luồng. Nó không thể duyệt thẻ xin phép, ghi nhớ quyền, sửa secret, xóa dữ liệu hay điều khiển máy tính và máy ảo.
Cài đặt, cấu hình và các lệnh hay dùng
Có ba cách chạy OpenMausBot: bộ cài desktop, Node.js hoặc Docker.
Bản desktop hỗ trợ macOS (.dmg Apple Silicon và Intel, đã ký và notarize), Windows x64 (.exe), Ubuntu 24.04 x64 (.deb và AppImage đang beta) và Fedora x64 (.rpm). Với Docker, file compose.yaml dựng stack kèm Caddy qua Unix socket, mặc định bind tại 127.0.0.1:8080.
Chạy terminal cần Node.js 24 trở lên:
npm install -g openmausbot
# Hoặc chạy trực tiếp không cần cài toàn cục
npx openmausbotGói npm đã đóng gói sẵn phần CLI, server và giao diện đã build. Khi chạy npx openmausbot, npm chỉ tải thêm một vài gói native/WebAssembly cần thiết (ba dependency runtime) chứ không kéo theo cả cây node_modules cồng kềnh.
Workspace, lịch sử chat và config.json mặc định nằm tại ~/.openmausbot (đổi qua OMB_DATA_DIR hoặc --data-dir DIR):
- Khởi tạo và chạy server:
openmausbot setup(lần đầu),openmausbothoặcopenmausbot start(mở nhanh),openmausbot servevới--port 8799,--data-dir DIR,--local,--no-open,--no-pair,--lan. - Từ xa và ghép đôi: kết hợp
--public-url URL,--domain HOST,--tailscale,--tunnel,--relayvớiopenmausbot pair,openmausbot devices,openmausbot devices revoke ID; quản lý tunnel/relay quaopenmausbot account login,openmausbot account logout,openmausbot account status. - Script và dịch vụ nền:
openmausbot run,openmausbot send,openmausbot wait,openmausbot interrupt; kiểm tra máy và cài dịch vụ nền quaopenmausbot status,openmausbot doctor,openmausbot service install.
Một số giới hạn và đánh đổi cần cân nhắc
Có ba giới hạn thực tế bạn nên tính trước:
Thứ nhất, các lệnh CLI chạy nền/headless (như openmausbot send, openmausbot wait) và openmausbot mcp đều đòi hỏi server điều phối đang chạy sẵn trên máy (còn openmausbot, openmausbot start, openmausbot serve chính là lệnh khởi chạy server đó). Từ điện thoại, bạn không trỏ thẳng localhost được mà phải bật truy cập từ xa có HTTPS (--tunnel, --tailscale, --domain, --public-url) hoặc --relay; riêng --tunnel và --relay cần đăng nhập qua openmausbot account login.
Thứ hai, phần lõi dùng giấy phép Apache-2.0 (LICENSE, LICENSING.md), còn thư mục enterprise/ dùng OpenMausBot Enterprise License (source-available) và cần license key cho production. Gói npm đóng kèm thư mục này ở trạng thái vô hiệu khi thiếu key; muốn bản OSS thuần Apache-2.0, bạn chỉ cần xóa enterprise/.
Cuối cùng, so với các nền tảng agent cloud đóng như Grok Bot, Meta Muse, OpenAI dots hay Manus Cue, OpenMausBot không tiện kiểu “bấm là chạy”. Đổi lại, bạn tận dụng được gói đăng nhập CLI sẵn có (claude, codex, grok), giữ dữ liệu trên đĩa và nắm rõ ranh giới bảo mật từng phần. Nếu quen làm việc với terminal, đây là lựa chọn đáng cân nhắc.








