安装 UiPath CLI

在 Windows、macOS 和 Linux 上安装 UiPath CLI 的要求和步骤，包括 Node.js 先决条件和 npm 全局安装。

UiPath CLI 在 npm 上作为 @uipath/cli 分发，并全局安装 uip 命令。它可以在 Node.js 22 或更高版本支持的任何平台上运行：x64 和 ARM64 上的 Windows、macOS 和 Linux。

先决条件

• Node.js 22或更高版本。Node.js 附带 npm，这足以安装和运行 uip。
• 任何平台 — Windows（x64、ARM64）、macOS（x64、ARM64）、Linux（x64、ARM64）。

检查您的节点版本：

node --version

如果 Node.js 低于 22 版或未安装，请从nodejs.org下载或使用版本管理器，例如nvm (macOS/Linux) 或nvm-windows — 或者让下面的单行安装程序为您配置 Node 。

安装

快速安装 (单引号)

获取有效的 uip 的最快方法。它会确保 Node.js，安装 CLI，运行 uip skills install（自动检测计算机上存在的编码智能体，包括 Claude Code、Cursor、Copilot 等），并安装 .NET SDK 8.0 和 Python。每个步骤都是幂等的，因此可以安全地重新运行脚本，脚本会跳过任何已就位的内容。

# macOS / Linux
curl -fsSL https://download.uipath.com/uipath-cli/install.sh | bash

# Windows (PowerShell)
irm https://download.uipath.com/uipath-cli/install.ps1 | iex

跳过您不想要的部分。每个选项都有一个匹配的环境变量，这对于管道表单非常有用（bash -s -- --flag 并不总是适用于每个 Shell）：

macOS/Linux 标志	Windows PowerShell 开关	环境变量	效果
--dry-run	-DryRun	UIP_DRY_RUN	打印将运行的内容；任何内容都不会更改。
--skip-runtimes	-SkipRuntimes	UIP_SKIP_RUNTIMES	跳过.NET SDK 和 Python 安装。
--skip-node	-SkipNode	UIP_SKIP_NODE	Node.js 保持不变。
--skip-skills	-SkipSkills	UIP_SKIP_SKILLS	跳过 uip skills install。
--skip-dotnet	-SkipDotnet	UIP_SKIP_DOTNET	跳过.NET SDK 安装。
--skip-python	-SkipPython	UIP_SKIP_PYTHON	跳过 Python 安装。

# Preview first — prints what it would do, changes nothing
curl -fsSL https://download.uipath.com/uipath-cli/install.sh | bash -s -- --dry-run

# CLI + skills only, no .NET / Python
curl -fsSL https://download.uipath.com/uipath-cli/install.sh | bash -s -- --skip-runtimes

手动安装

如果您已自行管理节点，或者只需要 CLI 而不使用一行行的技能/.NET/Python 配置：

npm install -g @uipath/cli

或使用另一个包管理器：

pnpm add -g @uipath/cli

bun add -g @uipath/cli

备注：

三个包管理器均从公共 npm 注册表中安装相同的 @uipath/cli 包。使用您团队已有的服务。如果您的 .npmrc 将 @uipath 包命名空间的作用域限定为私有订阅源（GitHub Packages、 Artiworks 代理等），则该作用域将优先于默认注册表，您将获得该订阅源的内部版本，而不是公开的稳定版本。使用以下命令强制使用公共注册表进行此安装：

npm install -g @uipath/cli --@uipath:registry=https://registry.npmjs.org/

Homebrew (macOS/Linux)

UiPath 维护 Homebrew Tap。这是完全独立于上面的 one-Liner 和 npm/pnpm/bun 的安装路径 — Homebrew 本身管理 uip 二进制文件及其 Node.js 依赖项。

brew install uipath/tap/uip

或者先明确点击它：

brew tap uipath/tap
brew install uip

升级和卸载遵循正常的 Homebrew 约定：

brew upgrade uip
brew uninstall uip

备注：

通过 uip tools install <tool> 安装的工具会写入 npm 的全局前缀 (npm root -g)，而不是写入 Homebrew 的 C存储区 — 它们会在 brew upgrade uip 中持久存在。要完全删除所有内容：brew uninstall uip && rm -rf "$(npm root -g)/@uipath"。

安装程序会在您的PATH上放置uip可执行文件。在 Windows 中， uip.cmd / uip.ps1启动器位于%APPDATA%\npm\下；在 macOS 和 Linux 上， uip启动器（ node ./dist/index.js周围的小填充程序）位于npm config get prefix报告的前缀下（通常是/usr/local/bin或~/.npm-global/bin ）。

验证安装

uip --version

您应该会看到已安装的版本号（例如1.0.0 ）。

uip --help

您应该会看到核心命令列表： login （包含status 、 tenant list和tenant set子命令）、 logout 、 tools 、 skills 、 mcp 、 completion通过计算机上已安装或注册的工具。

要确认uip启动器及其工具所在的位置，请执行以下操作：

npm root -g              # directory holding @uipath/cli and installed tools
npm config get prefix    # parent directory whose bin/ folder holds the uip launcher

第一个命令

UiPath CLI 仅附带主机和一小部分核心命令。未预装任何工具。首次调用前缀与自动安装白名单上的工具匹配的命令时，主机会自动从 npm 下载并安装该工具。

例如，首次运行 Orchestrator 命令时， uip会安装@uipath/orchestrator-tool ：

uip or folders list

Installing @uipath/orchestrator-tool...
✓ Installed @uipath/orchestrator-tool
...

后续的uip or ...调用将直接使用已安装的工具。您还可以使用uip tools install显式安装工具：

uip tools install @uipath/orchestrator-tool
uip tools install @uipath/solution-tool

有关完整的白名单，请参阅“工具（插件）” ，有关日常工具管理的信息，请参阅“管理工具和技能” 。

控制工具自动安装

每当调用的动词位于白名单中且尚未安装工具时，自动安装都会运行。CI=true对其无效— 系统不会在自动安装路径中的任何位置查阅该变量。真实的选择退出参数为UIPATH_CLI_DISABLE_AUTOINSTALL=true ，该参数会完全关闭隐式工具安装，包括版本控制和稳定性中所述的每天每个工具的新鲜度检查。在无状态 CI 运行器上，如果不预安装或设置此变量，内部版本中的第一个命令将下载其工具，并且同一作业中的后续命令将重用已安装的副本，从而使第一个命令比后续命令慢。

为了保持 CI 构建时间的确定性，请作为单独步骤预安装您使用的工具，以便后续每次uip调用都会发现这些工具已经存在：

uip tools install @uipath/orchestrator-tool && uip tools install @uipath/solution-tool

当工具已安装时，自动安装不会执行任何操作，因此预安装步骤是您唯一需要更改的行为。在离线运行程序上，您希望硬保证没有任何内容会尝试在构建过程中到达 npm，请设置 UIPATH_CLI_DISABLE_AUTOINSTALL=true — 对尚不存在的工具执行的命令会立即失败，而不是尝试下载。

启用 shell 补全

UiPath CLI 附带了bash 、 zsh 、 Files和pwsh的 Tab 键补全。从 CLI 本身中安装补全：

uip completion

在终端中， uip completion会从$SHELL / $PSModulePath /平台检测您的 Shell，输出将要修改的目标 rc 文件，并要求您确认。接受提示并重新打开 Shell — uip <TAB>现在可以完成子命令和选项。

对于脚本化设置，请直接将补全脚本通过管道传输到 rc 文件中：

# zsh
uip completion zsh >> ~/.zshrc

# bash
uip completion bash >> ~/.bashrc

# fish
uip completion fish > ~/.config/fish/completions/uip.fish

# PowerShell
uip completion pwsh >> $PROFILE

其他选项：

• uip completion --print — 在不修改文件系统的情况下，预览目标路径和将要写入的块。
• uip completion --uninstall — 删除托管补全块。

备注：

动态标志值补全（例如uip or packages upload --package-name <TAB> ）仅适用于 zsh ，并且需要jq上的PATH实用程序。如果没有jq ，系统将压缩动态候选对象；静态子命令和选项名称完成仍然适用于所有四种 Shell。

警告：

每次升级 CLI 或工具后重新运行补全

补全脚本是运行uip completion时已知子命令和选项名称的静态快照。在npm install -g @uipath/cli@<new-version> 、 uip tools install <new-tool>或uip tools update之后，重新运行uip completion ，以便将新添加的命令和标志编入索引：

uip completion              # interactive — refreshes the existing block
uip completion zsh >> ~/.zshrc   # or pipe into the rc file directly

如果不刷新，新动词（例如，在工具次要版本中添加的动词）即使在命令行中工作，也将不会自动完成。

平台说明

Windows

从PowerShell 、 Windows 终端或cmd运行命令。如果在安装后无法识别uip ，请打开一个新的终端窗口，以便更新的PATH生效，或运行：

npm config get prefix

并确认返回的目录在您的PATH中。

macOS 和 Linux

大多数包管理器会将uip可执行文件放置在默认的PATH上。如果您将 npm 全局安装到用户本地目录中（按照建议 — 避免sudo ），请确保该目录位于您的PATH上。例如，使用~/.npm-global前缀：

export PATH="$HOME/.npm-global/bin:$PATH"

将此行添加到您的 Shell 配置文件（ ~/.zshrc 、 ~/.bashrc等）中，以将其保留。

位于公司代理后面

UiPath CLI 在 CLI 本身和工具自动安装中遵循标准 HTTP 代理环境变量：

变量	用途
HTTP_PROXY / http_proxy	用于 HTTP 请求的代理
HTTPS_PROXY / https_proxy	HTTPS 请求代理
NO_PROXY / no_proxy	绕过代理的主机的逗号分隔列表

示例:

# macOS / Linux
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1,.internal.corp
uip login

# Windows PowerShell
$env:HTTPS_PROXY = "http://proxy.example.com:8080"
$env:NO_PROXY = "localhost,127.0.0.1,.internal.corp"
uip login

:: Windows cmd
set HTTPS_PROXY=http://proxy.example.com:8080
set NO_PROXY=localhost,127.0.0.1,.internal.corp
uip login

通过在 URL 中包含凭据来支持代理进行基本身份验证： http://user:[e-mail]:8080 。

提示：

CLI 捆绑了代理感知fetch实现，因此无需在 Node.js 上进行额外配置即可实现HTTPS_PROXY / HTTP_PROXY

遥测

UiPath CLI sends anonymous usage telemetry to UiPath to help improve the product. No file contents or credentials are transmitted. For command arguments and options, telemetry records only that a value was supplied; the value itself is recorded only when it is a boolean flag, a number, or one of a fixed set of choices the command defines.

变量	行为
UIPATH_TELEMETRY_DISABLED	设置为1或true以选择退出。
UIPATH_AI_CONNECTION_STRING	覆盖 Application Insights 连接字符串 — 例如，将遥测路由到您自己的实例。

# Opt out for the current shell
export UIPATH_TELEMETRY_DISABLED=1

# Or just for one command
UIPATH_TELEMETRY_DISABLED=1 uip login

在 CI/CD 中安装

作为管道中的一个步骤安装 CLI。由于uip未预安装工具，因此可以让工具在首次使用时自动安装，或显式预安装——后者在无状态运行程序上速度更快，因为每个步骤下载一次工具，而非每个命令下载一次。

GitHub 操作

steps:
  - uses: actions/setup-node@v4
    with:
      node-version: '22'

  - name: Install UiPath CLI
    run: npm install -g @uipath/cli

  - name: Pre-install tools
    run: uip tools install @uipath/orchestrator-tool && uip tools install @uipath/solution-tool

  - name: Authenticate
    run: uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET
    env:
      UIPATH_CLIENT_ID: ${{ secrets.UIPATH_CLIENT_ID }}
      UIPATH_CLIENT_SECRET: ${{ secrets.UIPATH_CLIENT_SECRET }}

  - name: Run CLI commands
    run: uip or folders list --output json

Azure DevOps

steps:
  - task: NodeTool@0
    inputs:
      versionSpec: '22.x'
    displayName: 'Use Node.js 22'

  - script: npm install -g @uipath/cli
    displayName: 'Install UiPath CLI'

  - script: uip tools install @uipath/orchestrator-tool && uip tools install @uipath/solution-tool
    displayName: 'Pre-install UiPath CLI tools'

  - script: uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET
    displayName: 'Authenticate'
    env:
      UIPATH_CLIENT_ID: $(UIPATH_CLIENT_ID)
      UIPATH_CLIENT_SECRET: $(UIPATH_CLIENT_SECRET)

Jenkins （声明性管道）

stage('Install UiPath CLI') {
  steps {
    sh 'npm install -g @uipath/cli'
    sh 'uip tools install @uipath/orchestrator-tool && uip tools install @uipath/solution-tool'
  }
}

stage('Authenticate') {
  steps {
    withCredentials([
      string(credentialsId: 'UIPATH_CLIENT_ID', variable: 'UIPATH_CLIENT_ID'),
      string(credentialsId: 'UIPATH_CLIENT_SECRET', variable: 'UIPATH_CLIENT_SECRET')
    ]) {
      sh 'uip login --client-id env.UIPATH_CLIENT_ID --client-secret env.UIPATH_CLIENT_SECRET'
    }
  }
}

有关完整管道示例，包括“打包”、“发布”和“测试”阶段，请参阅CI/CD 秘钥。

提示：

在内部版本之间缓存 npm 全局目录，以避免在每次运行时重新安装@uipath/cli及其工具。在 GitHub Actions 上，使用actions/cache键入已固定的 CLI 版本。

从 GitHub npm 注册表安装

大多数用户不需要此部分 — 上面的单行代码和手动安装@uipath/cli以及公共 npm 注册表中的每个白名单工具。它适用于两种较小的情况，两种情况都由同一个GitHub npm 注册表( https://npm.pkg.github.com ) 提供服务：

• @uipath/skills的 Alpha/内部内部版本（ @uipath/skills@<version>-alpha.*等版本），当uip skills install需要比公共 npm 上的内部版本更新时，传递安装。
• 少数核心包（ cli 、 solution-tool 、 codedagent-tool 、 orchestrator-tool ）的预览/内部构建在 npm 公开发布之前已发布到 GitHub 包。

在 uip tools install（或 uip skills install）解决其中一个问题之前，将 npm 配置为通过 GitHub 注册表路由 @uipath 作用域。

使用以下内容创建（或更新） ~/.npmrc （用户级）或./.npmrc （项目级）：

@uipath:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GH_NPM_REGISTRY_TOKEN}

GH_NPM_REGISTRY_TOKEN 是至少具有 read:packages 作用域的 GitHub 个人访问令牌（传统），已授权在 UiPath 组织中进行 SSO。

export GH_NPM_REGISTRY_TOKEN=<your-pat>
npm install -g @uipath/cli

配置后， uip tools install和uip tools update会采用与选取公开包相同的方式选取 GitHub 注册的包。

备注：

这与 @uipath/rpa-tool 无关，其真实来源和分发位于单独的存储库 (UiPath/Studio) 中 — 此处描述的 GitHub npm 注册表仅包含上面列出的 alpha/预览版本。

以未全局安装的方式运行

对于临时使用或不希望全局安装的管道，您可以通过npx运行 CLI：

npx -y @uipath/cli <command>

例如：

npx -y @uipath/cli login
npx -y @uipath/cli or folders list

第一次调用将下载包；后续调用将重用 npm 缓存。

升级

备注：

CLI 会每天自动升级一次。每天第一个符合条件的uip命令会在配置的通道上检查是否有较新的版本（默认为stable — 请参阅uip config中的core.updateChannel ），如果存在，则进行安装，并在新版本上重新执行原始命令版本。它会检测您安装 uip 的方式（Homebrew keg、npm、pnpm 或 Bun global），并自动调度匹配的升级命令 — 对于 Homebrew 安装为 brew upgrade uip，否则调度等效的 add/install 命令。此自更新永远不会自行跨越到新的“主要”版本 — 这始终需要显式 uip update 或版本 PIN 码。每天都会在每个工具首次使用该工具时运行单独的检查，并在 CLI 自己的行中将其刷新为最新版本。通过设置 UIPATH_CLI_DISABLE_VERSION_SYNC=true 可以完全禁用这两项检查 — 对于需要完全确定性、独立于网络的 uip 调用的离线运行器或管道非常有用。

以下手动命令在任何时候仍然有效：可以立即跳转到特定版本、固定或禁用每日同步。使用与您的 uip 安装方式匹配的变量：

# npm
npm install -g @uipath/cli@latest    # latest release
npm install -g @uipath/cli@1.0.0     # pinned version

# pnpm
pnpm add -g @uipath/cli@latest

# bun
bun add -g @uipath/cli@latest

# Homebrew
brew upgrade uip

Homebrew 始终会升级到点击当前发布的任何版本 — 固定确切版本不是 Homebrew 的概念，因此，如果您需要固定，请使用其他方法之一。

提示：

在 CI 中固定确切版本。 @uipath/cli遵循语义版本控制，但 JSON 输出中Data的形式特定于命令，并且可能在次要版本之间发生变化（请参阅版本控制和稳定性）。“固定”可以避免解析 JSON 的管道在构建时出现意外。冲突时，请重新验证依赖特定字段名称的脚本。

有关版本之间的更改，请参阅发行说明。

升级主机不会自动升级已安装的工具。要更新工具：

uip tools update                        # update all installed tools
uip tools update --name <package>       # update a single tool
uip tools update --name <package> --version <version>   # pin to a specific version

默认情况下，每个工具版本都会跟踪 CLI 的 MAJOR.MINOR 行，因此在 CLI 升级后运行uip tools update可使每个已安装的工具保持一致。有关固定合同，请参阅工具（插件） 。

卸载

使用用于安装 CLI 的方法删除 CLI：

npm uninstall -g @uipath/cli
# or
pnpm remove -g @uipath/cli
# or
bun remove -g @uipath/cli
# or, if installed via Homebrew
brew uninstall uip

这将删除 uip 可执行文件。无论使用哪种方法安装主机，已安装的工具（@uipath/orchestrator-tool 等）都存储在 npm 的全局前缀中，并且不会自动删除 — 请先运行 uip tools uninstall <tool>，或者在之后删除 $(npm root -g)/@uipath 以一次清除所有内容。

移除凭据和数据

卸载包会留下一些磁盘状态。当您想要重新开始或需要停用计算机时，请手动清理它们。

会话凭据

默认情况下， uip login会将会话保留在主目录的~/.uipath/中。当 CLI 启动时，它会首先从当前目录开始查找.uipath/文件夹，因此项目文件夹可以在无需修改用户主目录的情况下进行会话。清理时检查这两个位置：

# macOS / Linux
rm -rf ~/.uipath

# Windows PowerShell
Remove-Item -Recurse -Force "$env:USERPROFILE\.uipath"

还要查看您在本地.uipath/工作过的每个项目。有关完整布局，请参阅会话和凭据。

Shell 补全

如果您运行的是uip completion ，则卸载后，补全块仍位于 shell rc 文件中。在卸载@uipath/cli之前将其删除，或使用~/.zshrc 、 ~/.bashrc或$PROFILE手动将其清理：

# Before uninstalling, while uip is still available:
uip completion --uninstall

npm 全局缓存

npm 在npm config get cache报告的路径上保留下载的 tarball 的本地缓存。对于大多数用户而言，无需清理此内容；仅出于恢复磁盘空间或对下载损坏的故障进行故障排除的目的而清理：

npm cache clean --force

故障排除

uip：安装后未找到命令

npm 全局目录不在您的PATH上。运行npm config get prefix以查看 npm 将uip启动器放置的位置，然后将该目录的bin子文件夹添加到PATH并打开一个新终端。

EACCES 或安装时出现权限错误

在 macOS 和 Linux 上，避免sudo npm install 。将 npm 配置为使用用户本地前缀一次：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"

然后重新安装： npm install -g @uipath/cli 。

工具自动安装挂起或超时

您使用的代理可能会阻止 npm。按照在公司代理后面所述配置HTTPS_PROXY ，或在可以访问互联网的计算机上预安装工具，并将全局node_modules复制到目标计算机。

节点版本过旧

uip 需要 Node.js 22 或更高版本。升级 Node.js 或使用 nvm use 22 切换版本。

有关更多错误及其解决方案，请参阅故障排除。

后续步骤

• 快速入门— 登录、列出 Orchestrator 文件夹并在五分钟内运行作业。
• 您的第一个管道— 打包项目并从 CI 进行部署。
• 身份验证— 适用于 CI 的交互式登录、外部应用程序客户端凭据、联合/工作负载身份和环境变量身份验证。
• 将 UiPath CLI 与编码智能体结合使用— 将技能安装到 Claude Code、Cursor、GitHub Copilot 和其他受支持的 AI 编码智能体中。