n8n là gì? Cài đặt, AI Agent và cách dùng API key OpenAI, Claude trong n8n

n8n là gì?

n8n là công cụ tự động hoá quy trình làm việc (workflow automation): bạn nối các bước trên một khung vẽ kéo thả, mỗi bước là một node, như nhận dữ liệu từ form, gọi API, ghi vào Google Sheets, gửi email hay hỏi một model AI. Tài liệu chính thức mô tả n8n là công cụ tự động hoá theo giấy phép fair-code, kết hợp tính năng AI với tự động hoá quy trình kinh doanh; trang chủ ghi hơn 500 tích hợp có sẵn, và khi cần, bạn chèn code JavaScript hoặc Python vào giữa luồng.

n8n do công ty n8n GmbH ở Berlin (Đức) phát triển, Jan Oberhauser thành lập năm 2019. Tên viết thường, đọc là “n eight n”, rút gọn từ “nodemation” (node cộng automation). n8n chạy trên n8n Cloud của hãng hoặc tự cài trên máy chủ của bạn.

n8n dùng để làm gì?

Một số kiểu việc hay làm bằng n8n:

• Nối ứng dụng với nhau: khách điền form thì tạo dòng mới trong bảng tính, gửi email xác nhận và báo vào kênh chat của nhóm.
• Việc lặp lại theo lịch: tổng hợp số liệu mỗi sáng thành báo cáo, sao lưu dữ liệu, đồng bộ danh sách khách hàng giữa các hệ thống.
• Dùng AI trong luồng: phân loại email đến, tóm tắt tài liệu, trích thông tin từ hoá đơn, trả lời câu hỏi theo tài liệu nội bộ theo kiểu RAG.
• Dựng AI agent: cho model tự chọn công cụ (tra cứu, gọi API, ghi dữ liệu) cho tới khi xong việc.

n8n có phải mã nguồn mở không?

Không hẳn. Từ 17/03/2022, n8n dùng giấy phép Sustainable Use License theo mô hình fair-code: mã nguồn công khai, nhưng có giới hạn cách dùng, nên chính n8n ghi rõ họ không tự gọi mình là mã nguồn mở theo định nghĩa của Open Source Initiative. Câu tóm tắt trong FAQ giấy phép: nếu workflow chỉ do bạn hoặc người trong tổ chức của bạn tạo và sửa, bạn được dùng bản Community miễn phí.

• Được: dùng n8n để vận hành công việc của doanh nghiệp; dùng cho dự án cá nhân, học tập, nghiên cứu; dựng automation cho khách trên máy của bạn nếu khách không tự tạo hay sửa được workflow; thu phí dựng, bảo trì workflow, đào tạo và tư vấn; dùng n8n chạy ngầm trong sản phẩm của bạn.
• Không được: cho thuê n8n như một dịch vụ để khách tự dựng workflow; để người dùng bên ngoài tự cấu hình workflow qua sản phẩm của bạn (giao diện riêng, API, MCP hay AI agent thay mặt họ); lấy mã của n8n làm sản phẩm automation riêng; gỡ thương hiệu n8n để bán lại (white-label); dùng tính năng doanh nghiệp đòi license key khi chưa mua.

n8n Cloud và bản tự host khác gì?

n8n Cloud có các gói Starter, Pro và Enterprise, tính theo số lượt chạy workflow (execution) mỗi tháng; một lượt là một lần chạy trọn workflow, dù workflow có bao nhiêu bước. Từ ngày 07/08/2025, mọi gói không còn giới hạn số người dùng và số workflow đang bật. Có bản dùng thử 14 ngày không cần thẻ, giới hạn 1.000 lượt chạy; hết hạn mà không nâng cấp thì instance bị xoá, bạn còn 90 ngày để tải workflow về. Dữ liệu của bản Cloud lưu ở EU (Frankfurt). Giá trên trang chính thức ghi bằng ngoại tệ.

Tự host có bản Community miễn phí, Registered Community (miễn phí, đăng ký bằng email để mở thêm thư mục, debug trong editor, dữ liệu thực thi tuỳ chỉnh), Business và Enterprise trả phí. Bản Community thiếu SSO, Projects, quản lý phiên bản bằng Git, nhiều môi trường, external secrets, log streaming và chia sẻ workflow, credential giữa nhiều người. n8n Cloud không có gói miễn phí lâu dài; cách dùng n8n miễn phí là tự host bản Community.

Cài n8n tự host bằng Docker

Cách được tài liệu khuyên cho cài mới là lệnh một dòng curl -fsSL https://get.n8n.io | sh: cần Docker và plugin docker compose bản 2, chạy trên Linux, macOS, còn Windows thì chạy trong WSL. Lệnh tạo thư mục ./n8n gồm compose.yml và file .env có secret sinh ngẫu nhiên. Muốn chạy nhanh để thử trên máy, dùng docker run như khối dưới rồi mở http://localhost:5678.

Lưu ý khi chạy thật: cơ sở dữ liệu mặc định là SQLite, đủ để thử; instance chạy cả ngày cho nhiều người nên dùng PostgreSQL (bản 17, 18, kèm 16). n8n tự sinh khoá mã hoá credential ở lần chạy đầu và lưu trong thư mục ~/.n8n, nên sao lưu thư mục này. Đặt n8n sau reverse proxy có HTTPS, đừng mở thẳng cổng 5678 ra Internet; địa chỉ webhook đặt bằng biến N8N_WEBHOOK_URL (biến cũ WEBHOOK_URL vẫn chạy nhưng đã bị đánh dấu ngừng dùng từ bản 2.35.0).

docker volume create n8n_data
docker run -it --rm --name n8n -p 5678:5678 \
  -e GENERIC_TIMEZONE="Asia/Ho_Chi_Minh" -e TZ="Asia/Ho_Chi_Minh" \
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
  -v n8n_data:/home/node/.n8n n8nio/n8n

Máy chủ cần cấu hình thế nào?

Tài liệu triển khai lên Hetzner và DigitalOcean ghi gói máy chủ nhỏ là đủ cho phần lớn mức dùng, và n8n không nặng CPU; một instance Cloud lúc rảnh dùng khoảng 100 MB bộ nhớ. Mức 4 GB RAM và 2 vCPU chỉ cần khi chạy kèm sandbox của n8n Assistant. Nếu workflow xử lý file lớn mà báo “n8n may have run out of memory while executing it”, tăng RAM cho máy chủ.

Phiên bản n8n hiện tại và các thay đổi lớn

Tại thời điểm viết, bản ổn định là n8n 2.44.6 (22/10/2026), bản beta là 2.45.3. Các mốc cần biết:

• n8n 2.0 (12/2025): Code node chạy trên task runner theo mặc định và không đọc được biến môi trường; bỏ MySQL, MariaDB làm cơ sở dữ liệu của n8n; nút Activate đổi thành Publish.
• n8n 3.0: bản beta dự kiến ngày 27/10/2026, bản ổn định đầu tháng 12; từ 3.0 không còn cài bằng npm hay npx n8n, chỉ còn Docker; bỏ các node cũ như Function, Cron, Interval, Item Lists.
• Nhánh 1.x hết hỗ trợ ngày 31/12/2026; muốn lên 3.0 phải lên 2.x trước.
• Ứng dụng n8n Desktop đã ngừng phát triển từ tháng 5/2023; người tìm “n8n download desktop” nên cài bằng Docker.

AI Agent, MCP và trợ lý dựng workflow

Node AI Agent nối một chat model với một hoặc nhiều công cụ; agent tự quyết gọi công cụ nào để hoàn thành việc. n8n có sẵn node chat model cho OpenAI, Anthropic, Google Gemini, DeepSeek, Mistral, Groq, Ollama, OpenRouter và nhiều hãng khác.

Từ bản 1.88.0 (4/2025), n8n có node MCP Client Tool để dùng công cụ của một MCP server bên ngoài, và MCP Server Trigger để biến workflow thành MCP server cho Claude, Cursor hay các agent khác gọi; xem bài MCP là gì. Trợ lý n8n Assistant (đang preview) dựng workflow từ mô tả bằng lời; trên bản tự host, bạn tự đưa API key của nhà cung cấp model.

Dùng API key OpenAI-compatible trong n8n

Trang tài liệu về credential OpenAI chỉ nhắc API Key và Organization ID, nhưng credential này có thêm trường Base URL (chuyển từ node sang credential ở bản 1.73.0), nên trỏ được sang mọi API tương thích OpenAI. Các bước với STEYG Code:

1. Vào Credentials, tạo credential loại OpenAI.
2. Điền API key của STEYG Code; Base URL điền https://steyg.one/api/v1 (phải có /v1 ở cuối). Lưu lại; n8n kiểm tra bằng cách gọi danh sách model.
3. Trong workflow, thêm node AI Agent hoặc Basic LLM Chain, gắn node con OpenAI Chat Model và chọn credential vừa tạo.
4. Ở ô Model, chuyển sang chế độ ID và gõ đúng model id lấy từ GET /v1/models; chế độ From List có thể liệt kê cả model không phải chat.
5. Trong Options của OpenAI Chat Model, tắt Use Responses API khi dùng model Claude, DeepSeek, GLM, Qwen. Từ node v1.3 (n8n 1.119.0), công tắc này bật sẵn và gửi request tới /responses; tài liệu của n8n ghi ngược lại.

Dùng credential Anthropic với Base URL riêng

Credential Anthropic cũng đổi được Base URL từ bản 1.92.0; giá trị mặc định là https://api.anthropic.com, không kèm /v1 vì n8n tự nối /v1/messages. Với STEYG Code, điền https://steyg.one/api và API key, rồi dùng node Anthropic Chat Model với model id Claude. Node này có thêm tuỳ chọn chế độ suy nghĩ (Thinking Mode) và prompt caching.

Node ứng dụng OpenAI (thao tác Message a Model) bản 2 chỉ dùng Responses API và không được thiết kế cho dịch vụ tương thích; với model không phải GPT, dùng AI Agent hoặc Basic LLM Chain cùng OpenAI Chat Model, hoặc node HTTP Request.

Lỗi hay gặp khi nối model trong n8n

Thông báo lỗi của n8n đi theo mã trả về của nhà cung cấp:

• “The resource you are requesting could not be found”: thường do Use Responses API đang bật với nhà cung cấp không có /responses, Base URL của credential OpenAI thiếu /v1, credential Anthropic thừa /v1 (thành /v1/v1/messages), hoặc model id sai.
• “Authorization failed - please check your credentials”: key sai, đã bị thu hồi, hoặc dán nhầm key vào credential của hãng khác.
• “Couldn't connect with these settings” khi lưu credential: bước kiểm tra danh sách model thất bại; xem lại Base URL và key. Nhân viên n8n từng khuyên vẫn lưu credential nếu chỉ bước kiểm tra danh sách model báo lỗi, rồi thử chạy thật.
• “Tools Agent requires Chat Model which supports Tools calling”: model đang chọn không hỗ trợ gọi công cụ; đổi sang model có tool calling.
• “The service is receiving too many requests from you”: vượt giới hạn tốc độ; giảm số lượt chạy song song hoặc bật thử lại trong cài đặt node.
• “Payment required - perhaps check your payment details?”: tài khoản ở nhà cung cấp đã hết tiền. Với STEYG Code, đây là lúc ngân sách đã tiêu hết: request dừng, không bị tính quá số tiền đã trả; mua thêm ngân sách thì key cũ chạy tiếp.
• “Gateway timed out - perhaps try again later?” hoặc “Request timed out.”: yêu cầu chạy quá lâu. Chia nhỏ việc, giảm độ dài đầu ra; tăng tuỳ chọn Timeout của OpenAI Chat Model, còn trần thời gian của các node AI đặt bằng biến N8N_AI_TIMEOUT_MAX (mặc định 1 giờ).

n8n có tiếng Việt không?

Giao diện chính thức của n8n chỉ có tiếng Anh. Bạn vẫn viết prompt, nội dung email hay tin nhắn bằng tiếng Việt bình thường, vì phần đó do model AI và ứng dụng đích xử lý. Người dùng Việt Nam có nhóm cộng đồng n8n Vietnam Community trên Facebook, từng được giới thiệu trên diễn đàn chính thức của n8n.

Những điều bài viết cũ về n8n hay sai

Nếu đọc hướng dẫn cũ, lưu ý các điểm đã đổi:

• “n8n là mã nguồn mở hoàn toàn”: n8n dùng giấy phép fair-code có giới hạn, như mục giấy phép ở trên.
• Bật đăng nhập bằng N8N_BASIC_AUTH_ACTIVE, N8N_BASIC_AUTH_USER: đã bị bỏ từ n8n 1.0 (7/2023), nay quản lý người dùng là bắt buộc.
• “Gói Starter chỉ được 5 workflow”: giới hạn số workflow đang bật đã bỏ từ 07/08/2025.
• “Business là gói Cloud”: gói Business chỉ dành cho bản tự host.
• Tải n8n Desktop, cài bằng Node 18: ứng dụng desktop đã ngừng; gói npm hiện cần Node 24 trở lên và n8n 3.0 bỏ hẳn cách cài bằng npm.
• Đặt Base URL trong Options của node OpenAI Chat Model: chỉ đúng với node bản 1; từ bản 1.1, Base URL nằm trong credential.

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