OpenBot: độ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 chạy local-first, cho bạn tạo nhiều trợ lý AI "đồng đội" dùng Codex, Claude Code, Grok và nhiều CLI khác, mỗi trợ lý có thư mục làm việc và cuộc trò chuyện riêng. Bạn có thể cài bằng file tải từ GitHub Releases cho macOS, Windows, Linux nên khá dễ. Điểm cần cẩn thận là các agent chạy với toàn quyền trên máy.
OpenBot là một ứng dụng desktop giúp bạn quản lý nhiều trợ lý AI chạy lâu dài trên máy mình, mỗi trợ lý như một đồng nghiệp có chỗ làm việc riêng. Nó không tự có "bộ não" riêng mà đứng ra điều phối các công cụ AI có sẵn như Codex, Claude Code, Grok CLI, OpenCode, Gemini, Cursor CLI và nhiều CLI khác.
Vấn đề nó giải quyết khá đời thường. Khi dùng AI agent trong terminal, bạn thường mở mỗi công cụ một cửa sổ, việc nào lẫn việc đó, đóng máy là mất mạch. OpenBot gom tất cả vào một ứng dụng: mỗi agent có hội thoại riêng, hàng đợi việc, chia sẻ file và cả trình duyệt nhúng để agent mở web, đọc và thao tác.
Người nên thử là dev, người làm tự động hoá, hoặc người đã quen dùng Claude hay Codex và muốn có "một nhóm trợ lý" thay vì một khung chat. Điểm đáng giá nhất: cài như app bình thường, tải về và mở lên, không cần biết lập trình. Mặt trái là agent chạy với quyền rất rộng, nên bạn cần đọc kỹ phần lưu ý an toàn bên dưới. Bạn có thể xem video ngắn bên dưới để thấy giao diện trước khi cài.
nightly-labs/openbot
OpenBot là ứng dụng desktop để chạy nhiều trợ lý AI bền vững (Codex, Claude, Grok...), mỗi trợ lý có không gian làm việc, hàng đợi việc và trình duyệt riêng.
I.OpenBot làm được gì
Dưới đây là các tính năng chính, kèm lợi ích thực tế khi dùng.
- Tạo và chỉnh agent bằng câu lệnh tự nhiên. Bạn mô tả trợ lý mình muốn, OpenBot dựng sẵn hướng dẫn, ảnh đại diện và các phần để bạn xem lại trước khi lưu. Làm được trên cả desktop lẫn điện thoại.
- Agent bền vững, mỗi agent một phiên riêng. Mỗi agent dựa trên một phiên độc lập của Codex, Claude, Grok, OpenCode, Gemini, Cursor, Cline, Kimi, Devin, GitHub Copilot, Mistral hoặc Hermes, cùng thư mục làm việc cục bộ. Việc của trợ lý này không lẫn sang trợ lý khác.
- Dùng được nhiều nguồn mô hình. Ngoài các nhà cung cấp trên, OpenBot hỗ trợ endpoint tương thích OpenAI tự khai báo, agent ACP tự chọn, và có phát hiện máy chủ mô hình cục bộ như Ollama, LM Studio.
- Theo dõi ngữ cảnh và tự nén. Với mỗi agent, OpenBot theo dõi mức dùng ngữ cảnh và tự nén lại trước khi cuộc trò chuyện dài làm đầy cửa sổ của mô hình. Bạn đỡ phải tự cắt hội thoại.
- Hàng đợi việc kiểu vào trước ra trước. Có tạm dừng, tiếp tục, huỷ, và lưu bền để lỡ máy sập cũng không mất việc đã xếp.
- Agent nhắn tin cho nhau. Gồm trả lời, thả cảm xúc, gửi ảnh và chuyển file có quản lý. Bạn có thể cho một agent soạn thảo, agent khác kiểm tra.
- Kênh chat chung. Một kênh có một chủ việ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 bền vững. Agent có thể mở, xem và điều khiển trình duyệt này.
- Computer Use (tuỳ chọn). Trên macOS, Windows và Linux, qua file
cua-driverđi kèm bản phát hành. OpenBot tự khởi chạy nó như tiến trình con và cung cấp cho mọi nhà cung cấp. - Xuất dữ liệu và chẩn đoán an toàn riêng tư từ menu tài khoản.
- Tài khoản OpenBot tuỳ chọn đăng nhập bằng mã email dùng một lần.
Hiện repo có khoảng 7.353 sao và 741 fork, và README cho biết gần như mỗi ngày có một bản phát hành mới.
II.Cần chuẩn bị gì
Theo README, bạn cần một trong các hệ điều hành sau:
- 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ạng AppImage.
Ngoài ra:
- Tài khoản của nhà cung cấp AI bạn muốn dùng. Codex kết nối OpenAI, Claude kết nối Anthropic, Grok kết nối xAI, Gemini kết nối Google, và tương tự cho Cursor, Cline, Kimi, Devin, GitHub Copilot, Mistral, Hermes. Một số có mô hình miễn phí có giới hạn, ví dụ OpenCode có mô hình Free không cần đăng nhập, Cline có mô hình miễn phí theo hạn mức.
- Gemini dùng gói Google AI Pro hoặc Ultra.
- Cursor dùng gói Cursor hoặc API key của Cursor.
- Node.js 24 trở lên chỉ cần nếu bạn muốn tự build từ mã nguồn, vì
package.jsonghi yêu cầu Node >=24.0.0. Cài bằng file phát hành thì README không đòi bạn cài Node. - README chưa nêu yêu cầu phần cứng như GPU hay dung lượng RAM trong phần mình có.
OpenBot là local-first, không phải offline hoàn toàn. Prompt của bạn vẫn đi tới nhà cung cấp AI bạn chọn, trang web agent mở vẫn dùng mạng. Với mô hình miễn phí của Cline, README nói nhà cung cấp mô hình đó có thể dùng prompt của bạn để huấn luyện mô hình. Đừng đưa dữ liệu nhạy cảm vào.
III.Cài đặt từng bước
- Tải bản càiVào GitHub Releases của repo, chọn file đúng hệ điều hành
- Cài và mở appKéo vào Applications (macOS), chạy file .exe (Windows) hoặc chmod rồi chạy AppImage (Linux)
- Đồng ý điều khoản lần đầuĐọc kỹ cảnh báo quyền truy cập đầy đủ của agent
- Tải runtime nhà cung cấpBấm Download ở phần onboarding hoặc Settings cho nhà cung cấp bạn dùng
- Đăng nhậpĐăng nhập tài khoản hoặc dán API key của nhà cung cấp
A.Tải file cài đặt đúng loại
Vào trang GitHub Releases của repo nightly-labs/openbot và tải file theo máy bạn:
- macOS chip Apple: file
OpenBot-*-arm64.dmg. Mac Intel:OpenBot-*-x64.dmg. - Windows: file
OpenBot-*-x64.exe. - Linux:
OpenBot-*-x86_64.AppImage, hoặcOpenBot-*-arm64.AppImagenếu máy arm64.
Chỗ người mới hay vấp là chọn nhầm kiến trúc. Nếu không chắc Mac của mình dùng chip nào, hãy xem mục About This Mac trước khi tải.
B.Cài trên macOS và Windows
Trên macOS, mở file .dmg, kéo OpenBot vào Applications rồi mở app. Trên Windows, chạy file .exe và mở OpenBot sau khi cài xong. Cả hai không cần gõ lệnh.
Với Windows, README lưu ý các bản phát hành mới được ký bởi một công ty tên SYNTHETIFY LABS SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ, còn bản cũ chưa ký. SmartScreen vẫn có thể cảnh báo với bản mới. Hãy kiểm tra checksum của bản phát hành hoặc chứng thực build của GitHub trước khi chạy.
C.Cài trên Linux (AppImage)
Mở terminal ở thư mục chứa file vừa tải, cấp quyền chạy rồi chạy file:
chmod +x OpenBot-*.AppImageLệnh trên cho phép file được thực thi. Sau đó chạy file AppImage vừa tải. README nói AppImage không cần libfuse2 nên cũng chạy được trên Arch Linux và Omarchy.
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ẽ thoát ngay khi khởi động cho tới khi bạn cài profile AppArmor. Chạy lệnh sau từ thư mục repo (cần có file build/linux/openbot.apparmor, cũng có trong AppImage tại resources/linux/openbot.apparmor):
sudo install -m 0644 build/linux/openbot.apparmor /etc/apparmor.d/openbot
sudo systemctl reload apparmorLệnh đầu chép profile vào đúng chỗ của hệ thống, lệnh sau nạp lại AppArmor. Nếu bạn để AppImage ở chỗ không quen thuộc, README bảo sửa đường dẫn gắn kết trong profile. Đừng bao giờ chạy OpenBot với --no-sandbox, vì nó gỡ bỏ ranh giới giữa tiến trình giao diện và phần còn lại của máy.
Lần đầu chạy từ AppImage, OpenBot tạo hai file ~/.local/share/applications/openbot.desktop và ~/.local/share/icons/openbot.png. Xoá hai file này là hoàn tác.
D.Cài bằng Nix, server Linux hoặc Docker (tuỳ chọn)
Nếu bạn dùng Nix:
nix run github:nightly-labs/openbot
nix profile install github:nightly-labs/openbotVì OpenBot không phải phần mềm tự do, nixpkgs của bạn phải cho phép gói này, ví dụ:
nixpkgs.config.allowUnfreePredicate = pkg: lib.getName pkg == "openbot";Nếu muốn chạy OpenBot như máy chủ luôn bật trên VPS hay máy nhà (Ubuntu 24.04 hoặc 26.04 có systemd), cài từ terminal rồi đăng nhập bằng mã email:
curl -fsSL https://raw.githubusercontent.com/nightly-labs/openbot/main/scripts/install-server.sh | sudo bash
sudo openbot loginSau đó dùng từ app desktop, app iPhone hoặc openbot.run/app. Còn nếu thích Docker (linux/amd64 và linux/arm64):
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 loginLệnh đầu tải file seccomp để giữ sandbox của Electron bật, lệnh thứ hai chạy container có volume openbot-data giữ dữ liệu, lệnh cuối đăng nhập. Chi tiết về Compose, nâng cấp và giới hạn bảo mật xem trong thư mục docs/ của repo.
E.Cài runtime cho nhà cung cấp AI
OpenBot có thể tự tải runtime của nhà cung cấp khi bạn chọn Download trong phần onboarding, Settings, thiết lập agent hoặc bộ chọn mô hình. Nó ưu tiên bản CLI do chính nó quản lý. Nếu bạn thích tự cài, README đưa các lệnh trên macOS:
curl -fsSL https://chatgpt.com/codex/install.sh | shcurl -fsSL https://claude.ai/install.sh | bashCái đầu cài Codex CLI, cái sau cài Claude CLI. Với Grok, README bảo cài theo tài liệu Grok Build rồi đăng nhập bằng grok login, hoặc đặt biến môi trường XAI_API_KEY trong môi trường dùng để khởi chạy OpenBot. Với các nhà cung cấp còn lại (Cursor, Cline, Kimi, Devin, Copilot, Mistral), cách đơn giản nhất là bấm Download ở hàng của nhà cung cấp trong mục More providers, rồi bấm Sign in để đăng nhập qua trình duyệt.
Chỗ dễ vấp: nếu bạn đặt API key bằng biến môi trường, biến đó phải có trong môi trường nơi bạn khởi chạy OpenBot, không chỉ trong một cửa sổ terminal khác.
IV.Kiểm tra đã chạy được chưa
README không đưa ra một lệnh kiểm tra riêng cho bản desktop, nên cách thực tế là kiểm tra theo các dấu hiệu sau:
- App mở lên được và hiện màn hình onboarding hoặc đồng ý lần đầu.
- Ở Settings hoặc More providers, nhà cung cấp bạn chọn chuyển sang trạng thái đã kết nối sau khi Download và Sign in.
- Với OpenCode, bấm Connect và bộ chọn mô hình hiện danh sách mô hình mà CLI cung cấp; các mô hình có nhãn Free dùng được không cần đăng nhập.
- Tạo thử một agent, gửi một tin nhắn đơn giản và thấy agent trả lời.
Với bản server hoặc Docker, lệnh openbot login phải hoàn tất được đăng nhập bằng mã email, rồi bạn mở được app desktop, app iPhone hoặc openbot.run/app để thấy máy chủ của mình.
V.Dùng vào việc thật
Phần này là gợi ý dựa trên những gì README mô tả. Các câu lệnh mẫu bạn có thể tự điều chỉnh theo nhu cầu.
A.Chủ shop có một trợ lý lo việc lặt vặt hằng ngày
Bạn bán hàng online và hay phải tổng hợp file Excel đơn hàng, soạn nội dung đăng bài. Hãy tạo một agent riêng cho việc này, rồi mô tả bằng lời thường:
Tạo một trợ lý tên Hậu Cần. Nhiệm vụ: đọc các file đơn hàng tôi chuyển vào, gom theo ngày, soạn bản tóm tắt ngắn để tôi duyệt.OpenBot dựng sẵn hướng dẫn cho agent và cho bạn xem lại các phần trước khi lưu. Bạn xếp nhiều yêu cầu liên tiếp vào hàng đợi, agent làm lần lượt, bạn tạm dừng hoặc huỷ khi cần. Kết quả là một thư mục làm việc riêng chứa các file đã xử lý, không lẫn với việc khác.
B.Lập trình viên cho hai agent làm việc song song
Bạn đang sửa một dự án, muốn một agent Claude viết mã và một agent Codex rà soát. Tạo hai agent, mỗi cái một thư mục làm việc. Ra lệnh cho agent đầu:
Thêm chức năng xuất CSV cho trang báo cáo, xong thì gửi tóm tắt thay đổi cho agent rà soát.Hai agent nhắn tin và chuyển file cho nhau qua tính năng agent-to-agent, bạn chỉ cần theo dõi hội thoại.
Thay vì mở năm cửa sổ terminal rồi quên cái nào đang làm gì, bạn có một chỗ để thấy toàn bộ đội trợ lý và hàng đợi việc của từng người.
Ông T
C.Nhân viên văn phòng cho trợ lý duyệt web thay mình
Bạn cần tra giá của vài nhà cung cấp rồi lập bảng so sánh. Giao cho agent:
Mở trình duyệt, vào các trang sau, ghi lại giá và điều kiện giao hàng, rồi tổng hợp thành bảng.Agent dùng trình duyệt nhúng bền vững của OpenBot để mở và đọc trang. Bạn nhận về bảng tổng hợp trong hội thoại. Vì phiên trình duyệt được giữ lại, lần sau agent không phải mở lại từ đầu.
D.Nhóm nhỏ dùng chung một kênh chat
Trong một nhóm nhỏ, bạn tạo kênh chat chung trên desktop với một agent làm chủ việc. Mọi người cùng xem lịch sử, chủ việc giao lại cho agent khác khi cần. Nếu agent đi lệch hướng, dùng Stop, còn muốn đổi người làm thì Reassign. Cách này hợp với việc cần theo dõi liên tục, ví dụ rà soát tài liệu theo từng ngày.
Agent chạy với 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 mà không hỏi từng thao tác. Chỉ giao việc bạn tin tưởng, luôn sao lưu dữ liệu quan trọng, và đọc tài liệu Security của repo trước khi dùng thật.
VI.Lỗi hay gặp và cách xử lý
Trên Ubuntu 23.10 trở lên hoặc Debian 13, OpenBot mở lên rồi thoát ngay. Lý do là AppArmor đang hạn chế user namespace. Cài profile AppArmor bằng hai lệnh sudo install ... và sudo systemctl reload apparmor ở phần cài đặt phía trên. Đừng dùng --no-sandbox để lách.
Windows hiện cảnh báo SmartScreen. README nói điều này vẫn có thể xảy ra với bản mới. Hãy kiểm tra checksum hoặc chứng thực build của GitHub trước khi chạy, và chỉ tải file từ trang Releases chính thức.
Agent báo lỗi khi gọi mô hình, nhắc tên nhà cung cấp. Thường là chưa đăng nhập. Ví dụ với OpenCode, các mô hình không có nhãn Free cần đăng nhập với nhà cung cấp đó: dán khoá Go cho nhóm opencode-go/, hoặc chạy opencode auth login trong terminal cho OpenCode Zen và nhà cung cấp bên thứ ba.
Đã đặt API key nhưng app không nhận. Các biến như XAI_API_KEY hay CURSOR_API_KEY phải có trong môi trường dùng để khởi chạy OpenBot. Hãy đóng app và mở lại từ nơi có biến đó. Với Copilot hoặc Mistral, nếu biến môi trường token đã được đặt thì CLI dùng nó thay cho đăng nhập, và nút Disconnect không gỡ được.
Đăng nhập Gemini trên máy chủ không có màn hình thất bại. README nói đăng nhập Gemini 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, vì Google gửi callback về 127.0.0.1. Máy chủ không có desktop không hoàn tất được bước này. Hãy dùng trình duyệt trên máy chủ, hoặc xem tài liệu Gemini setup trong thư mục docs/.
VII.Có nên dùng không
Điểm mạnh. Bạn có một nơi duy nhất quản lý nhiều agent, mỗi agent có không gian riêng, hàng đợi lưu bền và trình duyệt nhúng. Số nhà cung cấp hỗ trợ rất rộng, từ Codex, Claude, Grok đến Ollama và LM Studio cục bộ. Cài đặt bằng file tải về, không cần dựng môi trường lập trình. Repo cập nhật thường xuyên.
Giới hạn. Quyền truy cập đầy đủ không hỏi từng thao tác là rủi ro lớn nhất, nên không hợp để thử trên máy chứa dữ liệu quan trọng chưa sao lưu. Bạn vẫn cần tài khoản hoặc key của từng nhà cung cấp AI, và có thể phát sinh chi phí tuỳ gói. Dữ liệu vẫn đi tới nhà cung cấp mô hình, nên không phải giải pháp ngoại tuyến. README nói OpenBot không phải phần mềm tự do, và repo có file LICENSE, nên hãy đọc kỹ điều khoản trước khi dùng cho mục đích thương mại. Một số tính năng có giới hạn riêng, ví dụ remote desktop trên Linux chỉ chạy với X11 trên x64, không chạy dưới Wayland.
Khi nào chọn cách khác. Nếu bạn chỉ cần hỏi đáp nhanh, một khung chat thông thường là đủ. Nếu bạn chỉ dùng một công cụ như Claude Code trong terminal và thấy vậy là vừa, chưa cần thêm lớp quản lý. OpenBot đáng thử khi bạn thật sự cần nhiều trợ lý chạy song song, có hàng đợi và phối hợp với nhau.
Câu hỏi thường gặp
OpenBot có miễn phí không?
Bản thân README không nêu giá của OpenBot. README chỉ nói OpenBot không phải phần mềm tự do, và repo có file LICENSE để bạn đọc điều khoản. Chi phí AI phụ thuộc nhà cung cấp bạn chọn: OpenCode có mô hình Free không cần đăng nhập, Cline có mô hình miễn phí có giới hạn, còn nhiều nhà cung cấp khác cần gói hoặc API key.
OpenBot chạy được trên Windows không?
Được. README hỗ trợ Windows 10 trở lên bản x64: tải file OpenBot-*-x64.exe từ GitHub Releases, chạy trình cài đặt rồi mở app. Ngoài ra còn hỗ trợ macOS 13 trở lên và Linux x64 hoặc arm64 dạng AppImage.
Có cần cài Node.js hay biết lập trình để dùng không?
Cài bằng file phát hành thì README không yêu cầu bạn cài Node. Yêu cầu Node 24 trở lên nằm trong package.json, liên quan tới việc build từ mã nguồn. Bạn không cần biết lập trình để cài và mở app, nhưng cần hiểu rủi ro khi để agent chạy lệnh trên máy.
Dữ liệu của tôi có an toàn không?
OpenBot là local-first nhưng không phải ngoại tuyến hoàn toàn. Prompt đi tới nhà cung cấp AI bạn chọn, và trang web agent mở dùng mạng. README cũng cảnh báo agent chạy với danger-full-access và không hỏi từng thao tác, nên hãy giữ bản sao lưu và chỉ giao việc bạn tin tưởng.
OpenBot có cần GPU không?
Phần tư liệu mình có không nêu yêu cầu GPU. Các agent như Codex, Claude, Grok kết nối tới dịch vụ của nhà cung cấp. OpenBot cũng nhận diện máy chủ mô hình cục bộ như Ollama và LM Studio, còn yêu cầu phần cứng cho mô hình cục bộ thì chưa có thông tin trong README.
OpenBot khác gì việc dùng Claude Code hoặc Codex trực tiếp?
OpenBot không thay thế các công cụ đó mà đứng ở trên để điều phối. Nó cho mỗi agent không gian làm việc riêng, hàng đợi việc lưu bền, chia sẻ file, trình duyệt nhúng và cho các agent nhắn tin với nhau, trong một app desktop. Bạn vẫn cần tài khoản của từng nhà cung cấp.
Có chạy được như máy chủ luôn bật không?
Có. README có hai cách: script cài server cho Ubuntu 24.04 hoặc 26.04 có systemd rồi chạy sudo openbot login, hoặc chạy container Docker cho linux/amd64 và linux/arm64. Sau đó bạn dùng từ app desktop, app iPhone hoặc openbot.run/app.


