# Agent Zero: AI agent có sẵn máy Linux riêng để làm việc — hướng dẫn cài đặt và dùng

> Agent Zero là một AI agent mã nguồn mở viết bằng Python, được cấp sẵn một máy Linux trong hộp cách ly (sandbox) để nghiên cứu, viết code và làm việc với tài liệu qua terminal, trình duyệt và ứng dụng desktop. Bạn dùng qua giao diện web trên trình duyệt. Cài không khó nếu dùng A0 Launcher (máy tính) hoặc một dòng lệnh A0 Install (máy chủ), nhưng cần Docker và một tài khoản AI, API key hoặc model chạy local.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-07-31 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/agent-zero-ai-agent-may-linux-rieng-huong-dan-cai-dat

Agent Zero là một AI agent mã nguồn mở có sẵn không gian làm việc Linux riêng. Nó có terminal, trình duyệt và cả ứng dụng desktop, nên không chỉ trả lời chữ như chatbot mà còn tự làm việc: tìm tài liệu, viết code, tạo file, mở web, điền form. Tất cả chạy trong một hộp cách ly (sandbox), bạn có thể xem và can thiệp bất cứ lúc nào.

Repo này hợp với ba nhóm người. Nhóm một là nhân viên văn phòng, chủ shop muốn giao cho AI những việc nhiều bước như soạn kế hoạch, làm bảng tính, nghiên cứu một chủ đề. Nhóm hai là lập trình viên mới cần một trợ lý đọc code, sửa code, chạy test. Nhóm ba là người thích tự tay chỉnh công cụ, vì gần như không có gì bị giấu: prompt, tool đều nằm sẵn trong thư mục repo để bạn xem và sửa.

Điểm đáng giá nhất là bạn được “cho agent một chiếc máy tính thật” mà vẫn kiểm soát được. Hiện repo có khoảng 19.846 sao và 3.870 fork, vẫn được cập nhật trong vài tháng gần đây. Bạn có thể xem video ngắn bên dưới để thấy nó chạy ra sao, rồi quay lại đây làm theo từng bước.

```repo
- repo | agent0ai/agent-zero
- kind | Agent
- desc | Agent Zero là AI agent mã nguồn mở có không gian làm việc Linux riêng: tự duyệt web, viết code, làm tài liệu, chạy an toàn trong Docker.
- stars | 20k
- lang | Python
```

```video
- youtube | https://youtube.com/shorts/6sws_iIM1pI
- facebook | https://www.facebook.com/reel/1851681072949859
- title | Video giới thiệu agent-zero
```

## Agent Zero làm được gì

### Máy Linux thật ngay trong khung chat

Bên cạnh khung chat có một panel gọi là **Canvas**, nơi hiện trình duyệt, tài liệu và màn hình **Desktop**. Mở Desktop là bạn thấy không gian Linux của agent, trong đó có terminal, trình quản lý file, Blender và các ứng dụng khác. Bạn có thể ngồi xem agent làm, hoặc cầm chuột bàn phím làm thay bất cứ lúc nào. Lợi ích thực tế là bạn không phải tin mù quáng: thấy nó làm gì thì dừng được ngay.

### Trình duyệt tích hợp và chế độ Annotate

Trình duyệt trong Canvas mở trang, điền form, tải file lên và chụp màn hình. Ở chế độ **Annotate**, bạn bấm vào một phần tử trên trang để ghi chú: “chỗ này tôi thích”, “sửa chỗ này”. Agent đọc ghi chú đó và làm theo. Rất tiện khi bạn muốn làm giao diện giống một trang mẫu, hoặc kiểm tra lỗi hiển thị của web mình.

### Làm việc chung trên tài liệu

Bạn nhờ agent viết kế hoạch hoặc biên bản họp thành file Markdown, mở trong trình soạn thảo của Canvas và cùng sửa trong lúc agent đang làm. Với LibreOffice, agent tạo và chỉnh văn bản, bảng tính, bài thuyết trình và lưu thành ODT, ODS, ODP. Kết quả là file thật bạn mở được, không phải đoạn chữ kẹt trong khung chat.

### Dự án, Skill, Agent Profile và Model Preset

- **Projects** tách riêng file, hướng dẫn, bộ nhớ, bí mật (secrets), kiến thức và lựa chọn model cho từng công việc. Bạn có thể clone một repo Git vào dự án. Làm cho nhiều khách hàng thì việc này giúp khỏi lẫn dữ liệu.
- **Skills** là quy trình mà agent tự nạp khi cần, hoặc bạn ghim từ ô chat để nó luôn áp dụng.
- **Agent Profiles** đổi phong cách làm việc chung của cuộc chat.
- **Model Presets** là các cấu hình model đặt tên sẵn, ví dụ nhanh, cân bằng, rẻ, local, mạnh, để đổi qua lại nhanh.

### Các tính năng khác

- **Plugin Hub:** kho plugin cộng đồng gồm nhà cung cấp model, công cụ, hệ thống nhớ, tích hợp. Bạn nên đọc mô tả và hướng dẫn của plugin trước khi cài.
- **Nhiều agent phối hợp:** agent giao bớt việc cho agent khác, mỗi bên có chỉ dẫn và hội thoại riêng rồi báo lại.
- **Time Travel:** chụp lại trạng thái không gian làm việc trong `/a0/usr`, cho bạn so sánh và quay về bản cũ. README nói rõ nó không thay thế Git hay sao lưu.
- **Chuyển chat từ công cụ khác:** nhập chat từ Pi, Hermes Agent hoặc Claude Code, xem trước rồi mới lưu.
- **MCP và A2A:** nối công cụ ngoài qua MCP, nối agent khác qua A2A.

## Cần chuẩn bị gì

Theo README, bạn cần:

- Một máy tính chạy Windows, macOS hoặc Linux (có bản tải cho cả ba, gồm cả chip Intel/AMD và ARM). Nếu không có màn hình đồ họa, như máy chủ hoặc SSH, thì dùng dòng lệnh cài đặt.
- **Docker.** A0 Launcher sẽ hướng dẫn bạn cài Docker, còn A0 Install cũng hỗ trợ cài Docker khi cần.
- Một cách để agent có “bộ não”, chọn một trong ba: tài khoản AI được hỗ trợ, API key của nhà cung cấp, hoặc một máy chủ model chạy local. README viết rõ là thiếu cái này thì chưa chat được.
- Một trình duyệt để mở giao diện web.

Tư liệu không nói gì về yêu cầu card đồ họa, dung lượng ổ đĩa hay RAM tối thiểu. Nếu bạn định chạy model local, hãy xem thêm trang tài liệu cài đặt của dự án.

```note
Agent Zero có thể chạy lệnh và thao tác thật. Hãy luôn để nó chạy trong Docker, đừng gắn cả thư mục home của bạn vào, và chỉ cấp quyền sửa file trên máy bạn khi tin tưởng. Cũng cần để ý chi phí: nếu dùng API key của nhà cung cấp AI, mỗi lần agent làm việc là một lần tính phí theo gói của bạn.
```

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

```steps
- Chọn cách cài | Máy tính có màn hình dùng A0 Launcher, máy chủ hoặc SSH dùng A0 Install
- Cài và mở | Tải Launcher hoặc chạy một dòng lệnh, làm theo hướng dẫn về Docker
- Tạo Instance | Chọn Download Agent Zero hoặc Run Agent Zero, rồi bấm Create
- Mở giao diện | Chờ trạng thái Running, bấm Open UI
- Kết nối model | Chọn Cloud provider, AI account hoặc Local model, đặt Main model và Utility model
- Gửi tin nhắn đầu tiên | Thử một yêu cầu đơn giản và mở file kết quả
```

### Cách 1: Máy tính có màn hình, dùng A0 Launcher (khuyên dùng)

README khuyên dùng A0 Launcher cho máy tính để bàn. Nó dẫn bạn qua phần cài Docker, tạo Agent Zero rồi mở giao diện web. README ghi phiên bản Launcher 1.9. Bạn tải đúng bản cho máy mình từ trang releases của repo a0-launcher:

- Windows: bản x64 cho chip Intel/AMD, hoặc ARM64.
- macOS: bản Apple Silicon cho máy dòng M, hoặc bản Intel.
- Linux: file AppImage x64 hoặc ARM64.

Trên Linux, nếu file AppImage không mở được, vào phần thuộc tính (properties) của file và cho phép chạy như một chương trình, rồi mở lại.

Sau khi mở Launcher, bạn làm theo thứ tự này:

1. Làm theo mọi yêu cầu về Docker nếu Launcher hỏi.
2. Tạo một **Instance** (một bộ Agent Zero riêng). Chọn **Download Agent Zero** hoặc **Run Agent Zero**, giữ nguyên phiên bản mặc định và workspace lưu lâu dài (persistent), rồi bấm **Create**.
3. Chờ trạng thái **Running** rồi bấm **Open UI**.

Chỗ người mới hay vấp: lần đầu Docker chưa chạy nên Instance không lên. Hãy mở Docker Desktop trước.

### Cách 2: Máy chủ hoặc chỉ có terminal, dùng A0 Install

A0 Install chạy tương tác ngay trong terminal, giúp cài Docker khi cần và tạo Instance có workspace lưu lâu dài.

Trên macOS hoặc Linux, mở Terminal và chạy:

```bash
curl -fsSL https://bash.agent-zero.ai | bash
```

Trên Windows, mở PowerShell và chạy:

```powershell
irm https://ps.agent-zero.ai | iex
```

Cả hai lệnh đều tải script cài đặt rồi chạy ngay, nên chỉ chạy khi bạn tin nguồn. Hãy làm theo các câu hỏi trên màn hình, sau đó mở Web UI. Cài trên máy của bạn thì dùng địa chỉ URL mà trình cài in ra. Cài trên máy chủ từ xa thì `localhost` là chính máy chủ đó, không phải máy bạn. Khi đó bạn cần xem hướng dẫn VPS trong tài liệu về cách truy cập và xác thực trước khi mở từ trình duyệt của mình.

### Cách 3: Đã có Docker, chạy thẳng một lệnh

Nếu bạn đã cài Docker, chạy lệnh này:

```bash
docker run -d -p 127.0.0.1:5080:80 -v a0_usr:/a0/usr agent0ai/agent-zero
```

Lệnh này chạy Agent Zero ở chế độ nền, mở cổng 5080 trên máy Docker và chỉ cho truy cập từ chính máy đó. Phần `-v a0_usr:/a0/usr` lưu dữ liệu của bạn vào một volume tên `a0_usr`, nên khi thay container thì dữ liệu vẫn còn. Dù vậy vẫn nên sao lưu. Sau đó mở trình duyệt vào `http://localhost:5080`.

### Kết nối model khi chat yêu cầu

Gửi tin nhắn đầu tiên từ màn hình chào, ví dụ: “Create a one-page plan for a 15-minute team kickoff. Save it as a Markdown file and give me a link.” Khi chat hỏi, chọn **Cloud provider**, **AI account** hoặc **Local model**. Chọn một **Main model** cho hội thoại và một **Utility model** cho việc tóm tắt, đặt tên chat; hai cái có thể dùng chung một nhà cung cấp. Bấm **Finish setup**, rồi **Continue**. Tin nhắn ban đầu của bạn sẽ tự chạy tiếp trong cùng cuộc chat.

Muốn dùng tài khoản ChatGPT, README có hướng dẫn riêng về Codex: bật đăng nhập bằng mã thiết bị trong ChatGPT, vào mục **Account** trong phần làm quen của Agent Zero rồi kết nối Codex/ChatGPT. Nếu nhà cung cấp của bạn không có trong danh sách, tìm plugin tương ứng trong Plugin Hub.

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

Bạn coi như cài thành công khi đủ ba dấu hiệu sau:

- Launcher báo Instance ở trạng thái **Running**, hoặc trình duyệt mở được `http://localhost:5080` (với cách chạy Docker trực tiếp) hay địa chỉ mà A0 Install in ra.
- Màn hình chào của Agent Zero hiện lên và bạn gửi được tin nhắn.
- Sau khi kết nối model, agent trả lời và đưa cho bạn một đường link tới file Markdown với yêu cầu thử ở trên. Bấm vào link và thấy bản kế hoạch là xong.

Nếu không có phản hồi đầu tiên, README bảo kiểm tra phần thiết lập đã hoàn tất chưa và cả hai model có dùng được qua nhà cung cấp bạn chọn không. Lỗi kết nối hoặc tài khoản thường hiện ngay trong khung chat.

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

### Chủ shop cần kế hoạch nhanh và bảng tính

Bạn là chủ một shop nhỏ, sắp họp với nhân viên và chưa có gì chuẩn bị. Gõ vào chat: “Create a one-page plan for a 15-minute team kickoff, with a goal, three agenda items, and next steps. Save it as a Markdown file and give me a link.” Agent viết file, đưa link, bạn mở trong Canvas và sửa chung với nó. Bước tiếp theo, bạn nhờ: “Create an editable ODS budget model with assumptions and monthly projections.” Bạn nhận được một bảng tính ODS mở được bằng LibreOffice, có giả định và dự báo theo tháng.

### Nhân viên văn phòng xử lý tài liệu

Bạn có một tài liệu dài và không đủ thời gian đọc. Đính kèm file vào chat rồi hỏi: “Summarize the main points and list anything I need to follow up on.” Agent tóm tắt các ý chính và liệt kê việc cần theo dõi. Với nghiên cứu, bạn thử: “Compare three places for a weekend trip by train from Rome. Link your sources and make a shortlist.” Kết quả là danh sách rút gọn kèm nguồn để bạn tự kiểm tra lại.

> Agent Zero không chỉ nói cho bạn nghe, nó làm ra file thật để bạn mở.
>
> — Ông T

### Người làm web nhờ agent xem giao diện

Bạn có một trang web đang làm dở và muốn sửa giao diện. Mở trang của bạn trong Browser, bật chế độ Annotate, bấm vào từng chỗ chưa ổn và ghi bình luận. Sau đó nhắn: “Open my local app in the Browser. I will annotate the page with comments; then implement the requested UI fixes.” Agent đọc các ghi chú rồi sửa theo. Bạn cũng có thể chỉ cho nó một trang mình thích và nhờ làm một bản tương tự cho dự án của mình.

### Lập trình viên làm việc trong dự án riêng

Bạn là dev mới, cần agent đọc code, sửa vừa phải và chạy test. Tạo một Project, clone repo Git của bạn vào đó để agent có đủ ngữ cảnh mà không lẫn với việc khác. Muốn nó làm trực tiếp trên repo ở máy bạn, README nói có hai đường: bật **Host access** trong Launcher, hoặc cài A0 CLI. Trên macOS hoặc Linux:

```bash
curl -LsSf https://cli.agent-zero.ai/install.sh | sh
```

Trên Windows PowerShell:

```powershell
irm https://cli.agent-zero.ai/install.ps1 | iex
```

Điểm cần nhớ: cài A0 CLI trên máy bạn muốn agent làm việc, **không** cài bên trong container của Agent Zero. Sau đó chạy `a0` để kết nối terminal với một Instance đang chạy. Nó thường tự tìm thấy Instance trên máy, hoặc bạn trỏ tới URL từ xa như VPS hay tunnel.

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

### Docker chưa chạy

Triệu chứng: Launcher không tạo được Instance, hoặc lệnh cài báo lỗi. Cách xử lý theo README: bật Docker Desktop hoặc dịch vụ Docker, rồi mở lại Launcher hoặc chạy lại lệnh cài.

### Cổng 5080 đã bị chiếm

Nếu máy bạn đã có chương trình dùng cổng này, đổi sang cổng khác trong Launcher hoặc A0 Install. Với lệnh Docker, thay `5080` bằng một cổng còn trống và dùng đúng cổng đó trong địa chỉ trình duyệt.

### File AppImage trên Linux không mở được

Cho phép file chạy như một chương trình trong phần thuộc tính của file, rồi mở lại.

### Gửi tin nhắn mà không thấy trả lời

Thường là chưa kết nối model xong, hoặc key/tài khoản có vấn đề. Kiểm tra bạn đã bấm **Finish setup** chưa, cả Main model và Utility model có dùng được qua nhà cung cấp đã chọn không, và đọc thông báo lỗi trong chat. Tuyệt đối không dán API key vào prompt hay file công khai, hãy nhập vào phần cài đặt hoặc secrets của dự án.

### Mở từ xa trên VPS mà vào không được

Trên máy chủ từ xa, `localhost` là chính máy chủ chứ không phải máy bạn. Hãy làm theo hướng dẫn VPS trong tài liệu về truy cập và xác thực. Nếu vẫn bị kẹt, README chỉ sang trang Troubleshooting của dự án.

## Có nên dùng không

**Điểm mạnh.** Agent có môi trường Linux đầy đủ, chạy cách ly trong Docker nên an toàn hơn cho máy thật. Bạn xem được nó làm gì và can thiệp ngay. Kết quả là file thật (Markdown, ODS, ODT, ODP), không chỉ chữ trong chat. Cách chia Project giúp tách việc từng khách hàng. Mã nguồn mở, README ghi rõ dùng giấy phép MIT, và có thể mở rộng bằng plugin, MCP, A2A.

**Giới hạn.** Bạn vẫn cần Docker và một nguồn model (tài khoản, API key hoặc local), nên không phải mở ra là dùng ngay. Khi dùng API key, chi phí do nhà cung cấp tính. Agent có quyền chạy lệnh và thao tác thật, nên việc đụng đến tài khoản, tiền bạc, hệ thống production hay dữ liệu riêng tư cần bạn tự xem xét từng hành động. Time Travel chỉ là lớp an toàn, không thay cho sao lưu. Tư liệu chưa nói về yêu cầu phần cứng cụ thể khi chạy model local.

**Khi nào chọn cách khác.** Nếu bạn chỉ cần hỏi đáp, viết nhanh một đoạn văn, một chatbot thông thường là đủ và đơn giản hơn. Nếu bạn không muốn đụng đến Docker, hoặc không muốn cấp cho AI quyền thao tác trên một môi trường thật, thì công cụ này chưa phù hợp. Còn nếu bạn muốn giao cả một chuỗi việc cho AI, vừa muốn kiểm soát vừa muốn tự chỉnh công cụ, Agent Zero đáng thử, nhất là với cách cài bằng A0 Launcher.

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

### Agent Zero có miễn phí không?

Bản thân Agent Zero là mã nguồn mở, README ghi rõ dùng giấy phép MIT. Tuy nhiên bạn cần một tài khoản AI được hỗ trợ, API key của nhà cung cấp hoặc model chạy local để agent trả lời. Chi phí của các dịch vụ đó tùy nhà cung cấp, tư liệu không nêu giá.

### Agent Zero chạy được trên Windows không?

Được. A0 Launcher có bản cho Windows x64 và Windows ARM64, ngoài ra còn có lệnh cài bằng PowerShell. Launcher sẽ hướng dẫn bạn bước cài Docker. Máy chạy macOS và Linux cũng được hỗ trợ.

### Có cần card đồ họa (GPU) không?

Tư liệu không nhắc đến yêu cầu GPU. Bạn có thể dùng model qua nhà cung cấp đám mây hoặc tài khoản AI, hoặc nối tới một máy chủ model local. Nếu định chạy model local thì cần xem thêm tài liệu của dự án và của model đó.

### Dữ liệu của mình có an toàn không?

Agent chạy trong sandbox trên Docker, và dữ liệu lưu trong volume để giữ lại khi thay container. README khuyên không gắn cả thư mục home vào, chỉ cấp quyền sửa file và chạy lệnh khi tin tưởng Instance, và lưu thông tin đăng nhập trong project secrets hoặc phần cài đặt chứ không để trong prompt. Việc gì chạm đến tài khoản, tiền bạc hay dữ liệu riêng tư thì bạn nên tự xem lại.

### Cài bằng A0 Launcher hay A0 Install?

README khuyên dùng A0 Launcher cho máy tính có màn hình, vì nó dẫn bạn qua bước cài Docker và mở sẵn giao diện web. A0 Install dành cho máy chủ hoặc môi trường chỉ có shell, chạy bằng một dòng lệnh trong terminal. Nếu đã có Docker, bạn cũng có thể chạy thẳng một lệnh docker run.

### Agent Zero có làm việc được với file trên máy mình không?

Có, nhưng là tùy chọn. Bạn dùng mục Host access trong Launcher hoặc cài A0 CLI trên máy muốn cho agent làm việc để nó truy cập file, lệnh và trình duyệt trên máy đó. README nhắc chỉ bật khi bạn tin tưởng Instance đang kết nối.

### Có dùng được tài khoản ChatGPT không?

README có phần hướng dẫn đăng nhập bằng tài khoản ChatGPT để dùng các model Codex: bật đăng nhập bằng mã thiết bị trong ChatGPT, rồi kết nối Codex/ChatGPT trong mục Account của phần làm quen. Chi tiết từng bước nằm trong hướng dẫn Codex của dự án.
