Bỏ qua tới nội dung
Ông T.vn

OpenBot: đồng nghiệp AI có máy tính riêng, có duyệt trước khi làm — hướng dẫn cài đặt và dùng

12 phút đọcCập nhật

Bài này là một góc nhìn khác về CopilotKit/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: đồng nghiệp AI có máy tính riêng, mọi việc đều được duyệt — hướng dẫn cài đặt và dùng →

OpenBot: đồng nghiệp AI có máy tính riêng, có duyệt trước khi làm — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

OpenBot là ứng dụng mã nguồn mở (MIT) của CopilotKit, cho phép bạn chạy các Bot AI có trình duyệt, tệp và công cụ riêng, mọi hành động đều qua chính sách duyệt và được ghi lại. Cách dễ nhất là cài app cho Mac hoặc Windows. Chạy từ mã nguồn thì cần Docker, Bun và vài khoá cấu hình nên khó hơn một chút.

OpenBot là một không gian làm việc cho "đồng nghiệp AI": mỗi Bot được cấp một chiếc máy tính riêng gồm trình duyệt, tệp và công cụ, rồi tự làm việc trong đó. Điểm khác với chatbot thường là mọi hành động đều được quyết định trước khi xảy ra và được ghi lại sau khi xảy ra. Repo này do CopilotKit, nhóm tạo ra giao thức AG-UI, phát triển. Hiện có khoảng 11.799 sao và 1.452 fork trên GitHub.

Bạn nên xem qua repo này nếu là chủ doanh nghiệp nhỏ hay nhân viên văn phòng muốn thử một trợ lý AI biết thao tác trên trình duyệt mà vẫn hỏi ý bạn trước khi gửi gì đi. Lập trình viên cũng có lý do để dùng: bạn có thể nối agent đang có của mình vào qua AG-UI, hoặc fork bản mẫu để làm sản phẩm riêng. Giấy phép là MIT.

Điều đáng giá nhất là cơ chế duyệt và ghi nhận. Bot xin phép trước khi gửi, bạn có thể can thiệp bất cứ lúc nào, và mọi việc đều có dấu vết. Bạn xem video ngắn bên dưới để thấy một Bot dùng trình duyệt như thế nào, rồi quay lại đọc phần cài đặt.

Ứng dụng

CopilotKit/OpenBot

OpenBot là không gian làm việc mã nguồn mở cho các "đồng nghiệp AI": mỗi Bot có trình duyệt, tệp, công cụ riêng, hành động nào cũng được duyệt và ghi lại.

★ 12kTypeScriptMIT
Xem repo trên GitHub
Video giới thiệu OpenBotXem trên YouTubeXem trên Facebook

I.OpenBot làm được gì

Dưới đây là các tính năng chính theo mô tả của tác giả, kèm cái lợi thực tế cho bạn.

  • Mỗi Bot có máy tính riêng. Bot có trình duyệt, tệp và công cụ của riêng nó. Việc nó làm không lẫn vào máy cá nhân của bạn, và bạn có thể nhìn vào màn hình của nó.
  • Duyệt trước, ghi lại sau. Bot chờ bạn đồng ý trước khi thực hiện hành động như gửi đi. Khi nó kẹt hoặc cần bạn, bạn có thể tiếp quản. Đây là điểm giúp bạn yên tâm giao việc.
  • Kết quả tương tác. Bot trả lời bằng kết quả tương tác được, không chỉ là văn bản dài.
  • Chọn mô hình tuỳ ý. Dùng OpenAI, Claude, Gemini, hoặc mô hình mở qua endpoint tương thích OpenAI, đặt ở nhà cung cấp hoặc trên hạ tầng của bạn. Muốn đổi mô hình sau này cũng được.
  • Mang agent của bạn vào. Bạn chạy Bot có sẵn trong máy chủ OpenBot, hoặc nối agent đang có qua AG-UI. Agent viết bằng các bộ khung khác nhau vẫn làm chung một không gian được. README liệt kê nhiều bộ khung như Claude Agent SDK, Google ADK, AWS Strands, LangChain, Mastra, Pydantic AI, Agno, CrewAI.
  • Quản trị cho cả nhóm. Đăng nhập công ty, vai trò, quyền dùng công cụ, duyệt và nhật ký kiểm toán áp dụng chung. Phần này nằm trong gói dành cho doanh nghiệp.
  • Dùng ở nhiều nơi. Mac, Windows, web, iOS, Android, Slack, Teams. README ghi bản web, di động và chat đang ở dạng đăng ký dùng sớm, nên ngay bây giờ bạn nên bắt đầu từ app máy tính.

II.Cần chuẩn bị gì

Có ba con đường, yêu cầu mỗi đường khác nhau.

Cài app trên laptop (dễ nhất). README ghi có file .dmg đã được notarize cho Mac chip Apple và Intel, cùng trình cài đặt có chữ ký cho Windows x64. Bạn không cần terminal hay công cụ lập trình. App này gộp giao diện và phần backend chạy bằng Docker vào một ứng dụng.

Chạy từ mã nguồn. Theo README bạn cần:

  • Docker, để chạy PostgreSQL và các Bot đi kèm.
  • Bun phiên bản 1.4 trở lên. README cảnh báo một số bài test lỗi trên Bun 1.3.
  • Một dự án và giấy phép CopilotKit Intelligence. README nói có gói miễn phí và Intelligence có thể tự host.
  • Một khoá mô hình. Bot thử nghiệm dùng OpenAI. Bot LangGraph dùng được OpenAI, Anthropic hoặc Google.
  • Trên Windows: WSL 2 với Ubuntu, chạy mọi lệnh từ cửa sổ Ubuntu.

Triển khai trên Kubernetes. Cần cụm có node amd64, StorageClass mặc định, kubectl, Helm, giấy phép dùng thử hoặc chính thức, và khoá mô hình.

Còn một điều nữa cần biết về giấy phép. Bản mẫu OpenBot là MIT, nhưng nó dùng CopilotKit Intelligence, được cấp phép riêng. Chạy trên laptop cho cá nhân thì cần giấy phép Intelligence cục bộ miễn phí, app máy tính tự lo phần này. Chạy Kubernetes để đánh giá cần giấy phép dùng thử miễn phí. Chạy sản xuất cần giấy phép sản xuất.

Khoá API (ví dụ OPENAI_API_KEY) là của riêng bạn và có thể phát sinh chi phí theo mức dùng. Đừng đưa file .env hay openbot-secrets.yaml lên GitHub hay gửi cho người khác. Bot có trình duyệt thật, nên đừng giao tài khoản quan trọng khi chưa hiểu rõ chính sách duyệt.

III.Cài đặt từng bước

Phần này hướng dẫn cách chạy từ mã nguồn, vì README ghi lệnh đầy đủ ở đây. Nếu bạn chỉ muốn dùng thử nhanh, hãy tải bản .dmg hoặc bản cài Windows ở mục Releases của repo rồi bỏ qua phần này.

  1. Tải mã nguồnClone repo về máy và vào thư mục OpenBot
  2. Tạo file .envSao chép .env.example và cài phụ thuộc bằng Bun
  3. Kết nối IntelligenceĐăng nhập CopilotKit, chọn dự án, chạy script thiết lập
  4. Điền khoá còn thiếuNhập OPENAI_API_KEY và (tuỳ chọn) tạo khoá mã hoá riêng
  5. Khởi độngChạy scripts/start.sh rồi mở localhost:3010

A.Tải mã nguồn

Mở terminal (trên Windows là cửa sổ Ubuntu trong WSL 2) tại nơi bạn muốn đặt thư mục, rồi chạy:

Terminal
git clone https://github.com/CopilotKit/OpenBot.git
cd OpenBot

Lệnh đầu tải repo về. Lệnh thứ hai đưa bạn vào thư mục vừa tải. Mọi lệnh sau đều phải chạy trong thư mục này, vì .env nằm ở đây.

B.Tạo file .env và cài phụ thuộc

Terminal
cp .env.example .env
bun install

cp tạo file .env từ bản mẫu. bun install cài các gói cần thiết. Nếu máy báo không có bun, bạn cần cài Bun 1.4 trở lên trước.

C.Kết nối dự án Intelligence

Terminal
npx --yes copilotkit@latest login
npx --yes copilotkit@latest project select
bun scripts/setup-learning.ts

Hai lệnh npx đăng nhập CopilotKit và chọn dự án. Script cuối tạo khoá runtime cho dự án, tạo hoặc dùng lại container học tên openbot, rồi ghi hai giá trị đó vào .env. Nó không ghi đè khoá OpenBot đã có.

Phần quản lý tự động Composio cũng dùng chung phiên đăng nhập này khi bạn chạy scripts/start.sh. Nếu bước đó không hoàn tất, OpenBot vẫn khởi động, chỉ là phần ứng dụng bên ngoài chưa dùng được. Bạn có thể chạy bun run setup:composio để chuẩn bị riêng hoặc thử lại sau. README dặn giữ nguyên file riêng .env.openbot-installation-id qua các lần khởi động lại và không chép nó sang bản cài mới.

Nếu bạn tự host Intelligence, README hướng dẫn đặt INTELLIGENCE_API_URL về máy chủ của bạn và chạy script mà không cần hai lệnh npx. Khi đó bạn phải tự đặt INTELLIGENCE_GATEWAY_WS_URL cùng máy chủ. Cần cài Chrome hoặc Edge trước, vì script mở một cửa sổ trình duyệt riêng để bạn đăng nhập.

D.Điền các giá trị còn thiếu

Mở file .env và điền OPENAI_API_KEY. Giữ nguyên các URL Intelligence có sẵn trong .env.example nếu bạn dùng dịch vụ Intelligence được quản lý. README nói KEY_ENCRYPTION_KEY trong bản mẫu là công khai và dùng tạm cục bộ được. Muốn tạo khoá riêng thì chạy:

Terminal
openssl rand -base64 32

Lệnh này in ra một chuỗi ngẫu nhiên. Bạn dán chuỗi đó vào KEY_ENCRYPTION_KEY trong .env.

E.Khởi động

Terminal
bash scripts/start.sh

Script này bật các dịch vụ Docker, chạy migration, bật máy chủ API ở cổng 3001, bật worker, bật app ở cổng 3010, rồi kiểm tra từng dịch vụ có trả lời không trước khi in hướng dẫn tiếp theo. Hãy mở Docker trước khi chạy. Khi xong, mở trình duyệt vào http://localhost:3010. Người dùng Windows mở http://127.0.0.1:3010 từ trình duyệt Windows, và phải giữ cửa sổ Ubuntu mở trong lúc dùng.

Để tắt, chạy scripts/stop.sh. Mặc định nó tắt cả máy tính của từng Bot. Thêm --keep-computers nếu muốn giữ các máy đó chạy. README nói không có gì bị xoá: cơ sở dữ liệu, tệp của Bot và hồ sơ trình duyệt nằm trong các volume.

F.Nếu bạn muốn chạy trên Kubernetes

README có hướng dẫn đánh giá bằng Helm. Tạo file openbot-secrets.yaml ở máy bạn, không đưa vào quản lý mã nguồn:

YAML
secrets:
  licenseToken: "<your CopilotKit trial or production license>"
  modelApiKey: "<your OpenAI API key>"

Rồi cài đặt:

Terminal
helm dependency build charts/openbot
helm install openbot charts/openbot \
  --namespace openbot --create-namespace \
  --values charts/openbot/ci/vanilla-values.yaml \
  --values openbot-secrets.yaml \
  --timeout 15m

Và mở bản đánh giá qua port-forward:

Terminal
kubectl -n openbot get pods,jobs
kubectl -n openbot port-forward svc/openbot-server 3001:3001

Sau đó mở http://127.0.0.1:3001. Cấu hình này là một người dùng: ai vào được cũng là quản trị viên. Vì vậy chỉ giữ port-forward ở máy bạn. Muốn triển khai cho nhóm, hãy làm theo hướng dẫn Helm đầy đủ trong repo để cấu hình đăng nhập, TLS, cơ sở dữ liệu và chính sách mạng.

IV.Kiểm tra đã chạy được chưa

Với cách chạy từ mã nguồn, dấu hiệu thành công theo README là:

  • bash scripts/start.sh chạy xong, in các bước tiếp theo và không báo dịch vụ nào lỗi. Script tự kiểm tra các dịch vụ trả lời.
  • Mở được http://localhost:3010 trong trình duyệt. Bản mẫu bật OPENBOT_SINGLE_USER=true, nên bạn vào thẳng với vai quản trị viên cục bộ.

Với bản Kubernetes, lệnh kubectl -n openbot get pods,jobs cho bạn xem các pod và job. Khi mọi thứ ổn, địa chỉ http://127.0.0.1:3001 sẽ mở được qua port-forward. README không mô tả chi tiết trạng thái "đã sẵn sàng" trông ra sao, nên bạn hãy xem hướng dẫn Helm trong repo để đối chiếu.

Nếu có lỗi khi khởi động, README nhắc file prompt.txt ở thư mục gốc giải thích ý nghĩa từng thông báo từ chối khởi động. Bạn có thể dán file này cho một trợ lý AI khác để được hỗ trợ cài.

V.Dùng vào việc thật

README chủ yếu mô tả cách cài và kiến trúc, ít kịch bản người dùng cụ thể. Các tình huống dưới đây bám vào khả năng được nêu: Bot có trình duyệt, chờ duyệt trước khi gửi, cho bạn tiếp quản, và nối được agent ngoài. Kết quả thực tế phụ thuộc mô hình và công cụ bạn cấu hình.

A.Chủ shop nhờ Bot soạn và gửi thư trả lời khách

Bạn có một shop nhỏ và mỗi ngày phải trả lời nhiều câu hỏi lặp lại. Giao Bot một việc, ví dụ:

text
Mở hộp thư hỗ trợ trong trình duyệt, đọc các câu hỏi về giao hàng hôm nay và soạn sẵn thư trả lời lịch sự cho từng người.

Bot làm việc trong trình duyệt riêng của nó. Theo README, nó chờ bạn duyệt trước khi gửi. Bạn đọc bản nháp, sửa nếu cần rồi mới đồng ý. Việc bạn tiết kiệm được là phần soạn, còn quyền gửi vẫn nằm ở bạn.

Giao việc cho AI thì dễ, giao mà vẫn nắm quyền bấm gửi mới là phần đáng giá.

Ông T

B.Nhân viên văn phòng tiếp quản khi Bot bị kẹt

Bạn nhờ Bot tìm thông tin trên một trang web cần đăng nhập. Nếu Bot dừng lại vì cần bạn, README nói bạn có thể tiếp quản. Bạn nhập thông tin xác thực hoặc xử lý bước khó, rồi để Bot làm tiếp. Cách này hợp với những việc chỉ có một vài bước cần người làm.

C.Dev nối agent đang có vào chung không gian

Nếu nhóm bạn đã có agent viết bằng LangGraph, Mastra hay Pydantic AI, bạn nối nó vào OpenBot qua endpoint AG-UI. Agent này dùng chung công cụ và máy tính của OpenBot, dưới cùng chính sách. Trong repo có sẵn các thư mục mẫu như agent-langgraph/, agent-mastra/, agent-crewai/, agent-pydantic-ai/ để bạn tham khảo cách làm. README chưa ghi lệnh cụ thể cho từng bộ khung ở phần bạn đang đọc, nên hãy xem hướng dẫn Connect your agent trong tài liệu.

D.Đội kỹ thuật thử nghiệm trên Kubernetes

Một công ty muốn đánh giá OpenBot cho cả nhóm. Đội kỹ thuật chạy bản Helm ở trên bằng giấy phép dùng thử, mở qua port-forward để kiểm tra, rồi mới cấu hình đăng nhập và TLS trước khi chia sẻ. Cách này cho bạn biết hệ thống có hợp với nhu cầu không trước khi đầu tư thêm.

VI.Lỗi hay gặp và cách xử lý

Bun quá cũ nên test lỗi. README nói một số test thất bại trên Bun 1.3. Kiểm tra bằng bun --version, nếu dưới 1.4 thì nâng cấp Bun.

Docker chưa bật. scripts/start.sh cần Docker để chạy PostgreSQL và các Bot. Mở Docker Desktop (hoặc đảm bảo Docker chạy trong WSL) rồi chạy lại script.

Thiếu khoá hoặc chưa đăng nhập CopilotKit. Nếu script từ chối khởi động, kiểm tra OPENAI_API_KEY đã điền chưa và bạn đã chạy login, project select cùng bun scripts/setup-learning.ts chưa. File prompt.txt trong repo giải thích từng thông báo từ chối.

Windows chạy ngoài WSL. README yêu cầu chạy mọi bước trong Ubuntu của WSL 2. Nếu bạn chạy lệnh bash scripts/start.sh ở PowerShell thường, rất dễ lỗi. Hãy làm lại trong cửa sổ Ubuntu.

Cho người khác vào khi chưa cấu hình đăng nhập. Bản mẫu bật OPENBOT_SINGLE_USER=true, tức ai truy cập được cũng là quản trị viên. Đừng mở cổng ra mạng cho người khác khi chưa cấu hình đăng nhập.

Mất tệp nhận dạng cài đặt. Nếu bạn xoá .env.openbot-installation-id giữa chừng, việc thiết lập Composio có thể không khớp. README dặn giữ file này qua các lần khởi động lại.

VII.Có nên dùng không

Điểm mạnh. Cơ chế duyệt trước và ghi nhận sau rất hợp với người cần dùng AI mà vẫn kiểm soát được. Bạn chọn được mô hình, mang được agent riêng và sửa được mã nguồn vì giấy phép MIT. Repo vẫn được cập nhật trong 3 tháng gần đây, và có cả app cài sẵn cho Mac và Windows.

Giới hạn. Phần Intelligence có giấy phép riêng. Dùng cá nhân thì miễn phí, nhưng triển khai sản xuất cần giấy phép sản xuất. Chạy từ mã nguồn đòi hỏi Docker, Bun, tài khoản CopilotKit và vài khoá, nên không dành cho ai ngại terminal. Bản web, di động, Slack và Teams hiện là đăng ký dùng sớm. README cũng nói dùng mô hình đám mây hay ứng dụng trực tuyến thì yêu cầu vẫn được gửi tới dịch vụ đó. Chạy hoàn toàn cục bộ là một lựa chọn, nhưng cần mô hình cục bộ tương thích.

Khi nào chọn cách khác. Nếu bạn chỉ cần hỏi đáp hay soạn văn bản, một ứng dụng chat thông thường đơn giản hơn nhiều. Nếu bạn không muốn dính tới giấy phép Intelligence, hãy cân nhắc công cụ khác. Còn nếu bạn muốn một trợ lý có trình duyệt riêng, có kiểm soát và ghi lại mọi việc, hoặc cần nền để nối nhiều agent, OpenBot là một lựa chọn đáng thử. Bạn nên bắt đầu bằng app máy tính trước khi nghĩ tới Kubernetes.

4.4/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

OpenBot có miễn phí không?

Bản mẫu OpenBot là mã nguồn mở theo giấy phép MIT. Tuy nhiên nó dùng CopilotKit Intelligence, được cấp phép riêng. Chạy trên laptop cá nhân thì cần giấy phép Intelligence cục bộ miễn phí, chạy Kubernetes để đánh giá cần giấy phép dùng thử miễn phí, còn sản xuất thì cần giấy phép sản xuất. Khoá mô hình như OpenAI là chi phí riêng của bạn.

OpenBot chạy được trên Windows không?

Được. README ghi có trình cài đặt có chữ ký cho Windows x64, không cần terminal. Nếu chạy từ mã nguồn, bạn cần WSL 2 với Ubuntu, chạy mọi lệnh trong cửa sổ Ubuntu và mở app bằng trình duyệt Windows ở http://127.0.0.1:3010.

Cần GPU hay máy cấu hình mạnh không?

Tư liệu không nêu yêu cầu GPU hay cấu hình phần cứng cụ thể. Bản mẫu dùng khoá mô hình trên đám mây như OpenAI, nên máy bạn chủ yếu cần chạy được Docker. Nếu muốn chạy mô hình cục bộ thì cần xem yêu cầu của mô hình đó, README chưa nói rõ.

Dữ liệu của tôi có an toàn không?

README nói bạn có thể chạy toàn bộ trên máy hoặc hạ tầng của mình, gồm OpenBot, Intelligence và một mô hình tương thích. Nhưng nếu dùng mô hình đám mây hay ứng dụng trực tuyến thì yêu cầu vẫn được gửi tới dịch vụ đó. Bản mẫu bật chế độ một người dùng, ai truy cập được cũng là quản trị viên, nên đừng mở ra ngoài khi chưa cấu hình đăng nhập.

OpenBot dùng được những mô hình AI nào?

README ghi bạn dùng được OpenAI, Claude, Gemini hoặc mô hình mở qua endpoint tương thích OpenAI. Khi chạy từ mã nguồn, Bot thử nghiệm dùng OpenAI, còn Bot LangGraph dùng được OpenAI, Anthropic hoặc Google.

OpenBot khác gì một chatbot AI thông thường?

Theo mô tả của tác giả, mỗi Bot có một máy tính riêng gồm trình duyệt, tệp và công cụ. Hành động được quyết định trước khi xảy ra và ghi lại sau đó, bạn có thể duyệt hoặc tiếp quản. README không so sánh trực tiếp với công cụ cụ thể nào khác.

Tôi có nối agent của mình vào OpenBot được không?

Được. README nói bạn kết nối agent hiện có qua AG-UI từ bất kỳ nền tảng chạy agent nào, và liệt kê nhiều bộ khung như Claude Agent SDK, Google ADK, AWS Strands, LangChain, Mastra, Pydantic AI, Agno, CrewAI. Hướng dẫn chi tiết nằm ở mục Connect your agent trong tài liệu, README phần này chưa ghi lệnh cụ thể.

Chuyển nhanh tới mục

  1. I.OpenBot làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Tải mã nguồn
    2. B.Tạo file .env và cài phụ thuộc
    3. C.Kết nối dự án Intelligence
    4. D.Điền các giá trị còn thiếu
    5. E.Khởi động
    6. F.Nếu bạn muốn chạy trên Kubernetes
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop nhờ Bot soạn và gửi thư trả lời khách
    2. B.Nhân viên văn phòng tiếp quản khi Bot bị kẹt
    3. C.Dev nối agent đang có vào chung không gian
    4. D.Đội kỹ thuật thử nghiệm trên Kubernetes
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.