SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor · Cập nhật ngày 2026-11-11

Tự host OpenBot trên VPS: mỗi bot một container

Tự host OpenBot với supervisor để mỗi bot có container, Chromium và workspace riêng. Xem gateway kiểm tra mọi thao tác ra sao và chi phí RAM thực tế.

Bạn nhận được gì khi tự host các AI coworker của OpenBot

Bạn tự host các AI coworker của OpenBot bằng cách chạy một gateway server trên phần cứng do bạn kiểm soát, cùng một supervisor cấp cho mỗi bot một container riêng. Container riêng của từng bot chỉ tồn tại khi COMPUTER_SUPERVISOR_URL được thiết lập. Nếu không có nó, mọi bot sẽ dùng chung một máy tính tại AGENT_COMPUTER_URL. Khi có supervisor, mỗi container của bot chứa một trình duyệt Chromium riêng và một workspace volume riêng, cùng một browser profile được giữ lại giữa các phiên. Mọi hành động bot thực hiện trên máy tính, file, server MCP (model context protocol) hoặc thành phần UI đều đi qua gateway đó. Gateway kiểm tra hành động theo policy trước khi thực hiện và ghi log sau đó. Nếu agent loop mà gateway này bọc quanh vẫn còn xa lạ với bạn, lộ trình từng bước trong học AI agent từ đầu sẽ hướng dẫn bạn tự viết một agent loop nhỏ trước khi cấp cho bot quyền dùng trình duyệt và thông tin đăng nhập của bạn.

OpenBot do CopilotKit phát hành theo giấy phép MIT tại github.com/CopilotKit/openbot. Bản phát hành đầu tiên có tag, v0.0.1, được phát hành vào ngày 17 August 2026, còn v0.2.0 được phát hành vào ngày 12 October 2026. Tính đến ngày 10 November 2026, bản mới nhất là v1.0.0, được phát hành vào ngày 9 November 2026, ba ngày sau v0.3.0, và README trên main không còn thông báo beta. Hãy xem đây là một thiết kế nghiêm túc nhưng vẫn còn một số điểm chưa hoàn thiện. Phần triển khai bên dưới cố định ở v0.2.0, và mọi bước trong đó đều mô tả bản phát hành này. v0.3.0 đã thay đổi cơ chế phê duyệt, cách chia sẻ trình duyệt và các giá trị mặc định của Helm chart, vì vậy hãy đọc ghi chú phát hành v0.3.0 và v1.0.0 trước khi bắt đầu với tag mới hơn. main hiện cấp cho mỗi người dùng một container và cấp một container riêng cho bot được đánh dấu Isolated.

Điểm đáng chú ý trong kiến trúc này cũng là phần tốn tài nguyên nhất. Mỗi agent cần một trình duyệt, và đây là chi phí bộ nhớ mà nhiều người quên tính đến. Vì vậy, phần này xác định cấu hình tài nguyên trước khi cài đặt.

Cách gateway quyết định mọi hành động

API server trên port 3001 là đường đi được kiểm soát đến máy tính của bot. Máy tính cũng cung cấp các service endpoint cấp thấp hơn được bảo vệ bằng token. Project yêu cầu giữ các endpoint này ở chế độ private và không bao giờ dùng chúng để bypass gateway. Vì vậy, gateway chỉ là đường đi duy nhất khi các endpoint đó không thể truy cập được. Trước khi một browser action chạy, gateway xác định target từ page snapshot, đánh giá các rule policy CEL (common expression language) dựa trên context, ghi một audit row chứa quyết định, rồi mới gọi container. Nếu việc thực thi thất bại sau đó, gateway ghi thêm một row thứ hai. Tài liệu nêu rõ ranh giới này: computer không quyết định policy; server gateway là ranh giới của action. Bên ngoài OpenBot, mô hình phân tách này có một tên gọi, vì loop, tool definition, permission check và session state cùng tạo thành harness bao quanh model, còn gateway này là phần permission của harness đó.

Policy evaluation sẽ fail closed, và các deny rule được đánh giá trước allow rule. Hướng xử lý khi có lỗi quan trọng hơn cú pháp rule. Policy bị thiếu hoặc rỗng sẽ không cho phép gì. Rule bị lỗi sẽ chuyển sang trạng thái block, dù đó là deny rule hay allow rule. Vì vậy, lỗi trong policy sẽ khiến bot bị kẹt thay vì khiến bot tự do truy cập các account của bạn. Policy mà OpenBot phát hành là vấn đề khác. Giá trị mặc định khi startup là deny: [] với allow: ["true"]. Cấu hình này cho phép mọi action cho đến khi AGENT_COMPUTER_POLICY hoặc một policy của administrator đã lưu thay thế nó. Vì vậy, hãy tự viết policy trước khi cho bot chạm vào dữ liệu thật. Layer này kiểm soát bot được làm gì, không kiểm soát bot được đọc gì. Do đó, một page chứa instruction nhắm đến agent vẫn là vấn đề riêng. Đây cũng là prompt injection surface mà bạn gặp khi đưa cho agent kết quả từ SearXNG instance của chính bạn.

Audit trail nằm trong PostgreSQL nên vẫn còn sau khi restart. Các lần bàn giao quyền điều khiển được ghi là computer.help_requested, computer.control_taken và computer.control_released. Nhờ đó, bạn có thể thấy bot yêu cầu con người tiếp quản và thấy con người trả quyền điều khiển lại cho bot. Secret được ghi dưới dạng số lượng ký tự, không bao giờ ghi giá trị. Các thao tác đọc, ghi và liệt kê file xuất hiện trong tab Activity. File đã lưu được hiển thị bằng path và size, không hiển thị contents. View này nằm trong browser và không phải audit record. Nếu bạn muốn cùng ranh giới kiểm soát đó mà không cần browser đứng phía sau, đặt approval trước các action của AI agent trình bày trường hợp hẹp hơn này.

Chi phí RAM và ổ đĩa của một bot

Dự án công bố số liệu đo được cho một Bot trên arm64. Đây là các con số sizing được in trong tài liệu triển khai. Chúng mô tả một bot trên một kiến trúc, vì vậy hãy xem đó là điểm bắt đầu, không phải kế hoạch công suất.

Biểu đồOpenBot published resource figures, one Bot on arm64 (October 2026)
Dữ liệu đằng sau biểu đồ này
[
  {
    "label": "Measured, one Bot",
    "memory_gb": 0.55,
    "disk_gb": 1.4,
    "vcpu": 0.06
  },
  {
    "label": "Documented minimum",
    "memory_gb": 2,
    "disk_gb": 4,
    "vcpu": 1
  },
  {
    "label": "Documented recommended",
    "memory_gb": 4,
    "disk_gb": 8,
    "vcpu": 2
  }
]

Mức sử dụng memory đỉnh được đo là 0.55 GB cho một Bot. Mức tối thiểu được ghi trong tài liệu là 2 GB và mức khuyến nghị là 4 GB. Khoảng chênh giữa số đo và mức tối thiểu là phần dự phòng cho Chromium tăng memory khi có tải, vì mức sử dụng memory của browser phụ thuộc vào các page đang mở chứ không phải trạng thái process lúc nhàn rỗi. Tài liệu ước tính mỗi page mở thêm đồng thời dùng khoảng 100 đến 200 MB. CPU lúc nhàn rỗi gần như bằng 0, ở mức 0.06 core tại đầu trên của phạm vi đo được, nên CPU không phải tài nguyên chính bạn đang mua. Image có kích thước 1.4 GB, trong khi volume được khuyến nghị là 8 GB. Phần chênh lệch là không gian dành cho /workspace, nơi bot lưu các file của nó. Image chỉ chứa các browser thuộc họ Chromium. Firefox và WebKit của Playwright không được đưa vào image.

Những con số đó không cho biết chi phí khi chạy nhiều bot cùng lúc, và dự án không công bố số liệu cho trường hợp này. Mức tối thiểu được ghi trong tài liệu là con số mà dự án sẵn sàng công bố, không phải số liệu được theo dõi trong điều kiện có tải. Vì vậy, việc chọn giữa PhotoPrism và Immich cũng dựa trên mức RAM tối thiểu đo được thay vì mức được công bố. Hãy tự đo trên hệ thống của bạn. Khởi động một bot, giao cho nó một tác vụ thực tế có mở một page, rồi theo dõi container trong lúc bot làm việc.

docker stats --no-stream
free -m

Lấy cột MEM USAGE của container chạy bot làm mức sử dụng cho mỗi bot. Cộng thêm gateway và PostgreSQL, sau đó nhân mức sử dụng của một bot với số bot bạn dự kiến chạy đồng thời. Bot nhàn rỗi vẫn giữ browser cho đến khi idle timeout đóng browser, mặc định là 30 phút, vì vậy phải tính cả các browser đang nhàn rỗi vào hệ số nhân. Cách tính này giống với cách dùng để sizing RAM và CPU cho VPS chạy coding agent. Phần liên quan đến browser được trình bày trong chạy headless browser cho agent trên VPS.

Một chi tiết của Chromium ảnh hưởng đến các plan nhỏ. OpenBot khởi động Chromium với --disable-dev-shm-usage, nên browser ghi dữ liệu vào /tmp thay vì /dev/shm. Cách này tránh lỗi crash trên các host có /dev/shm nhỏ, nhưng chuyển áp lực sang root filesystem. Đây là thêm một lý do khiến dung lượng disk được khuyến nghị lớn hơn image.

Làm thế nào để tự host OpenBot trên VPS?

Bạn cần Docker, Bun 1.3 trở lên, một project và license CopilotKit Intelligence, cùng quyền truy cập vào một model: dùng API key hoặc đăng nhập vào provider được hỗ trợ thay cho API key. README v0.2.0 yêu cầu Bun 1.3+ cho app và API server; main hiện tại nâng yêu cầu này lên 1.4+, vì vậy hãy đọc README của tag mà bạn clone. Từ v0.0.15, thông tin đăng nhập của provider có thể thay cho API key. Tài liệu phát triển cũng yêu cầu lsof, openssl và curl trên máy chủ, cùng npx từ Node để provision Intelligence. Hãy clone một release đã gắn tag thay vì main, vì main trong một project còn mới như vậy có thể thay đổi mà không báo trước. Nếu bạn đang chạy bản cài đặt v0.1.x, hãy đọc release notes v0.2.0 trước khi nâng cấp: quá trình nâng cấp sao chép các kết nối Composio đã lưu vào một table mới, còn rollback về v0.1.2 sau đó sẽ ẩn mọi account được kết nối sau khi nâng cấp.

git clone --branch v0.2.0 https://github.com/CopilotKit/openbot.git
cd openbot
cp .env.example .env
bun install

Provision project Intelligence. Hai lệnh đầu tiên đăng nhập và chọn project. Sau đó, helper script provision runtime key của project, tạo hoặc dùng lại container openbot Learning, rồi ghi cả hai thiết lập vào file môi trường.

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

Tạo key dùng để mã hóa credential đã lưu, rồi ghi output vào .env dưới dạng KEY_ENCRYPTION_KEY. Thêm OPENAI_API_KEY vào cùng file. Bot proof-of-concept sử dụng OpenAI. Với LangGraph Bot, bạn có thể đặt BOT_PROVIDER thành anthropic hoặc google rồi thêm key tương ứng. Để dùng thông tin đăng nhập model thay cho key, v0.2.0 .env.example nhận CLAUDE_CODE_OAUTH_TOKEN, là token lấy từ claude setup-token, và CHATGPT_AUTH_FILE, là file mà một ChatGPT plan đã đăng nhập ghi ra. API server đọc các giá trị này cho những agent tích hợp sẵn, còn compose truyền chúng cho Bot harness mà bạn chọn.

openssl rand -base64 32

Khi .env đang mở, hãy kiểm tra các thiết lập computer. .env.example để trống COMPUTER_SUPERVISOR_URL và SUPERVISOR_TOKEN, đồng thời trỏ AGENT_COMPUTER_URL đến computer dùng chung duy nhất trên port 4100. File compose có supervisor, và scripts/start.sh mặc định bật computer riêng cho từng bot bằng cách truyền COMPUTER_SUPERVISOR_URL và SUPERVISOR_TOKEN cho server. Nếu tự khởi chạy server, hãy đặt cả hai giá trị này. Nếu không có supervisor URL, mọi bot sẽ dùng chung một browser và các phiên đăng nhập của nó.

Sau đó khởi động.

bash scripts/start.sh

scripts/start.sh khởi động các Docker service, chạy database migration, khởi động server, routine worker và app, rồi kiểm tra health của chúng. Khi hoàn tất, app phục vụ trên port 3010 và API trên port 3001. Script báo các xung đột port và giữ nguyên service tương ứng đang chạy, vì vậy chạy lại lần thứ hai vẫn an toàn.

Hãy kiểm tra từ chính server trước khi expose bất kỳ service nào.

curl -sS -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3010
ss -ltnp | grep -E ':(3010|3001|4100|4500|5432)'

200 từ lệnh đầu tiên cho biết app đang phục vụ. Lệnh thứ hai hiển thị các địa chỉ mà những port đó bind vào; trên VPS, đây mới là thông tin cần quan tâm. Dòng có nội dung 127.0.0.1:3001 chỉ cho phép truy cập từ chính máy chủ. Dòng có nội dung 0.0.0.0:3001 nghĩa là bất kỳ ai có route đến server đều có thể truy cập.

Image container đơn

Tài liệu triển khai cũng cung cấp một image duy nhất chứa app, API và Chromium, phục vụ trên cổng 3001. Image này được phát hành dưới tên ghcr.io/copilotkit/openbot với các version tag, hoặc bạn có thể tự build từ bản clone của mình.

docker build -t openbot .
docker run -p 127.0.0.1:3001:3001 --env-file .env \
  -e EMBEDDED_POSTGRES=on -v openbot-data:/var/lib/postgresql openbot

EMBEDDED_POSTGRES=on chạy PostgreSQL bên trong container và áp dụng migration khi khởi động. Named volume giữ lại audit history qua mỗi lần triển khai lại. Nếu không có volume này, mỗi lần build lại sẽ xóa toàn bộ history đó. Hãy mount volume vào thư mục cha, /var/lib/postgresql, không phải trực tiếp vào data directory. Tài liệu cảnh báo rằng mount data directory có thể khiến cluster không được khởi tạo, sau đó app sẽ trả về lỗi 502. Nếu trỏ DATABASE_URL đến một managed database thay thế, phải bật extension vector trên database đó. Các dịch vụ managed như RDS, Cloud SQL và Azure Database đều hỗ trợ extension này, nhưng không dịch vụ nào tự bật nó cho bạn. Migration cũng yêu cầu role chạy migration phải sở hữu extension. Nếu extension được tạo bởi role khác, migration sẽ dừng với lỗi must be owner of extension vector.

Khi database nằm bên ngoài, hãy chạy migration như một release step.

docker run --rm --env-file .env --entrypoint sh openbot \
  -c "cd /app/server && bun scripts/migrate.ts"

Dùng scripts/migrate.ts thay vì drizzle-kit migrate, vì CLI drizzle-kit là development dependency và không có trong production image. Giữ --entrypoint sh, vì nếu thiếu tùy chọn này, API sẽ khởi động trước khi migration chạy xong.

Image này cố ý không publish browser port. Image cũng không include supervisor, vì supervisor cần Docker socket, trong khi các nền tảng serverless không cung cấp socket này. Không có supervisor, mọi bot dùng chung một browser và vì vậy dùng chung một bộ thông tin đăng nhập. Điều này loại bỏ isolation vốn là lý do cần chạy từng bot trong container riêng. Đây là phương án single-container duy nhất không cấp container riêng cho từng bot. Nếu lý do bạn dùng hệ thống này là cần thông tin đăng nhập riêng cho từng bot, hãy chạy compose stack với COMPUTER_SUPERVISOR_URL và SUPERVISOR_TOKEN được đặt, trên một host nơi bạn chấp nhận đánh đổi này. Một process có thể giao tiếp với Docker socket thì có thể khởi động một privileged container. Vì vậy, trên thực tế process đó có quyền root trên host. Đây là lý do hợp lý để giữ OpenBot trên một máy riêng, tương tự như cấp cho coding agent một VM dùng một lần.

Vì sao OPENBOT_SINGLE_USER chỉ phù hợp trên laptop

.env.example được phát hành kèm OPENBOT_SINGLE_USER=true. Thiết lập đó coi mọi request là của một administrator cố định và bỏ qua hoàn toàn bước đăng nhập. Trên laptop, đây là cách tiện lợi vì chỉ bạn mới có thể truy cập cổng đó. Trên VPS, điều này có nghĩa là bất kỳ ai truy cập được cổng 3010 đều trở thành administrator đó, trên một hệ thống lưu credential đã mã hóa và điều khiển browser đã đăng nhập vào các tài khoản của bạn.

Server hiện đã có cơ chế bảo vệ một phần. Nếu OPENBOT_SINGLE_USER=true được đặt và một mục OPENBOT_PUBLIC_URL, OPENBOT_APP_URL hoặc TRUSTED_ORIGINS được định tuyến công khai, server sẽ từ chối khởi động và nêu rõ địa chỉ đó. Địa chỉ private sẽ khiến server đưa ra warning. Kiểm tra này đọc các URL trong configuration của bạn, không đọc các interface mà Docker publish, nên các giá trị localhost mặc định vẫn vượt qua kiểm tra ngay cả khi một cổng đang mở ra Internet. Việc bind cổng vẫn do bạn thực hiện.

Có hai cách triển khai phù hợp. Giữ OPENBOT_SINGLE_USER=true, bind mọi cổng vào 127.0.0.1, rồi chỉ truy cập app qua SSH tunnel hoặc interface mạng private.

ssh -N -L 3010:127.0.0.1:3010 -L 3001:127.0.0.1:3001 you@your-vps

App sẽ có địa chỉ http://localhost:3010 trong browser của bạn. Chrome và Firefox xem địa chỉ này là secure context và giữ các cookie đăng nhập Secure được set qua đó. Safari là ngoại lệ: Safari cũng báo localhost là secure context, nhưng tính đến ngày 10 November 2026 vẫn từ chối lưu cookie Secure được set qua http://localhost không mã hóa. Đây là một bug còn mở của WebKit. Vì vậy, hãy mở tunnel bằng Chrome hoặc Firefox, hoặc đặt TLS phía trước. Bản thân màn hình live không cần secure context: tài liệu triển khai cho biết app không phụ thuộc vào các browser API bị http:// không mã hóa vô hiệu hóa. Cách còn lại là tắt chế độ single-user và cấu hình một identity provider thực sự. Hỗ trợ Google, Microsoft Entra, Okta, SAML và OIDC. Google, Entra và Okta được cấu hình trong environment, còn provider SAML và OIDC được đăng ký bên dưới Admin, Identity providers sau khi deployment chạy. Mọi provider cũng cần BETTER_AUTH_SECRET có độ dài từ 32 ký tự trở lên, BETTER_AUTH_URL được đặt thành public API base URL để dùng cho OAuth callback và INITIAL_ADMIN_EMAILS. TRUSTED_ORIGINS không nằm trong danh sách bắt buộc đó, nhưng chứa các app origin mà API chấp nhận, cùng với mọi host trong discovery document của OIDC provider đã đăng ký. OPENBOT_APP_URL mặc định dùng entry đầu tiên, vì vậy hãy đặt nó thành public app origin của bạn. Credential của provider phải đầy đủ, vì provider được cấu hình dở dang sẽ khiến startup dừng lại thay vì chuyển về quyền truy cập mở. Nếu bạn thêm account vì mỗi người trong team muốn có agent riêng thay vì browser riêng, OneCLI được thiết kế ngay từ đầu cho mô hình đó, với một agent được sandbox riêng cho mỗi người và model key được giữ trong một gateway duy nhất.

Nếu app có thể truy cập bằng một public name, hãy đặt TLS (bảo mật tầng truyền tải) phía trước app. Một page được phục vụ qua http:// không mã hóa trên địa chỉ khác localhost không phải là secure context, nên các cookie được đánh dấu Secure sẽ không được lưu và đăng nhập sẽ fail theo cách trông giống như một bug trong OpenBot.

Bảo vệ các cổng tầng thấp bằng firewall

Ghi chú bảo mật của OpenBot nêu rõ rằng các endpoint service tầng thấp được bảo vệ bằng token, bạn nên giữ chúng ở chế độ private và không được dùng chúng để bypass gateway. Token là lớp bảo vệ thứ hai. Lớp đầu tiên là không thể truy cập cổng đó.

agent-computer lắng nghe trên cổng 4100 và yêu cầu COMPUTER_TOKEN. Các endpoint của bot lắng nghe trên cổng 4200 và 4201, còn agent harness lắng nghe trên cổng 4202. supervisor lắng nghe trên cổng 4500 ở host và cổng 4300 bên trong container; file compose bind nó vào 127.0.0.1:4500. PostgreSQL lắng nghe trên cổng 5432. Không cổng nào trong số đó được đặt trên public interface. Trong deployment chỉ có một user, app và API cũng không nên được public.

sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp
sudo ufw enable
sudo ufw status verbose

Có một bẫy khiến nhiều người nghĩ firewall là đủ. Việc publish một cổng của container bằng -p 3001:3001 khiến Docker cài một rule DNAT. Vì vậy, traffic được xử lý trong đường đi FORWARD và không bao giờ đi qua chain INPUT do chính sách deny mặc định của ufw kiểm soát. Cổng vẫn mở dù ufw status vẫn in ra Status: active. Hãy bind cổng đã publish vào loopback ngay trong mapping, như -p 127.0.0.1:3001:3001, hoặc đặt host address trong file compose. Hãy xác minh bằng ss -ltnp, không dùng ufw status. Bẫy này không riêng gì OpenBot, vì vậy hãy kiểm tra tương tự với mọi container khác mà bạn đã publish trên máy, bao gồm cả dịch vụ đang phục vụ một thư viện Jellyfin được dựng lại như cửa hàng video thập niên 90.

OpenBot có thể chạy offline với Intelligence tự host

Hãy xác định điều này trước khi lập kế hoạch triển khai. OpenBot phụ thuộc vào một project Intelligence của CopilotKit. Project này lưu thread bền vững và bộ nhớ hội thoại trên dịch vụ hosted hoặc hạ tầng của bạn. Server được ghim phiên bản v0.2.0 sẽ xác thực INTELLIGENCE_API_URL, INTELLIGENCE_GATEWAY_WS_URL và INTELLIGENCE_API_KEY khi khởi động. Server kiểm tra cả ba dưới dạng một bộ và từ chối khởi động nếu thiếu bất kỳ giá trị nào. COPILOTKIT_LICENSE_TOKEN là tùy chọn. Chỉ Intelligence tự host có license riêng mới sử dụng giá trị này. Tính đến ngày 10 November 2026, Intelligence hosted miễn phí bao gồm 1,000 interaction cho mỗi organization mỗi tháng. Tuy nhiên, kể từ v0.1.0, OpenBot sẽ hiển thị banner self-hosting trừ khi deployment có paid Intelligence plan hoặc đặt OPENBOT_SELF_HOST_BANNER=false. Bản thân Intelligence cũng có thể self-host, nên có thể triển khai hoàn toàn local, nhưng cần nhiều công việc hơn so với quickstart. Production deployment offline yêu cầu Annual. Self-hosted pay as you go phải kết nối để báo cáo usage phục vụ billing. Developer Edition miễn phí hỗ trợ đánh giá local non-production với license có thể gia hạn trong 30 ngày. Việc cài đặt và gia hạn cần có kết nối Internet. Intelligence CLI local ghi key vào CPK_INTELLIGENCE_API_KEY, còn release được ghim tại v0.2.0 chỉ đọc INTELLIGENCE_API_KEY. Vì vậy, hãy copy giá trị sang biến còn lại khi dùng release này. main hiện tại chấp nhận trực tiếp CLI key và ưu tiên key đó.

Model là dependency thứ hai. Không có model nào được cài sẵn. BOT_PROVIDER chấp nhận openai, anthropic hoặc google cho LangGraph Bot. OPENAI_BASE_URL trỏ đường dẫn OpenAI đến bất kỳ endpoint tương thích nào. Đây là trường hợp phù hợp để chạy Ollama trên VPS nhằm tự host LLM nếu bạn muốn các token vẫn nằm trên phần cứng của mình. Điều khiển trình duyệt yêu cầu model khá nhiều, vì vậy hãy thử model local với một tác vụ thực tế trước khi quyết định dùng model đó.

Mở rộng vượt quá một replica

Gateway phân giải các tham chiếu phần tử dựa trên snapshot của trang. Snapshot đó hiện được lưu trong PostgreSQL, nên replica thứ hai có thể thao tác trên snapshot do replica thứ nhất tạo ra. Helm chart chính thức chạy 2 API replica theo mặc định và lưu mọi dữ liệu mà một replica cần giữ lại trong PostgreSQL. Chart cũng tắt trình duyệt tích hợp và không cho cài đặt trình duyệt đó khi chạy nhiều hơn 1 replica. Nếu có một browser bên trong API pod, browser đó sẽ giữ các phiên đăng nhập của một bot. Khi scale API, số phiên đăng nhập này cũng tăng theo. Trường hợp single image cần đặc biệt chú ý, vì mỗi replica có browser riêng. Do đó, phiên đăng nhập của một bot vẫn nằm trên instance đã phục vụ bot đó. Trên một VPS, browser của mọi bot vẫn chạy trên cùng một host, nên cách mở rộng là nâng cấp cấu hình của máy. Việc cô lập giữa các bot vẫn do các container riêng cho từng bot đảm nhiệm, tương tự như sandbox agent tự host giữ cho lỗi của một agent không ảnh hưởng đến các agent khác.

Các lỗi thường gặp và dấu hiệu nhận biết

Startup thoát ngay sau khi bạn điền .env. Server kiểm tra configuration trước khi phục vụ request. Mỗi trường hợp sau đều làm startup dừng thay vì âm thầm chạy với configuration thiếu: block Intelligence chưa đầy đủ, thiếu KEY_ENCRYPTION_KEY, OAuth provider có client ID nhưng không có secret, hoặc bật single-user mode cùng với public URL. Đọc lỗi đầu tiên, sửa đúng field đó rồi start lại.

Migration fail trên managed database. Có 2 nguyên nhân thường gặp. Extension vector chưa được enable và role chạy migration không có quyền tạo extension, nên migration gặp column type mà PostgreSQL không biết. Hoặc extension được tạo bởi role khác, khiến migration dừng với must be owner of extension vector. Hãy tạo extension bằng role chạy migration, rồi chạy lại bước migration.

App load được nhưng đăng nhập không được duy trì. Bạn đang phục vụ qua http:// thuần trên một public address. Đây không phải secure context, nên cookie Secure bị browser loại bỏ. Hãy đặt TLS phía trước hoặc dùng SSH tunnel để browser thấy localhost. Khi dùng tunnel, hãy dùng Chrome hoặc Firefox vì Safari vẫn loại bỏ cookie Secure được set qua http://localhost thuần.

Các bot dùng chung những login mà bạn muốn tách riêng. Supervisor chưa được sử dụng, nên không có máy tính riêng cho từng bot và mọi bot đều dùng chung browser tại AGENT_COMPUTER_URL. Xác nhận COMPUTER_SUPERVISOR_URL đã được set và supervisor có thể truy cập Docker socket.

Bot dừng lại và yêu cầu trợ giúp. Đây là thiết kế đang hoạt động đúng. Audit trail ghi lại computer.help_requested, bạn tiếp quản trên màn hình live và việc bàn giao được ghi lại ở cả hai phía.

FAQ

OPENBOT_SINGLE_USER để bật khi triển khai VPS có an toàn không?

Chỉ an toàn khi không thể truy cập gateway từ Internet. OPENBOT_SINGLE_USER=true chấp nhận mọi request dưới danh tính một administrator cố định mà không yêu cầu đăng nhập, nên bất kỳ ai mở được cổng đều có toàn quyền với deployment, credential đã lưu và trình duyệt đã đăng nhập. Ở chế độ này, server từ chối khởi động khi một public URL hoặc trusted origin đã cấu hình được định tuyến công khai, nhưng cơ chế kiểm tra đó không biết các cổng của bạn đang được publish như thế nào. Có thể chấp nhận khi mọi cổng đều bind vào 127.0.0.1 và bạn truy cập app qua SSH tunnel hoặc private network interface. Trên public interface, hãy tắt chế độ này và cấu hình Google, Microsoft Entra, Okta hoặc OIDC cùng với BETTER_AUTH_SECRET, BETTER_AUTH_URL và INITIAL_ADMIN_EMAILS, đồng thời đặt TRUSTED_ORIGINS thành public app origin của bạn.

Một bot OpenBot cần bao nhiêu RAM?

Số liệu được project công bố cho một Bot trên arm64 cho thấy memory peak là 0.55 GB, trong đó 2 GB là mức tối thiểu được ghi nhận và 4 GB là mức khuyến nghị. Project không công bố số liệu cho nhiều bot chạy đồng thời, vì mỗi bot giữ một Chromium riêng. Hãy chạy một bot với tác vụ thực tế, đọc memory của container đó trong docker stats, cộng thêm gateway và database, rồi nhân với số bot dự kiến chạy đồng thời.

Có cần tài khoản CopilotKit để self-host OpenBot không?

Có. OpenBot phụ thuộc vào một CopilotKit Intelligence project để lưu durable thread và memory, đồng thời server v0.2.0 được ghim phiên bản sẽ từ chối khởi động nếu Intelligence API URL, gateway WebSocket URL và API key chưa được đặt đầy đủ. Tính đến ngày 10 November 2026, đã có free hosted plan; triển khai production offline cũng được hỗ trợ bằng Intelligence tự host trên Annual và một local model. Bạn cũng phải tự cung cấp quyền truy cập model, model API key hoặc thông tin đăng nhập của provider được hỗ trợ để thay thế, vì OpenBot không đi kèm model nào.

Vì sao mỗi bot có browser riêng thay vì dùng chung một browser?

Vì browser profile chính là một danh tính. Browser dùng chung cũng có nghĩa là cookie và session dùng chung, nên một bot đăng nhập vào tài khoản nào thì mọi bot đều đăng nhập vào tài khoản đó. Container riêng cho từng bot cung cấp cho mỗi coworker một profile và login riêng, nhưng chỉ khi COMPUTER_SUPERVISOR_URL trỏ server đến supervisor. Nếu không có cấu hình này, mọi bot sẽ dùng chung một browser. Chi phí là memory, vì mỗi bot chạy một Chromium và đây là thành phần tiêu tốn nhiều memory nhất khi sizing.

Nên mở những cổng OpenBot nào trên firewall?

Không mở các cổng cấp thấp. Agent-computer trên 4100, các bot endpoint trên 4200 và 4201, agent harness trên 4202, supervisor trên 4500 và PostgreSQL trên 5432 đều phải giữ private. Project bảo vệ các endpoint này bằng token và yêu cầu bạn vẫn giữ chúng không thể truy cập từ bên ngoài. Chỉ publish những gì người dùng cần mở, đồng thời lưu ý rằng container port được publish bằng -p 3001:3001 vẫn có thể truy cập bất kể rule ufw default-deny, vì rule DNAT của Docker đưa traffic đó vào path FORWARD thay vì INPUT.

Bài viết này có hữu ích không?