Trải nghiệm khi dùng OpenHands (Agent Canvas)
Bạn khởi động Agent Canvas trên máy mình (bằng Docker hoặc một lệnh npm), mở địa chỉ hiện ra trong trình duyệt và thấy một giao diện giống ứng dụng chat. Ở đó bạn tạo cuộc trò chuyện mới, chọn thư mục dự án, rồi nhờ agent làm việc như đọc mã, sửa lỗi hay viết thêm tính năng.
Điểm khác một công cụ chat thông thường là agent thực sự thao tác trên mã nguồn và lệnh trong môi trường bạn cho phép. Nếu chạy trong Docker, agent chỉ thấy những thư mục bạn gắn vào; nếu chạy không có sandbox (hộp cát cách ly), nó có thể truy cập toàn bộ tệp trên máy, vì vậy README có cảnh báo riêng ở chỗ này.
Khi quen, bạn có thể nối các dịch vụ như Slack hay GitHub để agent tự chạy theo lịch hoặc theo sự kiện, ví dụ làm báo cáo gửi lên Slack hay chia nhỏ issue thành các đầu việc. Đây là phần dành cho nhóm kỹ thuật hơn là người dùng cá nhân.
Tính năng nổi bật
Một bảng điều khiển cho nhiều agent
Chạy agent OpenHands hoặc agent bên thứ ba như Claude Code, Codex, Gemini CLI, OpenCode qua giao thức ACP, và chuyển qua lại giữa chúng.
Chọn nơi agent chạy
Agent có thể chạy trên máy bạn, trong Docker, trên máy ảo hoặc hạ tầng công ty, và bạn đổi nơi chạy mà vẫn dùng chung một giao diện.
Tự động hoá theo lịch hoặc sự kiện
Tạo các quy trình kết nối Slack, GitHub, Linear, Notion để agent làm việc định kỳ hoặc khi có webhook.
Dùng mô hình AI tuỳ ý
Bạn cấu hình mô hình mình muốn dùng, không bị khóa vào một nhà cung cấp.
Tự host, giữ dữ liệu ở máy mình
Trạng thái, khoá và lịch sử hội thoại lưu trong nơi bạn quản lý, phù hợp đội ngũ cần kiểm soát dữ liệu.
Tận dụng OpenHands (Agent Canvas) vào việc gì?
Lập trình viên cá nhân
Giao việc sửa lỗi nhỏ cho agent
Mô tả lỗi, chọn dự án rồi để agent đọc mã và đề xuất bản sửa để bạn xem lại.
Nhóm phát triển phần mềm
Quản lý nhiều agent trong một nơi
Cùng một giao diện để thử Claude Code, Codex hay OpenHands trên cùng dự án và so sánh kết quả.
Trưởng nhóm kỹ thuật
Báo cáo tự động lên Slack
Đặt lịch để agent tổng hợp tình hình issue hoặc pull request và gửi lên kênh nhóm.
Công ty phần mềm nhỏ
Máy chủ agent dùng chung cho cả đội
Dựng một agent server trên máy chủ để cả nhóm dùng chung cho review code hoặc cập nhật thư viện.
Cần chuẩn bị gì?
- Docker Desktop (Windows/macOS) hoặc Docker Engine (Linux) nếu chạy bằng sandbox Docker.
- Hoặc Node.js 24 trở lên cùng công cụ uv nếu chạy không dùng sandbox (có rủi ro, xem phần lưu ý).
- API key của nhà cung cấp mô hình AI mà bạn chọn, hoặc mô hình cục bộ tự cấu hình.
- Native Windows không được hỗ trợ cho chế độ nhiều sandbox; README hướng dẫn dùng WSL 2 cho trường hợp đó.
Hướng dẫn cài đặt chi tiết
Cài trên Windows (Docker)
Cài Docker Desktop cho Windows và bật nó lên. Sau đó mở PowerShell và kéo image về.
docker pull ghcr.io/openhands/agent-canvas:1.40.0Chọn thư mục chứa các dự án mà agent được phép truy cập (tạo trước nếu chưa có), rồi chạy container. Số phiên bản 1.40.0 là số trong README tại thời điểm viết; hãy kiểm tra lại README để lấy bản mới.
$env:PROJECTS_PATH = Join-Path $HOME "projects" New-Item -ItemType Directory -Force -Path $env:PROJECTS_PATH, (Join-Path $env:USERPROFILE ".openhands") | Out-Null docker run -it --rm ` -p 127.0.0.1:8000:8000 ` -e AGENT_CANVAS_ALLOW_LAN_SESSION_KEY=true ` -v "$($env:USERPROFILE)\.openhands:/home/openhands/.openhands" ` -v "$($env:PROJECTS_PATH):/projects" ` ghcr.io/openhands/agent-canvas:1.40.0Mở http://localhost:8000/canvas trong trình duyệt.
Cài trên macOS / Linux (Docker)
Cài Docker, chọn thư mục dự án và tạo nó trước.
export PROJECTS_PATH="$HOME/projects" mkdir -p "$PROJECTS_PATH"Chạy Agent Canvas. Trên Linux Docker Engine, người dùng bên trong container (uid 10001) cần quyền đọc ghi thư mục dự án; xem hướng dẫn xử lý quyền trong README trước khi chạy.
docker run -it --rm \ -p 127.0.0.1:8000:8000 \ -e AGENT_CANVAS_ALLOW_LAN_SESSION_KEY=true \ -v openhands-state:/home/openhands/.openhands \ -v "${PROJECTS_PATH}:/projects" \ ghcr.io/openhands/agent-canvas:1.40.0Mở http://localhost:8000/canvas trong trình duyệt.
Cài trên Không sandbox (npm)
Cách này chạy agent trực tiếp trên máy của bạn và README cảnh báo agent sẽ có toàn quyền với hệ thống tệp. Chỉ dùng trên máy thử nghiệm hoặc khi bạn hiểu rõ rủi ro. Cần Node.js 24 trở lên và uv.
npm install -g @openhands/agent-canvas agent-canvas
Dùng thử lần đầu
Mở giao diện Canvas trong trình duyệt và vào phần cài đặt để chọn nhà cung cấp mô hình, dán API key của bạn.
Tạo một thư mục thử trong projects, đặt vào đó một dự án nhỏ hoặc một vài file mã, rồi bắt đầu cuộc trò chuyện mới và chọn dự án đó.
Giao một việc nhỏ và có thể kiểm chứng, ví dụ: Đọc dự án này và viết cho tôi file README tiếng Việt tóm tắt cách chạy.
Xem agent làm từng bước, kiểm tra các thay đổi nó đề xuất trước khi dùng. Nếu muốn so sánh, chuyển sang agent khác như Claude Code theo hướng dẫn ACP trong tài liệu.
Mẹo dùng hay
- Chỉ gắn vào container đúng thư mục dự án cần thiết, đừng gắn cả thư mục cá nhân.
- Giữ cổng chỉ mở ở 127.0.0.1 như README cấu hình, đừng mở ra mạng LAN hay Internet nếu chưa đọc phần bảo mật.
- Dùng volume Docker đặt tên để giữ lại cài đặt và lịch sử khi xoá container.
Lưu ý và hạn chế
- Agent lập trình có thể sửa hoặc xoá file; hãy dùng Git và sao lưu dự án trước khi cho nó chạy.
- Chế độ không sandbox cho agent toàn quyền với tệp trên máy bạn; README cảnh báo rõ điều này.
- Dự án đang đổi hướng nhanh (tên giao diện, cách cài), nên một số hướng dẫn cũ trên mạng có thể không còn khớp; hãy theo README mới nhất.
- Chi phí API mô hình có thể tăng nhanh khi agent chạy nhiều bước.
Câu hỏi thường gặp
OpenHands có miễn phí không?
Phần tự host dùng giấy phép MIT và miễn phí. Bạn chỉ trả tiền cho mô hình AI nếu dùng dịch vụ tính phí, hoặc dùng các tuỳ chọn đám mây của OpenHands nếu chọn.
Tôi không biết lập trình có cần không?
Công cụ nhằm vào việc phát triển phần mềm và cần cài Docker hoặc Node.js, nên người không làm kỹ thuật sẽ khó dùng.
Có an toàn không?
Dùng bản Docker có sandbox an toàn hơn chạy trực tiếp, nhưng vẫn nên chỉ chia sẻ thư mục cần thiết và giữ cổng ở máy cục bộ. Đọc kỹ tài liệu bảo mật của dự án trước khi đưa lên máy chủ.
Tải mã nguồn về máy
Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.
git clone https://github.com/OpenHands/OpenHands.gitRepo tương tự nên xem
OpenCode
anomalyco / opencode
Trợ lý AI viết code mã nguồn mở, chạy trong Terminal hoặc app desktop, nối được nhiều nhà cung cấp mô hình
Aider
Aider-AI / aider
Lập trình cặp với AI ngay trong Terminal: AI sửa code trong dự án và tự commit Git cho bạn
Cline
cline / cline
Trợ lý AI viết code mã nguồn mở trong VS Code, JetBrains, Terminal và app desktop, dùng được nhiều mô hình