AutoGPT

1. AutoGPT là gì?

AutoGPT là một nền tảng cho bạn một "đội chuyên gia AI": bạn mô tả công việc bằng lời thường, trợ lý điều phối tên Otto chia việc cho các chuyên gia (viết nội dung SEO, nghiên cứu khách hàng, trợ lý hành chính…), rồi gom kết quả lại cho bạn. Ngoài khung chat còn có Build, một trình kéo thả để tự nối các bước thành quy trình (workflow) chạy theo yêu cầu hoặc theo lịch, và Marketplace để lấy quy trình có sẵn về sửa.

Có hai cách dùng:

• Bản chạy sẵn trên web (platform.agpt.co): không phải cài gì, nhưng mất phí. Gói Pro 50 USD/tháng (dùng thử 7 ngày, cần thẻ), gói Max 320 USD/tháng, chạy workflow trả thêm theo mức dùng. Giá có thể đổi, xem https://agpt.co/pricing.
• Tự cài lên máy của bạn (hướng dẫn này): không mất phí bản quyền, nhưng bạn tự lo máy, tự cung cấp khóa API của mô hình AI (hoặc chạy mô hình ngay trên máy), tự cập nhật và sao lưu.

Bản mới nhất lúc viết bài là AutoGPT Platform v0.11.0, phát hành ngày 4/11/2026. Thư mục classic/ trong repo là AutoGPT bản thử nghiệm năm 2023, đã ngừng hỗ trợ; hướng dẫn này không nói về bản đó.

Hợp với bạn nếu:

• Bạn muốn AI tự làm các việc lặp lại: soạn bài, tóm tắt, nghiên cứu, chuẩn bị email…
• Bạn có máy tính đủ mạnh (khuyên 8 GB RAM trở lên) và chịu cài thêm Docker.
• Bạn muốn dữ liệu nằm trên máy mình thay vì trên máy chủ của dịch vụ.

Chưa hợp nếu:

• Máy bạn yếu, ít RAM hoặc ổ cứng gần đầy.
• Bạn không muốn đụng tới dòng lệnh chút nào. Khi đó dùng bản web trả phí sẽ dễ hơn.
• Bạn định đem phần nền tảng đi bán lại thành dịch vụ cạnh tranh: giấy phép không cho phép (xem mục 7).

2. Cần chuẩn bị gì?

• Máy tính Windows, macOS hoặc Linux chạy được container Linux kiểu amd64 hoặc arm64 (hầu hết máy tính đời mới đều được).
• RAM: tài liệu khuyên ít nhất 8 GB. Bản thử nghiệm của nhóm phát triển dùng khoảng 5–6 GB khi khởi động và khi chạy.
• Ổ cứng: trống khoảng 25 GB. Nên dùng ổ SSD.
• Docker (phần mềm chạy ứng dụng trong "container", tức một hộp đóng gói sẵn mọi thứ ứng dụng cần). Trên Windows và macOS cài Docker Desktop: https://docs.docker.com/desktop/ . Trên Linux cài Docker Engine: https://docs.docker.com/engine/install/ . Docker Desktop có điều khoản giấy phép riêng của Docker.
• Khóa API của mô hình AI để dùng chat với Otto và các chuyên gia. Cấu hình mặc định dùng OpenRouter (https://openrouter.ai) cho chat và OpenAI (https://platform.openai.com) cho phần ghi nhớ. Hai dịch vụ này tính tiền theo mức dùng. Không có khóa thì vẫn đăng nhập và dùng Build được, chỉ các tính năng cần mô hình AI sẽ báo thiếu thông tin đăng nhập.
• Hoặc Ollama (https://ollama.com) nếu bạn muốn chạy mô hình ngay trên máy, không trả phí API (máy cần mạnh hơn).

Không cần cài Git, Node.js, npm hay Docker Compose.

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

Cách dễ nhất là dùng bộ cài chính thức: một lệnh tự tải bản phát hành mới nhất, kiểm tra và khởi động AutoGPT trong một container.

Bước 1: Cài và mở Docker

Cài Docker theo link ở mục 2 rồi mở Docker Desktop (Windows/macOS) và đợi nó báo đang chạy. Kiểm tra bằng lệnh:

docker info

Thấy gì là đúng: lệnh in ra một danh sách thông tin dài, không có dòng báo lỗi kết nối. Nếu báo lỗi, xem mục 5.

Bước 2: Chạy bộ cài

Windows (dán vào PowerShell):

& {
  $installer = Join-Path ([IO.Path]::GetTempPath()) "autogpt-install-$([guid]::NewGuid().ToString('N')).ps1"
  try {
    curl.exe --proto '=https' --proto-redir '=https' --tlsv1.2 -fsSL -o $installer https://setup.agpt.co/install.ps1
    if ($LASTEXITCODE -eq 0) {
      powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installer
    }
  } finally {
    Remove-Item -LiteralPath $installer -Force -ErrorAction SilentlyContinue
  }
}

macOS và Linux (dán vào Terminal):

(
  installer="$(mktemp)" &&
  trap 'rm -f "$installer"' EXIT &&
  curl --proto '=https' --proto-redir '=https' --tlsv1.2 -fsSL \
    -o "$installer" https://setup.agpt.co/install.sh &&
  bash "$installer"
)

Bộ cài kiểm tra RAM, ổ cứng và Docker trước, rồi tải bản AutoGPT, tạo một vùng lưu dữ liệu tên autogpt-platform-data và khởi động container tên autogpt. Lần đầu có thể mất vài phút vì phải tải về khá nhiều.

Thấy gì là đúng: bộ cài báo container khỏe (healthy). Chạy lại bộ cài khi mọi thứ không đổi sẽ không làm gì thêm, nên không sợ chạy nhầm hai lần.

Lưu ý: Chỉ muốn kiểm tra máy có đủ điều kiện không, thêm --preflight-only (macOS/Linux, sau bash "$installer") hoặc -PreflightOnly (Windows, sau -File $installer).

Bước 3: Mở AutoGPT và tạo tài khoản

Mở trình duyệt, vào http://localhost:3000 rồi bấm đăng ký. Mật khẩu cần ít nhất 12 ký tự.

Thấy gì là đúng: bạn vào được màn hình chính của AutoGPT, có các mục Home, Agents, Marketplace, Build ở trên cùng.

Bước 4: Biến tài khoản của bạn thành quản trị viên

Thay you@example.com bằng email bạn vừa đăng ký rồi chạy:

docker exec autogpt autogpt-admin promote you@example.com

Sau đó đăng xuất và đăng nhập lại.

Bước 5: Đóng đăng ký cho người lạ

Lúc mới cài, ai mở được địa chỉ này cũng đăng ký được. Mở file cấu hình autogpt.env trong thư mục riêng của bộ cài:

• Windows: %LOCALAPPDATA%\AutoGPT
• macOS/Linux: ~/.config/autogpt

Thêm dòng:

AUTH_ALLOW_NEW_ACCOUNTS=false

Rồi xóa container cũ (dữ liệu vẫn giữ nguyên) và chạy lại đúng lệnh ở Bước 2:

docker stop --time 360 autogpt
docker rm autogpt

Thấy gì là đúng: trang đăng ký không cho tạo tài khoản mới nữa, tài khoản của bạn vẫn đăng nhập bình thường.

Bước 6: Thêm khóa API hoặc nối mô hình chạy trên máy

Cũng trong file autogpt.env, chọn một trong hai cách, lưu file, rồi làm lại phần "xóa container và chạy lại bộ cài" như Bước 5.

Cách A, dùng khóa API (thay chữ YOUR_... bằng khóa thật của bạn):

CHAT_USE_LOCAL=false
CHAT_USE_OPENROUTER=true
OPEN_ROUTER_API_KEY=YOUR_OPENROUTER_KEY
OPENAI_API_KEY=YOUR_OPENAI_KEY

Cách B, mô hình chạy trên máy qua Ollama. Cài Ollama, đặt biến OLLAMA_CONTEXT_LENGTH=32768 cho Ollama, tải hai mô hình mà tài liệu AutoGPT dùng làm ví dụ:

ollama pull hf.co/unsloth/Qwen3.5-4B-GGUF:Q4_K_M
ollama pull nomic-embed-text

Rồi thêm vào autogpt.env:

CHAT_USE_LOCAL=true
CHAT_BASE_URL=http://host.docker.internal:11434/v1
CHAT_API_KEY=ollama
CHAT_FAST_STANDARD_MODEL=hf.co/unsloth/Qwen3.5-4B-GGUF:Q4_K_M
GRAPHITI_LLM_MODEL=hf.co/unsloth/Qwen3.5-4B-GGUF:Q4_K_M
GRAPHITI_RERANKER_MODEL=hf.co/unsloth/Qwen3.5-4B-GGUF:Q4_K_M

Lưu ý: Không chia sẻ file autogpt.env cho ai, trong đó có khóa API của bạn. Chi tiết và các trường hợp khác (dùng Anthropic trực tiếp, Linux dùng Docker Engine) có ở https://agpt.co/docs/platform/self-hosting/single-container .

4. Dùng lần đầu

1. Vào http://localhost:3000 và đăng nhập.
2. Ở Home, gõ một việc cụ thể vào ô chat, ví dụ: "Tóm tắt giúp tôi 3 ý chính của bài viết ở link này". Otto sẽ nhận việc, có thể gọi chuyên gia phù hợp, chạy từng bước và trả kết quả ngay trong khung chat; file tạo ra hiện ở khung bên cạnh.
3. Muốn tự dựng quy trình thì bấm Build: kéo các khối vào, nối đầu ra của khối này vào đầu vào của khối kia, bấm nút chạy và xem từng khối chạy ra sao.
4. Chưa biết bắt đầu từ đâu thì vào Marketplace, chọn một quy trình có sẵn rồi sửa lại cho hợp với việc của bạn.
5. Vào Agents để theo dõi các lần chạy.

Lưu ý: Nên đặt giới hạn chi tiêu nếu bạn dùng khóa API trả phí. Bản tự cài mặc định không giới hạn; tài liệu single-container chỉ cách bật giới hạn theo ngày và theo tuần.

5. Lỗi thường gặp và cách sửa

Dấu hiệu	Nguyên nhân	Cách sửa
docker báo "not recognized" / "command not found", hoặc docker info báo không kết nối được	Docker chưa cài hoặc Docker Desktop chưa mở	Cài Docker theo mục 2, mở Docker Desktop, đợi nó chạy xong rồi thử lại
Bộ cài báo lỗi khi tải bản AutoGPT ngay sau khi có bản mới	Bản mới chưa phát hành xong lên Docker Hub	Đợi một lúc rồi chạy lại bộ cài
Container cứ ở trạng thái "starting" hoặc "unhealthy"	Lần đầu khởi động mất vài phút, hoặc một dịch vụ bên trong bị lỗi	Đợi thêm; nếu vẫn vậy, xem nhật ký bằng lệnh docker logs --tail 100 autogpt
Container tự khởi động lại liên tục, máy báo thiếu bộ nhớ	Docker không được cấp đủ RAM	Docker Desktop: Settings → Resources, tăng bộ nhớ lên trên 6 GB. Windows dùng WSL 2: đặt memory= dưới mục [wsl2] trong file %UserProfile%\.wslconfig, rồi chạy wsl --shutdown
Đăng ký báo "Email Not Allowed"	Đã đóng đăng ký hoặc email không nằm trong danh sách cho phép	Kiểm tra dòng AUTH_ALLOW_NEW_ACCOUNTS trong autogpt.env
Chat với Otto báo lỗi 401	Thiếu khóa API hoặc khóa sai	Kiểm tra lại Bước 6, nhớ xóa container và chạy lại bộ cài sau khi sửa file
Một lần chạy cứ hiện RUNNING mãi sau khi khởi động lại máy	Việc đang chạy lúc tắt container bị bỏ dở	Bắt đầu một lần chạy mới

6. Gỡ cài đặt / cập nhật

Cập nhật lên bản mới:

1. Sao lưu dữ liệu trước theo mục "Cold backup" ở https://agpt.co/docs/platform/self-hosting/single-container (đoạn lệnh dài, nên chép từ trang gốc).
2. Dừng và xóa container (không xóa dữ liệu):

docker stop --time 360 autogpt
docker rm autogpt

3. Chạy lại lệnh ở Bước 2. Muốn chọn đúng một phiên bản, thêm --release=vX.Y.Z (macOS/Linux) hoặc -Release vX.Y.Z (Windows).

Gỡ cài đặt: tài liệu chính thức không có mục gỡ riêng. Bạn dừng và xóa container như trên. Dữ liệu (tài khoản, quy trình, khóa bí mật được tạo ra) nằm trong vùng lưu autogpt-platform-data; chỉ khi chắc chắn không cần nữa mới xóa bằng lệnh Docker:

docker volume rm autogpt-platform-data

Lưu ý: Xóa vùng lưu này là mất hết dữ liệu, không lấy lại được.

7. Câu hỏi hay gặp

Có mất tiền không? Tự cài thì không mất phí bản quyền. Bạn trả tiền cho mô hình AI nếu dùng khóa API trả phí; dùng Ollama trên máy thì không tốn phí API. Bản web chạy sẵn là dịch vụ trả phí (Pro 50 USD/tháng, Max 320 USD/tháng lúc viết bài).

Có được dùng cho công ty không? Phần nền tảng (autogpt_platform/) theo giấy phép Polyform Shield: được dùng cá nhân và dùng nội bộ doanh nghiệp, nhưng không được bán lại thành dịch vụ chạy sẵn cạnh tranh với AutoGPT. Phần còn lại của repo theo giấy phép MIT.

Dữ liệu của tôi nằm ở đâu? Trên máy của bạn, trong vùng lưu Docker autogpt-platform-data. Nếu dùng khóa API, nội dung bạn gửi cho mô hình sẽ đi qua nhà cung cấp mô hình đó.

Cho người khác trong mạng dùng được không? Mặc định AutoGPT chỉ mở trên chính máy bạn (127.0.0.1). Muốn cho máy khác truy cập phải đặt sau một reverse proxy có HTTPS, xem tài liệu single-container.

AutoGPT bản 2023 (Classic) còn dùng được không? Mã vẫn nằm trong thư mục classic/ nhưng đã ngừng hỗ trợ, chỉ nên đọc để tham khảo.