Chuyển đến nội dung

OpenHands / OpenHands

OpenHands (Agent Canvas)

Bảng điều khiển tự cài để giao việc lập trình cho các agent AI như OpenHands, Claude Code hay Codex

OpenHands là dự án agent lập trình mã nguồn mở; bản README hiện tại giới thiệu Agent Canvas, một bảng điều khiển trên web để bạn mở các cuộc trò chuyện với agent, giao việc và đặt lịch tự động hoá. Nó chạy được trên máy bạn hoặc máy chủ riêng, dùng agent OpenHands hoặc các agent khác như Claude Code, Codex, Gemini CLI. Hợp với người làm phần mềm muốn có một nơi quản lý nhiều agent.

  • 93.586 sao
  • 12.530 fork
  • TypeScript
  • Cập nhật hôm nay
  • MIT (dùng tự do, kể cả thương mại)
Độ khó
Khó Dành cho người biết lập trình
Dạng
Web tự cài (self-host), Dòng lệnh (CLI)
Chạy trên
Windows, macOS, Linux, Docker, Node.js
Chi phí
Miễn phí (trả phí API AI nếu dùng)

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)

  1. Cài Docker Desktop cho Windows và bật nó lên. Sau đó mở PowerShell và kéo image về.

    PowerShell
    docker pull ghcr.io/openhands/agent-canvas:1.40.0
  2. Chọ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.

    PowerShell
    $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.0
  3. Mở http://localhost:8000/canvas trong trình duyệt.

Cài trên macOS / Linux (Docker)

  1. Cài Docker, chọn thư mục dự án và tạo nó trước.

    Terminal
    export PROJECTS_PATH="$HOME/projects"
    mkdir -p "$PROJECTS_PATH"
  2. 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.

    Terminal
    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.0
  3. Mở http://localhost:8000/canvas trong trình duyệt.

Cài trên Không sandbox (npm)

  1. 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.

    Terminal
    npm install -g @openhands/agent-canvas
    agent-canvas

Dùng thử lần đầu

  1. 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.

  2. 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 đó.

  3. 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.

  4. 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.

Terminal
git clone https://github.com/OpenHands/OpenHands.git

Repo tương tự nên xem

AI hỗ trợ lập trình227K

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

VừaWindowsmacOSLinuxNode.js
AI hỗ trợ lập trình50,1K

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

KhóWindowsmacOSLinuxPython
AI hỗ trợ lập trình71,7K

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

VừaWindowsmacOSLinuxNode.js

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: AI Agent & tự động hoá

AI Agent & tự động hoá395K

OpenClaw

openclaw / openclaw

Trợ lý AI chạy trên máy bạn và trả lời ngay trong Telegram, WhatsApp, Discord, Slack và nhiều app chat khác

VừaWindowsmacOSLinuxNode.js+1
AI Agent & tự động hoá264K

Hermes Agent

NousResearch / hermes-agent

Trợ lý AI dạng agent của Nous Research biết tự học kỹ năng mới, dùng trong Terminal hoặc Telegram

VừaWindowsmacOSLinuxAndroid
AI Agent & tự động hoá211K

n8n

n8n-io / n8n

Tự động hoá công việc bằng sơ đồ kéo thả, nối hơn 1500 ứng dụng và cả AI, tự cài trên máy chủ riêng

VừaDockerWebLinuxWindows+1
AI Agent & tự động hoá202K

Firecrawl

firecrawl / firecrawl

API biến trang web thành markdown hoặc JSON sạch để nạp cho AI, có thể dùng bản cloud hoặc tự cài

VừaWebPythonNode.jsDocker
AI Agent & tự động hoá188K

AutoGPT

Significant-Gravitas / AutoGPT

Nền tảng tạo đội trợ lý AI chuyên biệt và quy trình tự động, dùng bản cloud hoặc tự cài bằng Docker

VừaWebDockerWindowsmacOS+1
AI Agent & tự động hoá161K

Dify

langgenius / dify

Nền tảng kéo thả để dựng ứng dụng AI, chatbot hỏi đáp tài liệu và quy trình tự động, tự cài bằng Docker

VừaDockerWebLinuxWindows+1

Xem cả 28 repo AI Agent & tự động hoá Về Kho Repo