Điều kiện tiên quyết
- Linux (Ubuntu/Debian/CentOS, v.v.) hoặc macOS
- RAM 2 GB+, dung lượng đĩa trống 10 GB+
- Quyền truy cập shell có thể kết nối tới npm registry công khai
- Node.js 18.x hoặc 20.x LTS (xem Bước 1)
- Tài khoản CometAPI với API key đang hoạt động — lấy tại đây
1
Lấy CometAPI API key của bạn
2
Cài đặt Node.js qua nvm
n8n 1.x yêu cầu Node.js 18.x hoặc 20.x. Cách tiếp cận được khuyến nghị là nvm:
Nếu sau này bạn thấy
n8n: command not found, hãy khởi động lại terminal hoặc đảm bảo thư mục npm global bin do nvm quản lý nằm trong PATH của bạn.3
Cài đặt và khởi động n8n


4
Tạo tài khoản Owner của bạn
Mở http://localhost:5678/ trên trình duyệt. Trong lần chạy đầu tiên, trình hướng dẫn thiết lập sẽ yêu cầu bạn tạo tài khoản Owner (email + mật khẩu). Hoàn tất bước này và đăng nhập.

5
Cài đặt node cộng đồng CometAPI
- Vào Settings (góc dưới bên trái) → Community nodes
- Nhấp Install a community node
- Nhập tên package:
@cometapi-dev/n8n-nodes-cometapi - Chọn ô xác nhận rủi ro và nhấp Install


Nếu phần Community Nodes không xuất hiện: hãy đảm bảo bạn đã đăng nhập bằng tài khoản Owner, và kiểm tra Settings → Security để xác nhận rằng việc cài đặt community node đã được bật.
6
Tạo workflow và cấu hình credentials
- Nhấp + New ở phía trên để tạo một workflow.
- Nhấp + trên canvas và tìm kiếm CometAPI để thêm node.


- Thêm node Manual Trigger và kết nối nó với node CometAPI.
- Trong node CometAPI, ở mục Credential to connect with, chọn Create new. Dán CometAPI API key của bạn vào CometAPI Key và nhấp Save. Base URL mặc định là
https://api.cometapi.comvà thường không cần thay đổi.

- Cấu hình node:
- Model: nhập model ID hiện tại mà bạn muốn sử dụng
- Messages: đặt Role là
user, Content là prompt thử nghiệm của bạn (ví dụ:Hello) - Tùy chọn: thêm message
system, đặt Max Tokens, Temperature, v.v.
- Nhấp Execute step để chạy node. Bảng Output sẽ hiển thị phản hồi JSON.

Khắc phục sự cố
Khắc phục sự cố
- Lỗi
node-gyphoặc lỗi build native — cài đặt build tools:sudo apt install build-essential python3(Debian/Ubuntu) hoặc Xcode Command Line Tools (macOS). - Lỗi quyền npm (EACCES) — sử dụng nvm để cài đặt Node.js ở cấp người dùng; không cần
sudo. - Xung đột cổng (
localhost:5678không khả dụng) — đặtN8N_PORT=5679(hoặc cổng trống khác) trước khi chạyn8n start. - Không có phần Community Nodes — đăng nhập bằng tài khoản Owner và kiểm tra Settings → Security.
- npm install thất bại trên mạng doanh nghiệp — cấu hình proxy:
npm config set proxy http://user:pass@host:port - Node CometAPI trả về 401/403 — xác minh API key của bạn và đảm bảo model có thể truy cập trong gói CometAPI của bạn.
- Phản hồi rỗng hoặc lỗi giới hạn token — tăng Max Tokens; điều chỉnh Temperature và Top P nếu cần.
- n8n dừng khi đóng terminal — dùng pm2:
pm2 start "n8n" --name n8n && pm2 save.

