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à một ứng dụng mã nguồn mở (MIT) của CopilotKit, cho phép bạn giao việc cho các Bot AI có trình duyệt, tệp và công cụ riêng, và chỉ gửi đi khi bạn đã duyệt. Cách dễ nhất là tải app cho Mac hoặc Windows, không cần terminal. Chạy từ mã nguồn khó hơn: cần Docker, Bun, tài khoản CopilotKit Intelligence và một khoá model.

OpenBot là một không gian làm việc mã nguồn mở dành cho các «đồ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ụ. Mọi hành động được quyết định trước khi làm và được ghi lại sau khi làm. Repo do CopilotKit, đội đứng sau giao thức AG-UI, phát triển và hiện có khoảng 11.799 sao, 1.452 fork.

Vấn đề repo giải quyết khá quen thuộc. Nhiều công cụ AI trả lời hay nhưng khi giao việc thật như vào web, điền form, gửi thư thì bạn không dám để nó tự làm. OpenBot đặt phần «cho phép» vào trung tâm: Bot dùng trình duyệt, làm xong phần chuẩn bị, rồi chờ bạn bấm duyệt trước khi gửi. Khi Bot kẹt, bạn có thể vào tiếp quản.

Ai nên dùng? Người làm kinh doanh hoặc văn phòng muốn thử một trợ lý AI có kiểm soát, và lập trình viên muốn một khung sườn để tuỳ biến, đổi thương hiệu, gắn agent có sẵn. Điểm đáng giá nhất là bạn có thể tải app cài như phần mềm thường, không cần gõ lệnh. Xem video ngắn bên dưới để thấy một Bot làm việc trước khi bạn cài.

Ứ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 và 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ì

  • Mỗi Bot có máy tính riêng. Bot có trình duyệt, tệp và công cụ của nó. Việc của Bot này không lẫn sang Bot khác, và bạn có thể xem Bot đang làm gì trên màn hình.
  • Duyệt trước, ghi lại sau. README nhấn mạnh mọi hành động được quyết định trước khi xảy ra và được ghi lại sau đó. Với bạn, điều này nghĩa là Bot chuẩn bị xong rồi chờ bạn đồng ý trước khi gửi.
  • Tiếp quản khi cần. Bot gặp bước cần con người, ví dụ đăng nhập hay xác nhận, bạn có thể vào làm tiếp rồi trả lại.
  • Kết quả tương tác. Bot trả lời bằng kết quả có thể thao tác, không chỉ một khối chữ.
  • Chọn model tuỳ ý. Dùng OpenAI, Claude, Gemini, hoặc model mở qua một endpoint tương thích OpenAI, do nhà cung cấp hoặc chính bạn đặt máy chủ. Đổi model sau này không phải làm lại từ đầu.
  • Mang agent của bạn vào. Ngoài Bot dựng sẵn, bạn kết nối agent đang có qua AG-UI. Repo có sẵn nhiều thư mục mẫu như LangGraph, CrewAI, Mastra, Pydantic AI, Google ADK, AWS Strands, Claude Agent SDK, Agno, LlamaIndex.
  • Mở rộng bằng MCP. AG-UI nối agent, MCP nối công cụ, nên phần giao diện và phần backend phát triển độc lập.
  • Quản trị cho cả nhóm. Đăng nhập công ty, phân quyền, quyền dùng công cụ, phê duyệt và nhật ký audit. Phần này thuộc hướng «OpenBot for Business».
  • Nhiều nơi dùng. Mac, Windows có sẵn. Web, iOS, Android, Slack, Teams hiện README ghi là đăng ký truy cập sớm.

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

Tuỳ cách bạn chọn, yêu cầu khác nhau.

Cách 1: app trên laptop. README nói đây là cách dễ nhất, app đã gồm sẵn giao diện và backend chạy bằng Docker. Có bản .dmg cho Mac Apple silicon và Intel, và bản cài cho Windows x64. README ghi là không cần terminal hay công cụ lập trình.

Cách 2: chạy từ mã nguồn. Theo README bạn cần:

  • Docker, dùng cho PostgreSQL và các Bot dựng sẵn.
  • 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. Có gói miễn phí, và Intelligence cũng có thể tự chạy trên máy của bạn.
  • Một khoá model. Bot thử nghiệm dùng OpenAI. Bot LangGraph dùng được OpenAI, Anthropic hoặc Google.
  • Trên Windows: chạy trong WSL 2 với Ubuntu.

Cách 3: Kubernetes. Cần cụm có node amd64, StorageClass mặc định, kubectl, Helm, giấy phép dùng thử hoặc production, và khoá model. Cách này hợp với đội kỹ thuật, bài này chỉ điểm qua.

OpenBot dùng CopilotKit Intelligence, phần này cấp phép riêng. Chạy trên laptop cho cá nhân hoặc thử nghiệm cần giấy phép Intelligence miễn phí, app desktop tự lo giúp bạn. Chạy production trên Kubernetes cần giấy phép production. Khoá model (như OpenAI) có thể phát sinh chi phí theo mức dùng, hãy tự kiểm tra bên nhà cung cấp.

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

  1. Chọn cách càiTải app nếu muốn nhanh, hoặc chạy từ mã nguồn nếu muốn tuỳ biến
  2. Lấy mã nguồnClone repo và vào thư mục OpenBot
  3. Tạo .envSao chép .env.example rồi cài thư viện bằng Bun
  4. Kết nối IntelligenceĐăng nhập CopilotKit, chọn project, chạy script setup-learning
  5. Điền khoá modelĐiền OPENAI_API_KEY vào .env
  6. ChạyChạy scripts/start.sh rồi mở trình duyệt

A.Cách nhanh nhất: tải app về máy

Trong README, mục «On your laptop» có ba liên kết tải: Mac Apple silicon, Mac Intel và Windows. Bạn tải đúng bản cho máy mình, cài như phần mềm bình thường. README mô tả đây là app độc lập, gộp giao diện OpenBot và backend chạy Docker trong một ứng dụng. Mình đề nghị người mới bắt đầu từ đây. Link tải nằm ở phần README của repo trên GitHub.

Các bước bên dưới dành cho bạn nào muốn chạy từ mã nguồn.

B.Bước 1: lấy mã nguồn

Mở terminal. Trên Windows, mở terminal Ubuntu của WSL 2, không dùng PowerShell thường. 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 đi vào thư mục vừa tải. Mọi lệnh sau đều chạy trong thư mục này, vì file .env sẽ nằm ở đây.

C.Bước 2: tạo file .env và cài thư viện

Terminal
cp .env.example .env
bun install

Lệnh cp sao chép file mẫu thành file .env thật. 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 (trang chủ Bun có hướng dẫn).

README ghi cấu hình mẫu đặt OPENBOT_SINGLE_USER=true, nghĩa là bạn dùng thử với tư cách quản trị viên cục bộ. Đừng cho người khác truy cập khi chưa cấu hình đăng nhập.

D.Bước 3: 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 tài khoản CopilotKit rồi chọn một project. Lệnh bun scripts/setup-learning.ts tạo khoá runtime cho project đó, tạo hoặc dùng lại container Learning tên openbot, rồi tự ghi các giá trị vào .env. Bạn không phải tự chép khoá.

README cũng nói khi chạy bash scripts/start.sh, cùng phiên đăng nhập CLI sẽ tự cấp Composio, dịch vụ cho các ứng dụng kết nối. Nếu bước này không xong, OpenBot vẫn chạy nhưng phần ứng dụng kết nối chưa dùng được. Bạn có thể chạy trước hoặc chạy lại sau bằng:

Terminal
bun run setup:composio

Nếu bạn tự chạy Intelligence (tự lưu trữ), cách làm khác: README bảo đặt INTELLIGENCE_API_URL trỏ tới máy chủ của bạn, chạy script mà không cần hai lệnh npx, rồi tự đặt INTELLIGENCE_GATEWAY_WS_URL cho cùng máy chủ. Script này mở một cửa sổ Chrome hoặc Edge riêng để bạn đăng nhập, nên máy cần có một trong hai trình duyệt.

E.Bước 4: điền khoá model

Mở file .env bằng trình soạn thảo, điền giá trị cho:

  • OPENAI_API_KEY

Các địa chỉ Intelligence quản lý sẵn trong .env.example thì giữ nguyên, trừ khi bạn tự chạy Intelligence. KEY_ENCRYPTION_KEY trong file mẫu là khoá công khai, README nói dùng trên máy cá nhân thì không sao. Muốn tạo khoá riêng:

Terminal
openssl rand -base64 32

Chỗ người mới hay vấp: đây là khoá của chính bạn, không dán lên chỗ công khai, và không đưa file .env vào Git.

F.Bước 5: chạy

Terminal
bash scripts/start.sh

Script khởi động các dịch vụ Docker, chạy migration cho cơ sở dữ liệu, bật API ở cổng 3001, bật bộ chạy tác vụ định kỳ, bật app ở cổng 3010, rồi kiểm tra từng dịch vụ có trả lời hay không trước khi in hướng dẫn tiếp theo. Nhớ mở Docker trước khi chạy.

Sau đó mở trình duyệt vào http://localhost:3010. Trên Windows với WSL 2, README dặn mở từ trình duyệt Windows ở http://127.0.0.1:3010 và giữ cửa sổ Ubuntu mở suốt lúc dùng.

Muốn dừng:

Terminal
bash scripts/stop.sh

Script này tắt cả máy tính của từng Bot. Thêm --keep-computers nếu muốn giữ chúng 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 đều nằm trong volume.

Nếu bạn dùng AI hỗ trợ cài, README gợi ý dán nội dung file prompt.txt trong repo vào trước. File này liệt kê những ô khoá nào bạn phải điền và các thông báo từ chối khởi động nghĩa là gì.

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

Theo README, dấu hiệu tốt nhất là scripts/start.sh chạy đến cuối: nó tự kiểm tra các dịch vụ trả lời đúng đường dẫn sức khoẻ rồi mới in bước tiếp theo. Nếu nó dừng giữa chừng và báo từ chối, hãy đọc kỹ thông báo đó.

Sau đó mở http://localhost:3010. Thấy giao diện OpenBot mở ra và bạn vào được với tư cách quản trị viên cục bộ là thành công. Thử giao một việc nhỏ cho Bot và xem nó có trả lời được không. Nếu Bot không đáp, nghi ngờ đầu tiên là OPENAI_API_KEY chưa điền hoặc sai.

Với app tải về, dấu hiệu thành công là app mở lên và bạn dùng được ngay. README chưa mô tả chi tiết từng màn hình thiết lập, nên bạn cứ làm theo hướng dẫn trong app.

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

Phần này mình dựa vào khả năng README mô tả: Bot dùng trình duyệt và công cụ, chờ bạn duyệt trước khi gửi, có thể tiếp quản, và kết nối thêm ứng dụng qua Composio. Cách hiệu quả thế nào còn tuỳ model và công cụ bạn gắn.

A.Chủ shop nhờ Bot chuẩn bị thư trả lời khách

Bạn bán hàng online, mỗi sáng có chục thư hỏi giá và giao hàng. Bạn giao cho Bot một câu như: «Đọc các thư khách hỏi giao hàng, soạn câu trả lời lịch sự và đợi mình duyệt». Bot soạn xong, dừng lại ở bước gửi và chờ bạn bấm đồng ý. Bạn đọc nhanh, sửa chỗ cần sửa, rồi duyệt. Ở đây giá trị nằm ở chỗ bạn không phải tin mù quáng: gửi hay không vẫn do bạn quyết. Việc đọc thư cần bạn đã kết nối ứng dụng phù hợp.

Bot làm phần việc nặng, còn quyền bấm gửi vẫn là của bạn.

Ông T

B.Nhân viên văn phòng giao việc tra cứu trên web

Bạn cần so sánh giá của vài nhà cung cấp trên website. Bạn nhờ Bot: «Mở các trang này, ghi lại giá và điều kiện giao hàng vào một danh sách». Bot dùng trình duyệt riêng của nó để thao tác, bạn xem được màn hình của Bot. Khi trang yêu cầu đăng nhập, bạn tiếp quản, đăng nhập, rồi trả lại cho Bot. Kết quả là một bản tổng hợp bạn chỉ cần kiểm tra.

C.Lập trình viên gắn agent đang có vào chung không gian

Bạn đã có một agent viết bằng LangGraph hoặc CrewAI. Repo có sẵn thư mục mẫu cho nhiều framework như agent-langgraph, agent-crewai, agent-mastra. Bạn kết nối agent của mình qua AG-UI để nó dùng chung công cụ, máy tính và quy tắc phê duyệt của OpenBot. Bạn không cần viết lại giao diện chat hay phần quản trị. README chưa đưa lệnh cụ thể cho việc này trong phần mình có, nên hãy xem thư mục docs/ và các thư mục agent-* trong repo.

D.Đội nhỏ thử quản trị trước khi giao việc quan trọng

Một đội muốn dùng AI nhưng sếp lo chuyện ai làm gì. Bạn triển khai theo hướng Kubernetes hoặc OpenBot for Business: có đăng nhập công ty, phân quyền công cụ, phê duyệt và nhật ký. Mọi hành động của Bot nằm trong lịch sử để xem lại. README nói rõ bản đánh giá nhanh trên Kubernetes chỉ nên truy cập qua port-forward cục bộ, vì cấu hình đó là một người dùng và ai vào được cũng là quản trị viên. Cấu hình đăng nhập và TLS trước khi chia sẻ cho người khác.

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

Báo không tìm thấy bun hoặc lỗi lạ khi chạy test. Bạn chưa cài Bun, hoặc đang dùng bản cũ. README yêu cầu Bun 1.4 trở lên và cảnh báo bản 1.3 làm một số test lỗi. Cài hoặc nâng cấp Bun rồi chạy lại.

start.sh không khởi động được dịch vụ. Docker chưa mở là nguyên nhân hay gặp nhất, vì PostgreSQL và các Bot chạy trong Docker. Bật Docker rồi chạy lại. Nếu vẫn lỗi, đọc thông báo từ chối của script và đối chiếu với file prompt.txt trong repo, nơi README nói có giải thích từng thông báo.

Gõ lệnh trên Windows không chạy. README yêu cầu chạy trong WSL 2 với Ubuntu, không phải PowerShell thường. Mở terminal Ubuntu, clone repo trong đó và chạy mọi lệnh từ đó. Xem mục Windows (WSL 2) trong tài liệu của repo để biết cần cài gì trước.

Bot không trả lời hoặc báo lỗi khoá. Kiểm tra OPENAI_API_KEY trong .env đã điền đúng chưa. Sửa xong thì chạy lại start.sh. Khoá hết hạn mức hoặc sai quyền cũng cho kết quả tương tự, hãy kiểm tra bên nhà cung cấp.

Script đăng nhập không mở được cửa sổ. Script setup-learning.ts cần Chrome hoặc Edge để mở cửa sổ đăng nhập riêng. Hãy cài một trong hai trình duyệt rồi chạy lại. Phần ứng dụng kết nối (Composio) lỗi thì OpenBot vẫn chạy, bạn thử lại bằng bun run setup:composio sau.

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

Điểm mạnh. Ý tưởng duyệt trước, ghi lại sau rất hợp người chưa dám giao việc thật cho AI. Có bản app cài sẵn cho Mac và Windows nên người không rành kỹ thuật vẫn thử được. Giấy phép MIT cho phép sửa và đổi thương hiệu, bạn chọn model theo ý, và kết nối được nhiều loại agent qua AG-UI. Repo còn được cập nhật trong vài tháng gần đây.

Giới hạn. Cài từ mã nguồn không nhẹ: cần Docker, Bun, tài khoản CopilotKit Intelligence và khoá model. Phần Intelligence cấp phép riêng, nên «mã nguồn mở» ở đây chỉ nói về phần template của OpenBot. Dùng cho đội trên Kubernetes cần hiểu Helm và hạ tầng, hoặc làm việc với đội của CopilotKit. Web, di động, Slack, Teams hiện là đăng ký truy cập sớm. Nếu bạn dùng model đám mây hay app online thì yêu cầu vẫn được gửi tới dịch vụ đó, chỉ khi chạy model cục bộ mới thật sự ở lại trên máy.

Khi nên chọn cách khác. Nếu bạn chỉ cần một khung chat để hỏi đáp, công cụ này hơi nặng. Nếu bạn muốn tự động hoá một việc đơn giản và cố định, một script hay công cụ tự động hoá thông thường sẽ gọn hơn. OpenBot đáng thử khi bạn muốn Bot làm việc trên web và công cụ nhưng vẫn giữ quyền duyệt và nhật ký đầy đủ.

4.5/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?

Phần template 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 cho cá nhân hoặc thử nghiệm cần giấy phép Intelligence miễn phí, còn production trên Kubernetes cần giấy phép production. Khoá model như OpenAI là phần bạn tự lo.

Cài OpenBot có cần biết lập trình không?

Không nếu bạn dùng app tải về. README ghi bản cài cho Mac và Windows không cần terminal hay công cụ lập trình. Chạy từ mã nguồn thì bạn cần dùng terminal, Docker và Bun, nên hợp với người có chút kinh nghiệm hơn.

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

Được. Có bản cài cho Windows x64. Nếu chạy từ mã nguồn, README yêu cầu dùng WSL 2 với Ubuntu, chạy mọi lệnh trong terminal Ubuntu và mở app từ trình duyệt Windows.

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

README không nêu yêu cầu GPU hay cấu hình phần cứng cụ thể trong phần mình có. Nếu bạn dùng model đám mây như OpenAI thì phần tính toán nặng nằm ở nhà cung cấp. Muốn chạy model cục bộ thì cần đối chiếu yêu cầu của model đó.

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

OpenBot có thể chạy hoàn toàn cục bộ gồm OpenBot, Intelligence và một model tương thích, theo README. Nhưng nếu bạn dùng model đám mây hoặc ứng dụng trực tuyến thì yêu cầu vẫn được gửi tới dịch vụ đó. Bản đánh giá cục bộ chỉ nên dùng một mình, vì ai truy cập được cũng là quản trị viên.

OpenBot dùng được những model nào?

README nêu OpenAI, Claude, Gemini, và model mở qua endpoint tương thích OpenAI, do nhà cung cấp hoặc chính bạn đặt máy chủ. Bot thử nghiệm dùng OpenAI, còn Bot LangGraph dùng được OpenAI, Anthropic hoặc Google.

Tôi đã có agent riêng, có dùng chung với OpenBot được không?

Được. README nói bạn có thể kết nối agent hiện có qua AG-UI, từ nhiều nền tảng và framework khác nhau, và chúng dùng chung không gian làm việc với các Bot dựng sẵn. Repo có các thư mục mẫu cho nhiều framework, nhưng hướng dẫn chi tiết nằm trong tài liệu của repo.

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.Cách nhanh nhất: tải app về máy
    2. B.Bước 1: lấy mã nguồn
    3. C.Bước 2: tạo file .env và cài thư viện
    4. D.Bước 3: kết nối dự án Intelligence
    5. E.Bước 4: điền khoá model
    6. F.Bước 5: chạy
  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 chuẩn bị thư trả lời khách
    2. B.Nhân viên văn phòng giao việc tra cứu trên web
    3. C.Lập trình viên gắn agent đang có vào chung không gian
    4. D.Đội nhỏ thử quản trị trước khi giao việc quan trọng
  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ỏ.