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 "local-first" giúp bạn tạo nhiều trợ lý AI bền vững, mỗi trợ lý có thư mục làm việc và cuộc trò chuyện riêng. Nó chạy trên macOS, Windows và Linux, dùng được Codex, Claude Code, Grok và nhiều công cụ AI khác. Với người dùng máy tính, cài chỉ là tải bộ cài từ GitHub Releases rồi mở lên, không cần build mã nguồn.
OpenBot là một ứng dụng desktop "local-first" để bạn nuôi các trợ lý AI lâu dài trên máy của mình. Mỗi trợ lý là một "đồng đội" có thư mục làm việc riêng, cuộc trò chuyện riêng và hàng đợi việc riêng. Bạn không phải mở từng cửa sổ dòng lệnh rời rạc nữa.
Repo này hợp với ba nhóm người. Nhóm thứ nhất là lập trình viên đang dùng Codex hoặc Claude Code và muốn quản lý nhiều phiên làm việc ở một chỗ. Nhóm thứ hai là người làm văn phòng, kinh doanh muốn giao việc cho AI mà không phải gõ lệnh phức tạp. Nhóm thứ ba là người thích tự dựng một "đội AI" chạy trên máy hoặc trên server riêng.
Điểm đáng giá nhất là OpenBot gom nhiều nhà cung cấp AI vào một giao diện. Hiện repo có khoảng 7.353 sao và 741 fork, và theo tác giả thì gần như mỗi ngày có một bản phát hành mới. Bạn 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 gom Codex, Claude, Grok và nhiều AI khác thành các trợ lý riêng, có hàng đợi việc, trình duyệt nhúng và nhắn tin cho nhau.
I.OpenBot làm được gì
Dưới đây là những tính năng chính, mình giải thích theo lợi ích khi dùng thật.
- Nhiều trợ lý bền vững, mỗi trợ lý một chỗ làm việc. Mỗi trợ lý chạy trên một phiên Codex, Claude, Grok, OpenCode, Gemini, Cursor, Cline, Kimi, Devin, GitHub Copilot, Mistral hoặc Hermes riêng. Việc của trợ lý này không lẫn sang trợ lý kia.
- Tạo và sửa trợ lý bằng câu lệnh thường. Bạn mô tả bằng lời, rồi chỉnh hướng dẫn, ảnh đại diện và từng phần trước khi lưu. Cách này có trên cả desktop lẫn điện thoại.
- Hàng đợi việc. Tin nhắn xếp theo thứ tự vào trước ra trước. Bạn có thể tạm dừng, tiếp tục hoặc huỷ, và hàng đợi vẫn giữ nguyên nếu ứng dụng bị tắt đột ngột.
- Trợ lý nhắn tin cho nhau. Chúng có thể trả lời, thả reaction, gửi ảnh và chuyển file có quản lý. Việc nhiều bước nhờ vậy chia được cho nhiều trợ lý.
- Kênh chat chung trên desktop. Mỗi việc có một người nhận chính, có phân công rõ ràng và lịch sử dùng chung. Bạn có các nút Stop, Resume, Reassign, Archive và Restore để điều khiển.
- Trình duyệt nhúng bền vững. Trợ lý có thể mở, xem và điều khiển trình duyệt này để làm việc với trang web.
- Theo dõi ngữ cảnh. Ứng dụng giám sát từng trợ lý và tự nén lịch sử trước khi hội thoại dài làm đầy cửa sổ ngữ cảnh của mô hình.
- Mô hình tự chọn. Bạn có thể dùng endpoint tương thích OpenAI hoặc agent ACP tuỳ chỉnh. Ứng dụng cũng phát hiện được các máy chủ mô hình cục bộ như Ollama, LM Studio.
- Computer Use (tuỳ chọn). Tính năng này có trên macOS, Windows và Linux, thông qua tệp
cua-driverđi kèm bản phát hành. - Xuất dữ liệu. Menu tài khoản cho phép xuất dữ liệu cục bộ và bản chẩn đoán đã loại thông tin riêng tư.
Lưu ý "local-first" không có nghĩa là chạy offline hoàn toàn. Codex kết nối tới OpenAI, Claude tới Anthropic, Grok tới xAI, Gemini tới Google, và tương tự với các nhà cung cấp còn lại. Trang web mà trợ lý truy cập cũng dùng mạng.
II.Cần chuẩn bị gì
Chỉ có những thứ này, theo README:
- Hệ điều hành: macOS 13 trở lên (chip Apple silicon hoặc Intel), Windows 10 trở lên bản x64, hoặc Linux x64/arm64 dạng AppImage.
- Tài khoản AI: tuỳ nhà cung cấp bạn chọn. Gemini cần gói Google AI Pro hoặc Ultra. Cursor cần gói Cursor hoặc API key. GitHub Copilot cần tài khoản GitHub có gói Copilot. Mistral cần tài khoản hoặc API key Mistral. Cline dùng tài khoản Cline, có mô hình miễn phí nhưng giới hạn.
- OpenCode: các mô hình có nhãn Free không cần đăng nhập. Mô hình trả phí cần khoá Go hoặc đăng nhập nhà cung cấp tương ứng.
- Node: package.json yêu cầu Node 24 trở lên. Phần này chỉ cần nếu bạn chạy từ mã nguồn. Cài bằng bộ cài thì README không đòi bạn cài Node.
- Phần cứng: README không nêu yêu cầu GPU hay RAM tối thiểu trong phần mình có.
Bản desktop có cơ chế để ứng dụng tự tải công cụ dòng lệnh của nhà cung cấp AI khi bạn bấm Download. Vì vậy người mới thường không phải cài thủ công.
OpenBot cho các trợ lý chạy với quyền `danger-full-access` và `approvalPolicy: never`. Nghĩa là chúng có thể đọc, 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 từng thao tác, sau lần đồng ý đầu tiên. 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.
III.Cài đặt từng bước
- Chọn bản phù hợpXem máy bạn là macOS, Windows hay Linux, chip nào
- Tải bộ càiVào trang GitHub Releases của repo, tải đúng file
- Cài và mởKéo vào Applications, chạy installer hoặc chạy AppImage
- Cấp thêm quyền nếu cầnUbuntu 23.10+ và Debian 13 cần hồ sơ AppArmor
- Kết nối AIBấm Download hoặc Sign in cho nhà cung cấp bạn dùng
A.Chọn đúng file
README đặt tên file theo mẫu sau, bạn chọn đúng loại cho máy mình:
- Mac chip Apple:
OpenBot-*-arm64.dmg. Mac Intel:OpenBot-*-x64.dmg. - Windows:
OpenBot-*-x64.exe. - Linux:
OpenBot-*-x86_64.AppImage, hoặcOpenBot-*-arm64.AppImagenếu máy arm64.
Người mới hay vấp ở chỗ tải nhầm file. Mac đời mới (M1, M2…) là Apple silicon, nên chọn arm64.
B.Cài trên macOS
Mở file .dmg, kéo OpenBot vào thư mục Applications rồi mở ứng dụng. README chỉ ghi hai bước này, không có lệnh nào.
C.Cài trên Windows
Chạy file .exe rồi mở OpenBot. Bản mới được ký bởi SYNTHETIFY LABS SPÓŁKA Z OGRANICZONĄ ODPOWIEDZIALNOŚCIĄ, còn bản cũ thì chưa ký. SmartScreen vẫn có thể cảnh báo. README khuyên kiểm tra checksum của bản phát hành hoặc chứng thực build trên GitHub trước khi chạy.
D.Cài trên Linux
Sau khi tải AppImage, mở terminal ở thư mục chứa file và chạy:
chmod +x OpenBot-*.AppImageLệnh này cấp quyền chạy cho file. Sau đó bạn chạy file đó (ví dụ bấm đúp, hoặc gõ ./ rồi tên file). AppImage không cần libfuse2, nó tự mount bằng fusermount3 từ gói fuse3.
Nếu 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. Bạn cần cài hồ sơ AppArmor. Hai lệnh dưới đây chạy trong thư mục gốc của repo đã clone, vì đường dẫn build/linux/openbot.apparmor nằm trong repo:
sudo install -m 0644 build/linux/openbot.apparmor /etc/apparmor.d/openbot
sudo systemctl reload apparmorTệp này cũng nằm sẵn trong AppImage tại resources/linux/openbot.apparmor. Đừng khởi động OpenBot với cờ --no-sandbox, vì cờ đó phá lớp cách ly giữa trình hiển thị và phần còn lại của máy.
E.Cài bằng Nix (nếu bạn dùng Nix)
nix run github:nightly-labs/openbot
nix profile install github:nightly-labs/openbotDòng đầu chạy thử, dòng sau cài hẳn. README nói OpenBot không phải phần mềm tự do, nên cấu hình nixpkgs của bạn phải cho phép gói "unfree", ví dụ nixpkgs.config.allowUnfreePredicate = pkg: lib.getName pkg == "openbot";.
F.Chạy như server không màn hình (tuỳ chọn)
Dành cho VPS hoặc server nhà chạy Ubuntu 24.04 hoặc 26.04 có systemd:
curl -fsSL https://raw.githubusercontent.com/nightly-labs/openbot/main/scripts/install-server.sh | sudo bash
sudo openbot loginLệnh đầu tải và chạy script cài đặt bằng quyền root. Hãy đọc script trước khi chạy nếu bạn muốn chắc chắn. Lệnh sau đăng nhập bằng mã gửi qua email. Sau đó bạn dùng server từ ứng dụng desktop, ứng dụng iPhone hoặc openbot.run/app.
G.Chạy bằng Docker (tuỳ chọn)
Container hỗ trợ 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 hồ sơ seccomp. Lệnh thứ hai chạy container nền, lưu dữ liệu trong volume openbot-data. Lệnh cuối đăng nhập vào trong container. Tài liệu Compose và nâng cấp nằm trong thư mục docs/ của repo.
H.Kết nối nhà cung cấp AI
Khi mở OpenBot lần đầu, bạn sẽ thấy màn hình onboarding. Chọn Download ở dòng nhà cung cấp để ứng dụng tự tải công cụ dòng lệnh tương ứng. Nếu muốn tự cài, README có sẵn hai lệnh cho macOS:
curl -fsSL https://chatgpt.com/codex/install.sh | shcurl -fsSL https://claude.ai/install.sh | bashLệnh trên cài Codex CLI, lệnh dưới cài Claude CLI. Với Grok, README bảo cài theo tài liệu Grok Build, rồi chạy grok login hoặc đặt biến XAI_API_KEY trong môi trường dùng để mở OpenBot. Chỗ này người mới hay vấp: biến môi trường phải có mặt ở nơi bạn khởi động OpenBot, đặt ở cửa sổ terminal khác thì không có tác dụng.
Với Cursor, Cline và vài nhà cung cấp khác, README mô tả cách tương tự: chọn Download ở mục More providers, rồi bấm Sign in để đăng nhập trên trình duyệt. Nếu muốn dùng bản CLI tự cài ở chỗ khác, README có các biến dạng OPENBOT_*_PATH (ví dụ OPENBOT_OPENCODE_PATH) để chỉ đường dẫn tới file chạy.
IV.Kiểm tra đã chạy được chưa
Phần README mình có không mô tả một màn hình "thành công" cố định, nên mình nêu các dấu hiệu hợp lý theo mô tả chức năng:
- Ứng dụng mở được và hiện màn hình onboarding, có yêu cầu đồng ý lần đầu về quyền truy cập đầy đủ của trợ lý.
- Ở dòng nhà cung cấp bạn chọn, bấm Download xong thì trạng thái chuyển sang có thể Connect hoặc Sign in. Đăng nhập xong, danh sách mô hình hiện ra trong model picker.
- Tạo một trợ lý thử, gõ một câu đơn giản. Nếu trợ lý trả lời thì mọi thứ đã thông.
Nếu bạn dùng OpenCode với mô hình có nhãn Free, README nói không cần tài khoản: chọn OpenCode, bấm Connect, OpenBot sẽ đọc danh sách mô hình từ CLI. Đây là cách thử nhanh nhất mà không cần trả phí.
Với server, chạy sudo openbot login hoặc docker exec -it openbot openbot login rồi đăng nhập bằng mã email. Sau đó mở ứng dụng desktop để thấy server của bạn.
V.Dùng vào việc thật
A.Chủ shop nhờ một trợ lý soạn nội dung bán hàng
Bạn bán đồ gia dụng online và cần mô tả sản phẩm mỗi tuần. Hãy tạo một trợ lý riêng cho việc này và mô tả bằng lời:
Tạo trợ lý "Viết mô tả sản phẩm". Mỗi khi mình gửi tên sản phẩm và vài đặc điểm, hãy viết mô tả 100 chữ, giọng thân thiện, không hứa hẹn quá mức.OpenBot cho bạn xem và chỉnh phần hướng dẫn trước khi lưu. Sau đó bạn gửi liên tiếp nhiều sản phẩm và chúng được xếp vào hàng đợi, trợ lý xử lý lần lượt. Kết quả là danh sách mô tả theo cùng một giọng văn, và nhờ có thư mục làm việc riêng, bạn có thể bảo trợ lý lưu thành file.
Giao việc cho AI mà không có chỗ làm việc riêng và hàng đợi thì rất dễ rối. Mỗi trợ lý một phòng, việc nào vào việc nấy.
Ông T
B.Nhân viên văn phòng chia việc cho hai trợ lý
Bạn cần tổng hợp thông tin từ vài trang web rồi viết thành báo cáo ngắn. Tạo hai trợ lý: một người thu thập, một người viết. Trợ lý thứ nhất dùng trình duyệt nhúng để mở trang và đọc nội dung, rồi nhắn kết quả cho trợ lý thứ hai bằng tính năng nhắn tin giữa các agent. Bạn mở kênh chat chung để theo dõi cả hai và chỉ định ai là người nhận chính của việc. Kết quả là một bản nháp báo cáo mà bạn chỉ phải đọc và chỉnh. Nếu một trợ lý đi sai hướng, bấm Stop hoặc Reassign.
C.Lập trình viên mới quản lý nhiều phiên Claude và Codex
Bạn đang học lập trình và đã có Claude Code hoặc Codex. Thay vì mở nhiều cửa sổ terminal, bạn tạo mỗi dự án một trợ lý với thư mục riêng. Bạn chọn mô hình và mức suy luận cho từng trợ lý. Khi hội thoại dài, OpenBot tự nén ngữ cảnh. Đây là cách giữ các dự án tách bạch mà không phải nhớ phiên nào nằm ở cửa sổ nào.
D.Người muốn thử mô hình chạy trên máy mình
Nếu bạn có Ollama hoặc LM Studio chạy sẵn, README nói OpenBot phát hiện được các máy chủ mô hình cục bộ. Bạn có thể thêm endpoint tương thích OpenAI để dùng làm nền cho một trợ lý. Cách này hợp với việc thử nghiệm hoặc với dữ liệu bạn không muốn gửi ra ngoài. README chưa cho mình số liệu cụ thể về chất lượng hay yêu cầu phần cứng, nên bạn nên thử với việc nhỏ trước.
VI.Lỗi hay gặp và cách xử lý
OpenBot thoát ngay khi mở trên Ubuntu 23.10+ hoặc Debian 13. Nguyên nhân là AppArmor hạn chế user namespace. Cài hồ sơ openbot.apparmor bằng hai lệnh ở phần cài đặt. Đừng dùng --no-sandbox để "chữa cháy".
Windows hiện cảnh báo SmartScreen. README xác nhận cảnh báo này vẫn có thể xuất hiện với bản mới. Hãy tải từ GitHub Releases chính thức và kiểm tra checksum hoặc chứng thực build trước khi chạy.
Trợ lý báo lỗi có tên nhà cung cấp khi chạy mô hình OpenCode. README nói mô hình không có nhãn Free cần đăng nhập với nhà cung cấp. Dùng khoá Go cho các mô hình opencode-go/, hoặc chạy opencode auth login trong terminal cho OpenCode Zen và nhà cung cấp bên thứ ba.
Đăng nhập Gemini không xong trên server không có màn hình. Google gửi callback về 127.0.0.1 của chính máy đó, nên server không có desktop không hoàn tất được. Cần một trình duyệt desktop và xdg-utils trên cùng máy. Đăng nhập Google cũng không làm được từ cài đặt từ xa.
Remote desktop không chạy trên Linux. Tính năng này chỉ hoạt động trên Linux x64 với phiên X11 như Xorg hoặc Xvfb. Nó không chạy dưới Wayland, và bản AppImage arm64 không có.
VII.Có nên dùng không
Điểm mạnh. OpenBot gom nhiều nhà cung cấp AI vào một giao diện, có hàng đợi bền, trình duyệt nhúng, chat chung và nhắn tin giữa các trợ lý. Cài trên desktop chỉ là tải bộ cài. Repo còn được cập nhật thường xuyên, và theo tác giả thì sẵn sàng cho dùng thật.
Giới hạn cần biết. Trợ lý chạy với toàn quyền và không hỏi từng thao tác, nên rủi ro nằm ở việc bạn giao gì cho chúng. README cũng nói OpenBot không phải phần mềm tự do, nên hãy xem file LICENSE của repo trước khi dùng cho mục đích thương mại. Phần lớn nhà cung cấp AI vẫn cần tài khoản hoặc gói trả phí riêng, nên chi phí phụ thuộc vào đó. Một số tính năng có điều kiện hệ điều hành, như remote desktop ở trên.
Khi nên chọn cách khác. Nếu bạn chỉ cần hỏi đáp thỉnh thoảng, một ứng dụng chat AI thông thường đơn giản hơn nhiều. Nếu bạn cần mỗi hành động được duyệt thủ công, OpenBot không hợp, vì nó được thiết kế theo hướng ngược lại. Nếu dữ liệu quá nhạy cảm, hãy đọc PRIVACY.md và SECURITY.md trong repo trước khi quyết định.
Câu hỏi thường gặp
OpenBot có miễn phí không?
README nói rõ OpenBot không phải phần mềm tự do, và repo có file LICENSE bạn nên đọc kỹ. Phần README mình có không nêu giá của chính ứng dụng. Chi phí AI thì tuỳ nhà cung cấp bạn nối vào: một số có mô hình miễn phí giới hạn (như OpenCode có nhãn Free, Cline), số khác cần gói trả phí.
OpenBot chạy được trên Windows không?
Được. README hỗ trợ Windows 10 trở lên trên máy x64. Bạn tải file `OpenBot-*-x64.exe` từ GitHub Releases, chạy installer rồi mở ứng dụng. SmartScreen vẫn có thể cảnh báo, nên hãy kiểm tra checksum hoặc chứng thực build.
Có cần GPU không?
README không nêu yêu cầu GPU. Các trợ lý như Codex, Claude, Grok kết nối tới dịch vụ của nhà cung cấp, nên phần nặng không chạy trên máy bạn. Nếu bạn dùng mô hình cục bộ qua Ollama hoặc LM Studio thì yêu cầu phần cứng phụ thuộc vào mô hình đó, tư liệu chưa có thông tin cụ thể.
Dữ liệu của tôi có an toàn không?
OpenBot là local-first nhưng không phải offline hoàn toàn: prompt được gửi tới nhà cung cấp AI bạn chọn, và trang web trợ lý truy cập dùng mạng. Trợ lý chạy với toàn quyền và không hỏi từng thao tác. Với Cline, README cảnh báo nhà cung cấp mô hình miễn phí có thể dùng prompt để huấn luyện. Hãy đọc `PRIVACY.md` và `SECURITY.md` của repo.
Tôi có cần cài Node hay biết lập trình để dùng không?
Với bộ cài macOS, Windows hoặc Linux thì README không đòi bạn cài Node. Yêu cầu Node 24 trở lên nằm trong package.json, dành cho người chạy từ mã nguồn. Bạn vẫn cần tài khoản hoặc khoá của nhà cung cấp AI bạn chọn.
OpenBot khác gì việc dùng Claude Code hay Codex trực tiếp?
OpenBot không thay thế chúng mà đứng bên trên. Nó dùng chính Codex, Claude Code và nhiều CLI khác làm nền, rồi thêm không gian làm việc riêng cho mỗi trợ lý, hàng đợi việc, trình duyệt nhúng và nhắn tin giữa các trợ lý. Nếu bạn chỉ cần một phiên đơn lẻ, dùng CLI trực tiếp có thể đủ.
Dùng được trên điện thoại hoặc server không?
README có nhắc ứng dụng iPhone và trang `openbot.run/app` để dùng server của bạn. Server chạy trên Ubuntu 24.04 hoặc 26.04 có systemd bằng script cài, hoặc chạy bằng Docker trên amd64 và arm64. Chi tiết về server tự dựng nằm trong thư mục `docs/` của repo.


