> ## Documentation Index
> Fetch the complete documentation index at: https://ifdocdemo.lumivescence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cài đặt CLI

> Cài đặt InFlow CLI trên macOS, Linux hoặc Windows. Sau đó mở khóa vault cục bộ.

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ợ

| Nền tảng | Kiến trúc |
| - | - |
| macOS | Apple Silicon và Intel |
| Windows | x64 và ARM64 |
| Linux | ARM64 và AMD64 |

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

```bash macOS / Linux theme={null}
curl -fsSL https://inflowcli.ai/install.sh | bash
```

```powershell Windows theme={null}
irm https://inflowcli.ai/install.ps1 | iex
```

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

```bash macOS / Linux theme={null}
command -v inflow
inflow --version
```

```powershell Windows theme={null}
Get-Command inflow | Select-Object -ExpandProperty Source
inflow --version
```

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

> [accordion] Các cách cài đặt khác
>
> **Homebrew (macOS)**
>
> ```bash theme={null}
> brew tap inflowpayai/tap
> brew install --cask inflow
> ```
>
> **WinGet (Windows)**
>
> ```powershell theme={null}
> winget install --id InFlowPayAI.InFlow --exact
> ```
>
> 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.
>
> ```bash theme={null}
> curl -fsSL https://inflowcli.ai/cli | bash
> ```
>
> **Tải trực tiếp.** Mỗi [GitHub Release](https://github.com/inflowpayai/inflow-cli/releases) có một file cho mỗi nền tảng.
>
> | File | Nền tảng |
> | - | - |
> | `inflow-<version>-darwin-arm64.zip` | Máy Mac Apple Silicon |
> | `inflow-<version>-darwin-x64.zip` | Máy Mac Intel |
> | `inflow-<version>-windows-arm64.msi` | Windows ARM64 |
> | `inflow-<version>-windows-x64.msi` | Windows x64 |
>
> 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 đó.

| Nền tảng | Kiểm tra | Kết quả |
| - | - | - |
| macOS | Checksum, chữ ký code và Gatekeeper | `InFlow.app` nằm ở `~/.local/share/inflow`. Lệnh `inflow` nằm ở `~/.local/bin`. |
| Linux | Release manifest có chữ ký OpenPGP và checksum của package | Package hệ thống Debian hoặc RPM tương ứng. Package này cài đặt dịch vụ vault của hệ thống. |
| Windows | Checksum MSI, trạng thái Authenticode và nhà phát hành | Windows Installer cài đặt CLI và dịch vụ vault của CLI. |

Để tự kiểm tra chữ ký, xem [Xác minh trình cài đặt](https://inflowcli.ai/verify-install).

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

```bash macOS / Linux theme={null}
curl -fsSL https://inflowcli.ai/install.sh | bash
```

```powershell Windows theme={null}
irm https://inflowcli.ai/install.ps1 | iex
```

```bash Homebrew theme={null}
brew upgrade --cask inflow
```

```powershell WinGet theme={null}
winget upgrade --id InFlowPayAI.InFlow --exact
```

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.

```bash theme={null}
inflow vault unlock
```

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.

> [!WARNING]
>
> 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.

```bash theme={null}
inflow vault set-policy --idle-timeout-seconds 900 --lock-on-sleep
```

### Quản lý vault

| Lệnh | Chức năng |
| - | - |
| `inflow vault status` | Hiển thị trạng thái của vault cục bộ. |
| `inflow vault lock` | Khóa vault. |
| `inflow vault policy` | Hiển thị chính sách khóa. |
| `inflow vault set-policy` | Thay đổi chính sách khóa. |
| `inflow vault change-passphrase` | Thay đổi PIN hoặc cụm mật khẩu. |
| `inflow vault reset --force` | Xóa cơ sở dữ liệu, sidecar và các file runtime của vault cục bộ. |

`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ủ.

> [!WARNING]
>
> `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.

```bash theme={null}
export NO_UPDATE_NOTIFIER=1
```

## Gỡ cài đặt CLI

```bash macOS / Linux theme={null}
curl -fsSL https://inflowcli.ai/install.sh | bash -s -- --uninstall
```

```powershell Windows theme={null}
$env:INFLOW_UNINSTALL = '1'
try { irm https://inflowcli.ai/install.ps1 | iex } finally { Remove-Item Env:INFLOW_UNINSTALL }
```

```bash Homebrew theme={null}
brew uninstall --cask inflow
```

```powershell WinGet theme={null}
winget uninstall --id InFlowPayAI.InFlow --exact
```

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

> [card] [Xác thực](https://ifdocdemo.lumivescence.com/vi/agents/authenticate.md)
>
> Đăng nhập cho agent bằng device flow hoặc bằng API key.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.