Chuyển đến nội dung chính
InFlow CLI là một ứng dụng native có chữ ký số. Với CLI này, agent dùng Buyer Wallet để khám phá dịch vụ, ghi danh với các dịch vụ đó và thanh toán qua MPP và x402.

Nền tảng được hỗ trợ

Trình cài đặt Linux hỗ trợ Debian, Ubuntu, Fedora và RHEL có systemd. Cài đặt curl, gpg và gpgv trước. Trình cài đặt cũng cần quyền root hoặc quyền sudo. Alpine, BusyBox và các hệ thống chỉ dùng musl không được hỗ trợ.

Cài đặt CLI

Trên Windows, chạy trình cài đặt trong PowerShell, với tư cách một người dùng có thể phê duyệt hộp thoại quản trị của Windows Installer. Command Prompt, Git Bash, MSYS và Cygwin không được hỗ trợ. Kiểm tra vị trí cài đặt của InFlow và phiên bản bạn có.
Nếu terminal không tìm thấy inflow, mở một terminal mới. Với trình cài đặt trực tuyến trên macOS, thêm ~/.local/bin vào PATH của bạn. Không cài đặt CLI từ npm. Package npm @inflowpayai/inflow chỉ cài đặt một thông báo cho biết NPM_CLI_DEPRECATED. Package này không chạy lệnh, không khởi động MCP và không quản lý credential. Nếu bạn đã cài đặt package này, gỡ bỏ package bằng npm uninstall -g @inflowpayai/inflow.
Homebrew (macOS)
WinGet (Windows)
Nếu bạn cài đặt bằng Homebrew hoặc WinGet, cập nhật bằng chính công cụ đó. Script trực tuyến tạo một bản cài đặt riêng.Endpoint tương thích. Endpoint này chọn đúng trình cài đặt trên macOS và trên Linux. Trên Windows, dùng PowerShell hoặc WinGet.
Tải trực tiếp. Mỗi GitHub Release có một file cho mỗi nền tảng.Các bản phát hành Linux gồm package Debian, package RPM và file nén độc lập cho ARM64 và AMD64. File zip cho macOS chứa InFlow.app, với file thực thi tại InFlow.app/Contents/MacOS/inflow.

Những việc trình cài đặt làm

Trình cài đặt kiểm tra từng package trước khi cài đặt package đó. Để tự kiểm tra chữ ký, xem Xác minh trình cài đặt.

Nâng cấp CLI

InFlow không tự cập nhật. Cập nhật bằng phương thức bạn đã dùng để cài đặt InFlow. Trình cài đặt trực tuyến cài đặt GitHub Release mới nhất.
Khi có phiên bản mới hơn, response của inflow auth status chứa trường update. Sau khi cập nhật, khởi động lại kết nối InFlow MCP trong ứng dụng agent của bạn, hoặc khởi động lại ứng dụng. Sau đó agent tải CLI mới và các công cụ của CLI.

Mở khóa vault

CLI giữ OAuth token, API key và credential của dịch vụ trong một vault cục bộ được mã hóa. Khởi tạo vault trước lệnh đầu tiên dùng credential.
Lệnh này yêu cầu một PIN hoặc một cụm mật khẩu. CLI chỉ đọc giá trị này từ terminal, không bao giờ từ đối số MCP, flag, biến môi trường hoặc đầu vào của agent.
Tự chạy inflow vault unlock trong terminal của chính bạn. Không bao giờ đưa PIN hoặc cụm mật khẩu cho agent.
Khi vault bị khóa, lệnh từ agent trả về lỗi cần con người thao tác. Chỉ chủ sở hữu có thể mở khóa vault. Theo mặc định, vault khóa lại sau tám giờ không có hoạt động và khi máy tính chuyển sang chế độ ngủ. Để đặt thời gian chờ ngắn hơn, ví dụ 15 phút, chạy lệnh này.

Quản lý vault

status, lock và policy không cần PIN hoặc cụm mật khẩu. set-policy nhận hai flag. --idle-timeout-seconds khóa vault sau số giây không hoạt động đó. 0 tắt thời gian chờ khi không hoạt động. --lock-on-sleep khóa vault khi máy tính chuyển sang chế độ ngủ.
inflow vault reset --force xóa mọi credential trong vault. Sau khi đặt lại, đăng nhập lại. Sau đó chạy inflow aep status cho từng dịch vụ. Nếu một dịch vụ không hiển thị ghi danh nào, ghi danh lại.

Tắt kiểm tra cập nhật

Đặt NO_UPDATE_NOTIFIER=1 để tắt kiểm tra phiên bản.

Gỡ cài đặt CLI

Các lệnh này giữ lại vault được mã hóa của bạn, nên các credential đã lưu hoạt động lại sau khi cài đặt lại. Trên Linux, tùy chọn --purge của trình cài đặt trực tuyến cũng xóa /var/lib/inflow, /var/lib/inflow-broker và /run/inflow. Bạn không thể hoàn tác thao tác này. Trên macOS, --purge hoạt động giống --uninstall.

Bước tiếp theo

Xác thực

Đăng nhập cho agent bằng device flow hoặc bằng API key.
Lần sửa đổi cuối 27 tháng 10, 2026