Tự động hoá · 9 phút đọc · 2026-11-13
AI agent open source chạy local: chọn và tự cài trên máy của bạn
Sáu agent tự cài trên máy, bốn cái nguồn mở theo OSI và hai cái mã nguồn công khai có điều kiện: viết code, trợ lý nhắn qua app chat, app desktop, quy trình kéo thả và điều phối việc trong nhóm chat. Kèm giấy phép, lệnh cài và lưu ý an toàn.
Muốn tự cài một AI agent lên máy, bạn chọn theo việc cần làm. Viết code trong terminal thì xem OpenCode; muốn trợ lý cá nhân nhắn qua Telegram, WhatsApp hay Discord thì OpenClaw hoặc Hermes Agent. Cần agent đa dụng có app desktop thì Goose, dựng quy trình agent bằng kéo thả thì n8n, còn đội làm việc qua nhóm chat Zalo và muốn agent lập trình có người duyệt thì có Deti.
Phần mềm miễn phí chưa chắc chạy miễn phí: agent nào cũng cần một model, thường là API key trả theo token hoặc gói ChatGPT, Claude, Gemini nếu agent cho đăng nhập bằng gói. Các agent này cũng nối được model chạy tại máy.
Chữ "open source" cũng không giống nhau giữa các AI agent mã nguồn mở ở đây. OpenCode, OpenClaw, Hermes Agent (MIT) và Goose (Apache-2.0) dùng giấy phép nguồn mở theo OSI. n8n (Sustainable Use License) và Deti (Apache-2.0 kèm Commons Clause) là mã nguồn công khai có điều kiện: đọc, chạy, sửa, dùng nội bộ miễn phí được, nhưng giới hạn việc bán. Ai tìm "free ai agent open source" nên xem cả giấy phép lẫn tiền model.
Mỗi AI agent open source local bên dưới có đủ yêu cầu, model, giấy phép, lệnh cài và lưu ý. Số sao đọc từ API GitHub ngày 13/11/2026 và sẽ còn đổi; cả năm kho bên ngoài đều có mã mới trong ngày đó.
Cần chuẩn bị gì trước khi cài
- Máy Windows 10/11, macOS hoặc Linux. Deti chỉ chạy trên Windows.
- Công cụ nền tùy agent: Node.js, Docker (n8n), PostgreSQL (Deti).
- Một tài khoản thường, không phải quản trị.
- API key của nhà cung cấp model, hoặc gói ChatGPT / Claude / Gemini với agent hỗ trợ đăng nhập bằng gói.
- Một thư mục dự án đã có git để lùi được mọi thay đổi.
OpenCode: agent lập trình trong terminal
OpenCode tự mô tả là "The open source AI coding agent". Kho anomalyco/opencode (trước là sst/opencode): MIT, 226.483 sao.
- Cần gì: theo docs, Windows có tệp CLI chạy độc lập (x64, ARM64) và bản Desktop; docs ghi "Windows package managers are not supported". Docs bản V1 khuyên dùng WSL.
- Model: gõ
/connect, chọn nhà cung cấp, nhập thông tin đăng nhập, rồi/models. Với OpenAI có thể chọn "Sign in with ChatGPT" để dùng gói Plus hoặc Pro thay API key. Trang Providers không nói tới đăng nhập bằng gói Claude. Gói tùy chọn OpenCode Go ghi 10 USD/tháng.
curl -fsSL https://opencode.ai/v2/install | bash
npm i -g @opencode/cli@latest # or bun/pnpm/yarn- Chạy một trong hai lệnh. Xong khi giao diện terminal của OpenCode mở được.
- Gõ
/connectrồi/models. Không thấy nhà cung cấp cần dùng thì xem trang Providers.
Phím Tab đổi giữa agent build (toàn quyền) và plan (chỉ đọc, hỏi trước khi chạy bash). Plan hợp để làm quen dự án lạ trước khi cho build sửa.
OpenClaw: trợ lý cá nhân qua kênh chat
OpenClaw là trợ lý AI chạy trên máy bạn, gặp bạn ở Discord, iMessage, Slack, Teams, Telegram, WhatsApp và hơn 20 kênh khác. Kho openclaw/openclaw: MIT, 394.404 sao.
- Cần gì: bộ cài tự cài Node.js khi cần; tự quản lý Node thì 24.16.0+ hoặc 26.1.0+. Trên Windows, docs khuyên app Windows Hub, kèm một Gateway chạy trong WSL do app quản lý.
- Model:
OPENAI_API_KEYhoặc đăng nhập ChatGPT/Codex bằng OAuth;ANTHROPIC_API_KEYhoặc tái dùng Claude CLI (claude -p);GEMINI_API_KEY.
# Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bashnpm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard- Chạy bộ cài script. Xong khi bước onboarding tự mở.
- Cài bằng npm thay script thì chạy thêm
openclaw onboard --install-daemon; npm 11.15 trở xuống bỏ cờ--allow-scripts=openclaw. - Chạy
openclaw gateway statusđể xem gateway.
README ghi công cụ chạy thẳng trên máy cho phiên chính nếu chưa cấu hình sandbox, và coi tin nhắn đến là không tin cậy. Plugin "Zalo personal" dùng client không chính thức, chính docs cảnh báo có thể bị khoá tài khoản; plugin Zalo dùng bot của Zalo Bot Platform là đường an toàn hơn.
Hermes Agent: trợ lý tự học, chạy trên máy hoặc VPS
Hermes Agent của Nous Research tạo skill từ kinh nghiệm, nhớ qua các phiên, nhắn qua Telegram, Discord, Slack, WhatsApp, Signal; README ghi chạy được trên VPS 5 USD. Kho NousResearch/hermes-agent: MIT, 262.989 sao.
- Cần gì: Windows chạy native, không cần WSL. Bộ cài tự lo Python 3.14, Node.js, ripgrep, FFmpeg và vài công cụ khác.
- Model: chọn bằng
hermes model. Theo docs, đăng nhập ChatGPT bằng OAuth được; gói Claude Pro không đăng nhập được, gói Claude Max chỉ trừ vào phần credit mua thêm, nên muốn dùng Claude thường phải quaANTHROPIC_API_KEY.
iex (irm https://hermes-agent.nousresearch.com/install.ps1)# Linux, macOS, WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashhermes # Interactive CLI — start a conversation
hermes model # Choose your LLM provider and model
hermes setup # Run the full setup wizard (configures everything at once)
hermes doctor # Diagnose any issues- Chạy bộ cài hợp với hệ điều hành.
- Chạy
hermes setup. Bước nào hỏng thìhermes doctorđể chẩn đoán. - Gõ
hermes. Xong khi agent trả lời.
Phần mềm diệt virus có thể báo nhầm uv.exe trong thư mục bin của Hermes; README có mục chỉ cách kiểm chứng tệp.
Goose: agent đa dụng có app desktop
Goose làm cả việc ngoài lập trình: nghiên cứu, viết, tự động hoá, phân tích dữ liệu, qua app desktop, CLI hoặc API. Goose thuộc Agentic AI Foundation tại Linux Foundation, trước đây ở kho block/goose; kho hiện tại aaif-goose/goose: Apache-2.0, 56.507 sao.
- Cần gì: trên Windows, bộ cài
Goose-win32-x64-setup.execài cho người dùng hiện tại, không cần quyền quản trị. CLI cần Git Bash, MSYS2 hoặc PowerShell; docs khuyên chạy CLI native, WSL là tùy chọn. - Model: hơn 15 nhà cung cấp bằng API key, hoặc gói sẵn có qua ACP: gói Claude Code cần lệnh
claudeđã đăng nhập (xem cài Claude Code), gói ChatGPT Plus/Pro cần lệnhcodexđã đăng nhập.
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bashInvoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1";
.\download_cli.ps1Không quen terminal thì tải bộ cài Desktop từ trang Installation.
n8n: dựng agent bằng kéo thả, tự host
n8n không tự chạy lệnh trên máy như các agent trên. Đây là nền tảng kéo thả có node AI Agent: nối một chat model với ít nhất một tool sub-node, agent tự chọn tool để làm việc. Kho n8n-io/n8n: 210.336 sao.
- Giấy phép: Sustainable Use License (fair-code). Chỉ dùng cho nội bộ doanh nghiệp mình hoặc phi thương mại / cá nhân, chỉ phân phối miễn phí cho mục đích phi thương mại, không gỡ thông báo giấy phép. n8n tự ghi họ không gọi mình là open source.
- Cần gì: Docker. Cài bằng npm cần Node.js 20.19 đến 24.x, nhưng đã deprecated từ n8n 3.0.
docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n- Tạo volume bằng lệnh đầu.
- Chạy container bằng lệnh thứ hai.
- Mở
http://localhost:5678. Xong khi thấy trình soạn workflow.
Các bước dựng workflow nằm ở bài tạo AI agent miễn phí bằng n8n.
Deti: điều phối viên AI trong nhóm chat
Deti là dự án của hstation. Nó vào nhóm chat như một thành viên, nhận yêu cầu bằng lời thường, giao cho các agent lập trình chạy trên máy của bạn, rồi báo lại khi kết quả đã được kiểm.
- Làm gì: mỗi dự án một làn (phiên agent riêng). Mọi lời gọi công cụ đều qua cổng: chỉ sửa trong thư mục dự án; commit, deploy và máy chủ thật chờ lời người duyệt có tên trong nhóm. Việc chỉ đóng khi có lần kiểm tra đạt trên thay đổi mới nhất.
- Cần gì: Node.js 22 trở lên, PostgreSQL, Windows 10/11, một tài khoản chat riêng cho agent.
- Model: Claude Code đã cài và đăng nhập (xem bài Claude Code); Codex CLI và khoá z.ai là bộ não bổ sung, một bên hết hạn mức thì bên kế tiếp làm tiếp từ điểm lưu.
- Cài: hướng dẫn cài nằm ở trang Deti.
Các giới hạn cần biết trước khi cài:
- Kênh Zalo không chính thức: kênh chat duy nhất hiện nay là Zalo, qua zca-js, một client không chính thức, không liên kết và không được Zalo bảo trợ. Dùng nó có thể vi phạm điều khoản của Zalo và tài khoản có thể bị khoá. Dùng tài khoản riêng cho agent, không dùng tài khoản cá nhân, và tự chịu rủi ro.
- Chỉ chạy trên Windows; Linux đang làm.
- Trang quản trị không có đăng nhập, chỉ cho máy tại chỗ; đừng mở cổng ra ngoài hay đặt sau reverse proxy.
- Trước phát hành: còn thay đổi không tương thích trước bản 1.0; nhóm nói tiếng Anh có luật chắn yếu hơn nhóm tiếng Việt.
- Cổng chặn là rào chắn, không phải hộp cát: nó không soi được script agent tự viết rồi chạy. Ai giao được việc cho Deti là làm lệnh chạy được trên máy, nên chỉ bật nhóm có người bạn tin.
- Giấy phép Apache-2.0 kèm Commons Clause: được dùng, sửa, cài cho công ty mình miễn phí; không được bán lại Deti, không bán dịch vụ hosting, cài đặt hay hỗ trợ Deti. Vì giới hạn việc bán, đây không phải giấy phép nguồn mở theo Định nghĩa nguồn mở của OSI, nên gọi đúng là mã nguồn công khai, không phải open source.
Chọn AI agent open source local theo nhu cầu
- Một mình viết code — OpenCode, bắt đầu bằng agent plan.
- Trợ lý nhắn qua app chat — OpenClaw hoặc Hermes Agent.
- Cần app desktop, không rành terminal — Goose Desktop.
- Tự động hoá quy trình nhiều bước — n8n.
- Cả đội giao việc trong nhóm Zalo, cần người duyệt — Deti.
Máy Windows mà không muốn WSL: Hermes Agent và CLI của Goose chạy native, còn Windows Hub của OpenClaw vẫn dùng Gateway trong WSL.
An toàn khi cho agent chạy lệnh trên máy
Cài đặt AI agent trên máy tính là cho một chương trình chạy lệnh bằng quyền của bạn.
- Dùng tài khoản hệ điều hành riêng hoặc máy ảo nếu được, không chạy bằng quyền quản trị.
- Chỉ mở agent trong thư mục dự án, không mở ở thư mục gốc người dùng.
- Để khoá API trong biến môi trường hoặc tệp cấu hình riêng, không commit lên git. Đặt hạn mức chi tiêu ở trang nhà cung cấp, vì agent có thể gọi model nhiều lần cho một yêu cầu.
- Commit trước khi cho agent sửa; bắt đầu bằng chế độ chỉ đọc nếu agent có.
- Lệnh cài một dòng chạy script lấy từ mạng: đọc script trước, chỉ lấy từ tên miền chính thức.
- Tin nhắn từ kênh chat là đầu vào không tin cậy (prompt injection); chỉ cho người bạn tin nhắn với agent.
Kiểm lại
- Agent mở được; lệnh chẩn đoán nếu có (
hermes doctor,openclaw gateway status) không báo lỗi. - Model đã nối, đã đặt hạn mức chi tiêu.
- Giấy phép hợp với cách bạn định dùng, nhất là n8n và Deti.
- Muốn tìm thêm AI agent open source local khác, xem giấy phép và ngày đẩy mã trước số sao.
- Tác giả
- Quản trị viên
- Đăng ngày
- 2026-11-13
- Cập nhật
- 2026-11-13
- Thời gian đọc
- 9 phút đọc
- Tất cả bài viết