OpenBot: tạo đội trợ lý AI chạy ngay trên máy bạn — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về nightly-labs/openbot — 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: OpenBot: không gian làm việc cho trợ lý AI chạy trên máy bạn — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
OpenBot là ứng dụng desktop mã nguồn TypeScript, giúp bạn chạy nhiều trợ lý AI bền vững như Codex, Claude Code, Grok ngay trên máy, mỗi trợ lý có thư mục làm việc, hàng đợi tin nhắn và trình duyệt riêng. Bạn dùng nó để giao việc, chuyển file và cho các trợ lý phối hợp với nhau. Cài khá dễ: tải bộ cài cho macOS, Windows hoặc Linux về chạy, rồi đăng nhập nhà cung cấp AI bạn muốn dùng.
OpenBot là một ứng dụng desktop "ưu tiên chạy trên máy bạn" (local-first), dùng để nuôi các đồng nghiệp AI chạy lâu dài. Mỗi trợ lý (agent) có một cuộc trò chuyện riêng, một thư mục làm việc riêng, và bạn quản lý tất cả trong một cửa sổ duy nhất. Bên dưới, OpenBot điều khiển các công cụ AI có sẵn như Codex, Claude Code, Grok CLI, OpenCode, Gemini và một số nhà cung cấp khác.
Ai nên dùng? Người đã quen hỏi đáp với một chatbot nhưng muốn tiến thêm một bước: giao việc cho nhiều trợ lý cùng lúc, xếp hàng việc, cho chúng gửi file và nhắn tin cho nhau. Lập trình viên mới, chủ shop thích tự động hoá, nhân viên văn phòng thích thử công cụ mới đều có thể bắt đầu. Bạn không phải gõ lệnh để cài, chỉ cần tải bộ cài về chạy.
Điểm đáng giá nhất là gom mọi thứ vào một chỗ: hàng đợi việc, chuyển file, trình duyệt nhúng và nhắn tin giữa các agent. Tác giả cho biết repo hiện có khoảng 7.353 sao và 741 fork, và cập nhật rất thường xuyên. Xem video ngắn bên dưới để thấy giao diện chạy thật trước khi cài.
nightly-labs/openbot
OpenBot là ứng dụng desktop để nuôi nhiều trợ lý AI (Codex, Claude, Grok…), mỗi trợ lý có không gian riêng, hàng đợi việc, trình duyệt nhúng và nhắn tin với nhau.
I.OpenBot làm được gì
Dưới đây là các tính năng chính, giải thích theo lợi ích thực tế.
- Tạo và sửa agent bằng câu lệnh thường. Bạn mô tả trợ lý mình muốn, OpenBot dựng ra phần hướng dẫn (instructions), ảnh đại diện, và cho bạn xem lại từng phần trước khi lưu. Việc này có trên cả desktop lẫn điện thoại.
- Agent bền vững, tách biệt. Mỗi agent chạy phiên riêng với Codex, Claude, Grok, OpenCode, Gemini, Cursor, Cline, Kimi, Devin, GitHub Copilot, Mistral hoặc Hermes, cùng một không gian làm việc cục bộ. Nhờ vậy trợ lý làm việc marketing không lẫn với trợ lý viết code.
- Dùng được model tự chọn. OpenBot hỗ trợ endpoint tương thích OpenAI, agent ACP tự khai báo, và nhận diện máy chủ model cục bộ như Ollama, LM Studio.
- Theo dõi ngữ cảnh. Mỗi agent có đồng hồ ngữ cảnh, và OpenBot tự nén (compaction) trước khi cuộc trò chuyện dài làm đầy cửa sổ của model.
- Hàng đợi tin nhắn. Việc xếp theo thứ tự vào trước ra trước (FIFO), có tạm dừng, tiếp tục, huỷ, và lưu an toàn nếu app bị tắt đột ngột. Bạn có thể giao một loạt việc rồi đi làm chuyện khác.
- Agent nhắn tin cho nhau. Chúng gửi tin, trả lời, thả reaction, gửi ảnh và chuyển file có quản lý.
- Kênh chat chung. Một kênh có một người nhận việc (task owner), có giao việc rõ ràng, lịch sử chung, và các nút Stop, Resume, Reassign, Archive, Restore.
- Trình duyệt nhúng. Một trình duyệt bền vững mà agent có thể mở, xem và điều khiển.
- Computer Use (tuỳ chọn). Trên macOS, Windows và Linux, thông qua tệp
cua-drivercó trong bản phát hành. OpenBot tự khởi động tệp này như một tiến trình con. - Dữ liệu và riêng tư. Có chức năng xuất dữ liệu cục bộ và bản chẩn đoán đã lược thông tin nhạy cảm ngay trong menu tài khoản. Tài khoản OpenBot là tuỳ chọn, đăng nhập bằng mã gửi qua email một lần.
Lưu ý đừng hiểu nhầm: "local-first" không có nghĩa là chạy offline. Codex kết nối tới OpenAI, Claude tới Anthropic, Grok tới xAI, Gemini tới Google, và các trang web mà trình duyệt nhúng mở vẫn dùng mạng.
Theo README, agent chạy với quyền danger-full-access và approvalPolicy: never. Nghĩa là sau lần đồng ý đầu tiên, chúng có thể đọc và sửa file, chạy lệnh, dùng mạng và điều khiển trình duyệt nhúng mà không hỏi lại từng hành động. Chỉ giao việc bạn tin tưởng, luôn có bản sao lưu, và đọc phần Security của repo trước khi dùng.
II.Cần chuẩn bị gì
Theo README, OpenBot hỗ trợ:
- macOS 13 trở lên, chip Apple silicon hoặc Intel.
- Windows 10 trở lên, bản x64.
- Linux x64 hoặc arm64, dưới dạng AppImage.
Bạn cần thêm một nhà cung cấp AI để các agent có "bộ não". README nói OpenBot có thể tự tải phần chạy (runtime) của nhà cung cấp khi bạn bấm Download trong màn hình onboarding, Settings, màn hình tạo agent hoặc bộ chọn model. Mỗi nhà cung cấp có yêu cầu đăng nhập riêng:
- Codex kết nối OpenAI, Claude kết nối Anthropic, Grok dùng
grok loginhoặc biến môi trườngXAI_API_KEY. - OpenCode có model miễn phí (nhãn Free) không cần tài khoản. Model trả phí cần khoá OpenCode Go.
- Gemini cần gói Google AI Pro hoặc Ultra.
- Cursor cần gói Cursor hoặc khoá
CURSOR_API_KEY. Cline cần tài khoản Cline. - Các nhà cung cấp còn lại (Kimi, Devin, GitHub Copilot, Mistral) đều cần tài khoản tương ứng.
- Hermes dùng bản Hermes Agent bạn tự cài.
Về phần cứng, tư liệu chưa nêu yêu cầu RAM hay GPU cụ thể. Chỉ khi chạy từ mã nguồn thì package.json yêu cầu Node từ 24.0.0 trở lên. Người dùng bình thường không cần cài Node để dùng bộ cài sẵn.
III.Cài đặt từng bước
- Tải bộ càiVào trang Releases của repo, chọn tệp đúng hệ điều hành
- Cài và mở appKéo vào Applications (macOS), chạy installer (Windows) hoặc chmod +x rồi chạy AppImage (Linux)
- Đồng ý lần đầuĐọc kỹ cảnh báo quyền toàn phần rồi mới đồng ý
- Tải runtime nhà cung cấpBấm Download trong onboarding hoặc Settings, rồi đăng nhập
- Tạo agent đầu tiênMô tả trợ lý bằng một câu và lưu lại
A.Bước 1: Tải bộ cài đúng máy
Vào trang GitHub Releases của dự án (nút repo do hệ thống hiển thị trên trang này). Chọn tệp theo máy bạn:
- Mac chip Apple:
OpenBot-*-arm64.dmg. Mac Intel:OpenBot-*-x64.dmg. - Windows:
OpenBot-*-x64.exe. - Linux:
OpenBot-*-x86_64.AppImage, hoặcOpenBot-*-arm64.AppImagetrên arm64.
Dấu * là số phiên bản, thay đổi theo từng bản phát hành.
B.Bước 2: Cài và mở app
Trên macOS, mở tệp dmg rồi kéo OpenBot vào Applications và mở. Trên Windows, chạy installer rồi mở OpenBot. README lưu ý bản Windows được ký bởi SYNTHETIFY LABS SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ, nhưng SmartScreen vẫn có thể cảnh báo ở bản mới. Hãy kiểm tra checksum hoặc chứng nhận build trên GitHub trước khi chạy.
Trên Linux, mở terminal ở thư mục chứa tệp vừa tải và chạy:
chmod +x OpenBot-*.AppImageLệnh này cho phép tệp được thực thi. Sau đó chạy tệp AppImage đó. README cho biết AppImage không cần libfuse2 nên chạy được cả trên Arch Linux, nó tự mount bằng fusermount3 trong gói fuse3.
Nếu bạn dùng Ubuntu 23.10 trở lên hoặc Debian 13, AppArmor hạn chế user namespace và OpenBot sẽ tự thoát khi khởi động. Khi đó cần cài profile AppArmor, chạy từ thư mục gốc của repo đã tải về:
sudo install -m 0644 build/linux/openbot.apparmor /etc/apparmor.d/openbot
sudo systemctl reload apparmorREADME nhấn mạnh: không chạy OpenBot với --no-sandbox, vì cờ đó phá lớp ngăn cách giữa renderer và phần còn lại của máy.
C.Bước 3: Lần mở đầu tiên
App sẽ hỏi bạn đồng ý về quyền toàn phần của agent. Đây là bước quan trọng nhất, hãy đọc kỹ thay vì bấm qua. Trên Linux AppImage, lần đầu app cũng tạo hai tệp ~/.local/share/applications/openbot.desktop và ~/.local/share/icons/openbot.png để liên kết openbot:// mở được app. Muốn hoàn tác thì xoá hai tệp này.
D.Bước 4: Lấy runtime và đăng nhập nhà cung cấp
Trong onboarding hoặc Settings, chọn nhà cung cấp bạn muốn rồi bấm Download. Sau đó bấm Sign in (hoặc Connect). Ví dụ với OpenCode, README nói model có nhãn Free không cần đăng nhập: chọn OpenCode, bấm Connect, OpenBot sẽ đọc danh sách model mà CLI đưa ra.
Nếu bạn muốn tự cài CLI, README ghi lệnh cho macOS:
curl -fsSL https://chatgpt.com/codex/install.sh | shĐây là lệnh cài Codex CLI.
curl -fsSL https://claude.ai/install.sh | bashĐây là lệnh cài Claude CLI. Với Grok, README bảo làm theo tài liệu Grok Build, rồi đăng nhập bằng grok login hoặc đặt XAI_API_KEY trong môi trường dùng để mở OpenBot.
E.Bước 5: Các cách cài khác
Với máy chủ Linux không màn hình (VPS hoặc máy chủ gia đình, Ubuntu 24.04 hoặc 26.04 có systemd), README ghi:
curl -fsSL https://raw.githubusercontent.com/nightly-labs/openbot/main/scripts/install-server.sh | sudo bash
sudo openbot loginDòng đầu cài, dòng sau đăng nhập bằng mã gửi qua email. Sau đó bạn dùng từ app desktop, app iPhone hoặc openbot.run/app. Cách chạy bằng Docker:
curl -fsSLO https://raw.githubusercontent.com/nightly-labs/openbot/main/docker/seccomp.json
docker run -d --name openbot --restart unless-stopped \
--security-opt seccomp=seccomp.json --security-opt no-new-privileges:true \
--shm-size 1g --stop-timeout 60 -v openbot-data:/data \
ghcr.io/nightly-labs/openbot:latest
docker exec -it openbot openbot loginVới Nix:
nix run github:nightly-labs/openbot
nix profile install github:nightly-labs/openbotREADME nói OpenBot không phải phần mềm tự do, nên nixpkgs của bạn phải cho phép, ví dụ nixpkgs.config.allowUnfreePredicate = pkg: lib.getName pkg == "openbot";. Nếu bạn mới dùng, hãy chọn bộ cài desktop ở bước 1 cho đơn giản.
IV.Kiểm tra đã chạy được chưa
README chưa mô tả một lệnh kiểm tra riêng. Với bản desktop, bạn biết cài thành công khi:
- App mở ra được và qua màn hình onboarding mà không tự thoát.
- Trong Settings hoặc More providers, nhà cung cấp bạn chọn hiện trạng thái đã tải và đã đăng nhập (Download, Sign in hoặc Connect đã hoàn tất).
- Bạn tạo được một agent, gửi một câu và nhận được phản hồi.
Với bản máy chủ hoặc Docker, lệnh sudo openbot login (hoặc docker exec -it openbot openbot login) hoàn tất bằng mã email là dấu hiệu tốt. Phần self-hosted servers và Docker trong thư mục docs của repo có thêm lệnh openbot để kiểm tra.
V.Dùng vào việc thật
Các tình huống dưới đây bám theo khả năng được ghi trong README. Câu lệnh mẫu là gợi ý của mình, bạn sửa theo việc của bạn.
A.Chủ shop nhờ trợ lý soạn mô tả sản phẩm hàng loạt
Bạn bán đồ gia dụng online và có hai mươi sản phẩm cần mô tả mới. Tạo một agent tên "Biên tập viên" bằng câu: "Tạo trợ lý viết mô tả sản phẩm giọng thân thiện, ngắn gọn, mỗi mô tả dưới 120 chữ". Xem lại phần instructions OpenBot dựng ra, sửa nếu cần rồi lưu. Sau đó đẩy từng sản phẩm vào hàng đợi. Vì hàng đợi chạy lần lượt, bạn có thể bỏ đi uống cà phê. Nếu thấy một mục sai hướng, bạn tạm dừng hoặc huỷ nó mà không mất các mục sau.
Giao việc cho AI không khó, cái khó là biết nó đang làm gì, và hàng đợi có nút dừng chính là thứ làm mình yên tâm.
Ông T
B.Nhân viên văn phòng cho hai agent phối hợp
Bạn cần tổng hợp báo cáo hằng tuần. Tạo một agent "Thu thập" chuyên đọc các tệp số liệu, và một agent "Biên soạn" chuyên viết báo cáo. Nhờ tính năng chuyển file có quản lý và nhắn tin giữa agent, "Thu thập" gửi bảng đã làm sạch sang cho "Biên soạn". Bạn chỉ cần xem kết quả cuối. Khi cần đổi người phụ trách, dùng kênh chat chung với nút Reassign.
C.Lập trình viên mới giao nhiều việc song song
Bạn đang học và có một dự án nhỏ. Mở hai agent, một dùng Claude để giải thích mã, một dùng Codex để viết thử nghiệm. Mỗi agent có thư mục làm việc riêng nên không giẫm chân nhau. Nhờ đồng hồ ngữ cảnh, bạn thấy khi nào cuộc trò chuyện sắp đầy, còn OpenBot tự nén trước khi hết chỗ. Vì agent có quyền toàn phần, hãy làm trên bản sao dự án, đừng trỏ vào thư mục duy nhất của bạn.
D.Nhờ trợ lý tra cứu web bằng trình duyệt nhúng
Bạn cần so sánh giá nhà cung cấp. Nhờ agent: "Mở trình duyệt, tìm ba nhà cung cấp phổ biến cho mặt hàng này và tóm tắt giá, điều kiện giao hàng". Agent mở và điều khiển trình duyệt nhúng bền vững, bạn xem được trang nó đang xem. Kết quả là một bản tóm tắt trong cuộc trò chuyện. Đừng để agent đăng nhập các tài khoản quan trọng của bạn trong trình duyệt này.
VI.Lỗi hay gặp và cách xử lý
OpenBot tự thoát ngay khi mở trên Ubuntu 23.10+ hoặc Debian 13. Nguyên nhân là AppArmor chặn user namespace. Cài profile bằng hai lệnh sudo install ... và sudo systemctl reload apparmor ở trên. Không giải quyết bằng --no-sandbox.
Windows hiện cảnh báo SmartScreen. README nói bản mới vẫn có thể bị cảnh báo, và các bản cũ chưa ký. Chỉ tải từ trang Releases chính thức và kiểm tra checksum hoặc chứng nhận build trên GitHub trước khi chạy.
Agent báo lỗi nêu tên một nhà cung cấp. Với OpenCode, model không có nhãn Free cần đăng nhập: khoá Go cho model opencode-go/, hoặc opencode auth login trong terminal cho các nhà cung cấp khác. Chưa đăng nhập thì lượt trả lời sẽ lỗi và nêu tên nhà cung cấp. Hãy đăng nhập đúng nhà cung cấp đó trong Settings.
Đăng nhập Gemini trên máy chủ không có màn hình thất bại. Google gửi callback về 127.0.0.1 trên chính máy đó, nên cần trình duyệt desktop và xdg-utils, và phải mở trang đăng nhập trong phiên desktop trên cùng máy. Máy chủ không có desktop không hoàn tất được bước này. Hãy đăng nhập ở máy có trình duyệt, theo hướng dẫn Gemini setup trong docs của repo.
Remote desktop không chạy trên Linux. Tính năng này chỉ hoạt động trên Linux x64 trong phiên X11, không chạy dưới Wayland, và bản arm64 AppImage không có nó. Đổi sang phiên X11 hoặc bỏ qua tính năng này.
VII.Có nên dùng không
Điểm mạnh. Một giao diện duy nhất cho rất nhiều nhà cung cấp AI. Có hàng đợi bền vững, trình duyệt nhúng, chuyển file và kênh chat chung. Hỗ trợ cả desktop, máy chủ, Docker và Nix. Repo cập nhật đều và README nói bản mới ra gần như mỗi ngày.
Giới hạn. Quyền của agent rất rộng và không hỏi từng hành động, nên rủi ro nằm ở việc bạn giao gì. Bạn vẫn cần tài khoản hoặc khoá của nhà cung cấp, và có thể phát sinh chi phí tuỳ gói bạn dùng. README ghi rõ đây không phải phần mềm tự do và không nêu rõ giấy phép ở phần tư liệu mình có, nên nếu bạn cần dùng cho doanh nghiệp, hãy đọc tệp LICENSE trong repo. Với Cline, README cảnh báo nhà cung cấp model miễn phí có thể dùng prompt của bạn để huấn luyện model.
Khi nào chọn cách khác. Nếu bạn chỉ cần hỏi đáp thỉnh thoảng, một chatbot web là đủ và an toàn hơn. Nếu bạn cần kiểm soát từng thao tác trước khi chạy, hãy dùng công cụ có bước xác nhận. Còn nếu bạn muốn thử cách làm việc với nhiều trợ lý AI nhưng vẫn giữ dữ liệu và thư mục trên máy mình, OpenBot đáng thử, miễn là bạn thử trên dữ liệu đã sao lưu.
Câu hỏi thường gặp
OpenBot có miễn phí không?
README không nêu giá của chính OpenBot, và cho biết đây không phải phần mềm tự do. Mỗi nhà cung cấp AI có chi phí riêng: OpenCode có model miễn phí không cần tài khoản, Cline có model miễn phí với giới hạn, còn Gemini cần gói Google AI Pro hoặc Ultra. Bạn nên xem lại điều khoản trước khi dùng cho công việc.
OpenBot chạy được trên Windows không?
Được. README ghi hỗ trợ Windows 10 trở lên, bản x64, qua tệp OpenBot-*-x64.exe tải ở trang Releases. Ngoài ra còn có macOS 13 trở lên và Linux (AppImage x64 hoặc arm64). SmartScreen có thể cảnh báo ở bản mới, nên hãy kiểm tra checksum.
Có cần GPU hay máy cấu hình mạnh không?
Tư liệu chưa nêu yêu cầu GPU hay RAM. Các agent chủ yếu gọi model của nhà cung cấp qua mạng như OpenAI, Anthropic, xAI. README cũng nhắc OpenBot nhận diện được máy chủ model cục bộ như Ollama và LM Studio, nhưng yêu cầu phần cứng cho phần đó phụ thuộc vào model bạn chọn.
Dữ liệu của tôi có an toàn không?
OpenBot là local-first: workspace và hàng đợi nằm trên máy bạn, nhưng không phải offline-only vì các agent vẫn kết nối nhà cung cấp AI và trình duyệt dùng mạng. README cảnh báo agent chạy với quyền toàn phần và không hỏi từng hành động, nên hãy sao lưu và chỉ giao việc bạn tin tưởng. Repo có tệp PRIVACY.md và SECURITY.md để đọc thêm.
Khác gì việc dùng thẳng Claude Code hoặc Codex?
Claude Code và Codex là công cụ AI riêng lẻ. OpenBot đặt chúng vào một giao diện chung, thêm hàng đợi, kênh chat, chuyển file, trình duyệt nhúng và cho các agent nhắn tin với nhau. Nó cũng gộp nhiều nhà cung cấp khác như Grok, Gemini, Cursor vào cùng một chỗ.
Tôi có cần cài Node hay biết lập trình không?
Dùng bộ cài desktop thì README không yêu cầu bạn tự cài Node. Package.json yêu cầu Node từ 24.0.0 trở lên chỉ liên quan khi bạn chạy từ mã nguồn. Cài bằng bộ cài, rồi tạo agent bằng câu lệnh thường, là đủ để bắt đầu.
Có chạy được trên máy chủ không cần màn hình không?
Có. README có script cài cho máy chủ Linux (Ubuntu 24.04 hoặc 26.04 có systemd) và cách chạy Docker cho linux/amd64 và linux/arm64. Bạn đăng nhập bằng `openbot login` qua mã email rồi dùng từ app desktop, app iPhone hoặc openbot.run/app.


