- 入门指南
- 了解 UiPath Robot
- 安装要求
- 为 Unattended 自动化任务安装机器人
- 为 Unattended 自动化配置机器人
- 为 Attended 自动化安装机器人
- 为 Attended 自动化配置机器人
- 集成
- 监管
- 故障排除

机器人管理员指南
UiPath 提供 Windows 的两套安装程序。您可以从 UiPath Automation Cloud 中的资源中心或客户门户中的“产品下载”版块下载这些程序。
- 
                     在 2021.4 版发布之前,Studio 和机器人是 32 位应用程序。但是,从 2021.4 版开始,默认为 64 位安装程序。 
- 
                     从 2023.4 版开始, 不再提供 32 位安装程序,从 2021.4 版开始停止UiPathPlatformInstaller.exe。
- 
                     如要在 64 位操作系统上更新现有的 32 位或 64 位UiPathStudio.msi和UiPathPlatformInstaller.exe安装的程序,请使用UiPathStudio.msi。
- 
                     2021.4 之前的默认安装路径, 在 64 位系统上安装 32 位C:\Program Files (x86)\UiPath\Studio。 升级到 64 位安装程序会将安装的程序迁移到C:\Program Files\UiPath\Studio文件夹中。 使用自定义路径安装的程序在更新后不会更改其目录。
您可以通过在安装向导中选择“快速”选项(不需要管理员权限),以默认配置为当前用户执行安装,也可以通过选择“自定义”选项来配置安装(每台计算机安装需要管理员权限)。
如果您使用的是 Microsoft Windows Server,则每用户安装可能无法成功完成。如果发生错误,提示已设置策略来阻止安装,若您是计算机的管理员,则可以执行以下任一操作:
- 打开注册表编辑器,然后在注册表键 HKLM\Software\Policies\Microsoft\Windows\Installer中配置策略DisableMSI = 0,为所有应用程序启用 Windows 安装程序。
- 通过使用“自定义”选项进行安装,以按照计算机执行安装。
| 快速入门 | 自定义 | |
|---|---|---|
| 安装上下文 | 按用户 | 按用户或计算机 | 
| 支持的机器人安装类型 | 用户模式 | 
 | 
| 安装所需的管理员权限 | 否 | 仅对于每台计算机安装是必需的。 | 
| 安装目录 | %LocalAppData%\Programs | 可以选择自定义位置。默认位置为: 
 | 
| 使用社区版许可激活 | 支持 | 支持 | 
| 使用企业版许可激活 | 支持 | 支持 | 
| 需要管理员权限 用于连接到 Orchestrator | 否 | 仅服务模式机器人需要 | 
| 使用交互式登录连接到 Orchestrator。 | 支持 | 支持  1 | 
| 使用计算机密钥连接到 Orchestrator | 支持 | 支持 | 
| 无人值守执行,无需用户登录 | 不支持 | 仅支持服务模式机器人 | 
1 - 对于服务模式机器人,您必须首先使用客户端凭据连接到 Orchestrator,然后才能使用交互式登录来更改连接到 Orchestrator 的用户。
               UiPathStudio.msi 是主要针对开发者的 Windows 安装程序。 安装后,软件包包括开发环境 (UiPath Studio)、UiPath Robot 和 UiPath Assistant,以执行已开发的工作流。
               如果您希望在同一台计算机上构建、调试和测试自动化任务,那么请使用此安装程序。
可用的安装选项
- 
                        快速安装 - 在%localappdata%\Programs\UiPath目录中安装默认配置。默认配置包括:- 
                              Studio、StudioX 和 Assistant 
- 
                              用户模式机器人 
- 
                              StudioX Excel 加载项(如果您的计算机上已经安装了 Microsoft Excel) 
- 
                              Chrome 扩展程序(如果您的计算机上安装了 Google Chrome) 
- 
                              Edge Chromium 扩展程序(如果您的计算机上已经安装了 Microsoft Edge Chromium) 
- 
                              JavaScript Robot 附加项 
- 
                              Microsoft 远程桌面扩展程序 
 
- 
                              
- 
                        自定义安装 - 允许您选择要安装的组件,并配置高级设置。安装路径%LocalAppData%\Programs适用于当前用户安装,%ProgramFiles%适用于设备上所有用户的安装。
自定义安装 - 可用选项
- 
                        仅为我安装 - 在用户配置文件夹中安装自定义配置。无需管理员权限。 
- 
                        为此计算机上的所有用户安装 - 为计算机上的所有用户安装自定义配置。需要管理员权限。 
仅为我安装 - 可用的安装包
- 
                        自动化开发者 - 安装以下配置,用于运行 Attended 自动化: - 
                                 Studio、StudioX 和 Assistant 
- 
                                 用户模式机器人 
 
- 
                                 
- 
                        Attended 机器人 - 安装以下配置,用于运行 Attended 自动化任务,并随 Windows 自动启动 Assistant。 - 
                                 Assistant 
- 
                                 用户模式机器人 
 
- 
                                 
当您选择某选项时,高级设置配置将变为可用,其中包含以下选项:
| 高级设置 | 描述 | 
|---|---|
| 安装包 | 
 | 
| 扩展程序 > 工具 | 
 | 
| 扩展程序 > 包配置 | 
 | 
| 安全性 | 
 | 
为此计算机上的所有用户安装 - 可用的安装包
- 
                           自动化开发者 - 安装以下配置,用于运行 Attended 自动化: - 
                                    Studio、StudioX 和 Assistant 
- 
                                    用户模式机器人 
 
- 
                                    
- 
                           Attended 机器人 - 安装以下配置,用于运行 Attended 自动化任务,并随 Windows 自动启动 Assistant。 - 
                                    Assistant 
- 
                                    用户模式机器人 
 当您选择某选项时,高级设置配置可用。高级设置 描述 安装包 - 
                                                   安装路径 - 所安装程序的目标文件夹。默认路径为%ProgramFiles%。
- 
                                                   许可证代码(可选) - 您的独立试用或企业许可证的密钥。 在独立试用设置期间,如无密钥,Studio 会在首次启动时提示输入密钥。 
- 
                                                   Orchestrator URL - 要使用交互式登录连接的 Orchestrator 实例的 URL。 此值保存在uipath.config文件中。
- 
                                                   自动登录 - 当您的环境配置为将 SSO 与 Azure Active Directory 一起使用时,您可以为您的账户启用自动身份验证。 
- 
                                                   随 Windows 自动启动 Assistant - 在 Windows 启动时启动 Assistant。 
 扩展程序 > 工具 - 
                                                   StudioX Excel 加载项 
- 
                                                   UiPath Java 扩展程序 
- 
                                                   UiPath JavaScript 机器人插件 
- 
                                                   UiPath Citrix 扩展程序 
- 
                                                   UiPath Chrome 扩展程序 
- 
                                                   Edge Chromium 的 UiPath 扩展程序 
- 
                                                   Firefox 版 UiPath 扩展程序 
- 
                                                   Microsoft Remote Desktop 的 UiPath 扩展程序 
- 
                                                   适用于 VMware 的 UiPath 扩展程序 
- 
                                                   SAP 解决方案管理器 - 如果您的计算机上已经安装了适用于 Microsoft 的 SAP 连接器,则可使用此功能。如果选中,那么您需要在“主机”框中提供 SAP 解决方案管理器实例的主机名或 IP 地址。 
 扩展程序 > 默认下载位置 活动包的下载位置。 默认位置为%userprofile%.nuget\packages。扩展程序 > 包配置 - 
                                                   禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。 
 安全性 - 
                                                   强制签名执行 - 指示机器人仅执行已签名的包。 
- 
                                                   禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。 
- 
                                                   禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。 
 
- 
                                    
- 
                        Unattended 机器人 - 安装以下配置,以运行 Unattended 自动化 - 
                                 Assistant 
- 
                                 服务模式下的机器人 
 高级设置 描述 安装包 - 
                                                许可证代码(可选) - 您的独立试用或企业许可证的密钥。 在独立试用设置期间,如无密钥,Studio 会在首次启动时提示输入密钥。 
- 
                                                Orchestrator URL - 要使用交互式登录连接的 Orchestrator 实例的 URL。 此值保存在uipath.config文件中。
- 
                                                客户端 ID 和客户端密码 - 来自计算机模型对象的客户端凭据。这一对生成令牌,允许 Unattended 机器人访问 Orchestrator 资源。 
- 
                                                安装 UiPath Studio - 如选中,安装用于设计的 Studio。 
 扩展程序 > 工具 - 
                                                StudioX Excel 加载项 
- 
                                                UiPath Java 扩展程序 
- 
                                                UiPath JavaScript 机器人插件 
- 
                                                UiPath Citrix 扩展程序 
- 
                                                适用于 Chrome 的 UiPath 扩展程序 (*) 
- 
                                                适用于 Edge Chromium 的 UiPath 扩展程序 (*) 
- 
                                                Firefox 版 UiPath 扩展程序 
- 
                                                Microsoft Remote Desktop 的 UiPath 扩展程序 
- 
                                                适用于 VMware 的 UiPath 扩展程序 
- 
                                                SAP 解决方案管理器 - 如果您的计算机上已经安装了适用于 Microsoft 的 SAP 连接器,则可使用此功能。如果选中,那么您需要在“主机”框中提供 SAP 解决方案管理器实例的主机名或 IP 地址。 
 (*) 这些选项默认处于选中状态。 扩展程序 > 默认下载位置 活动包的下载位置。 默认位置为%userprofile%.nuget\packages。扩展程序 > 包配置 - 
                                                禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。 
 安全性 - 
                                                强制签名执行 - 指示机器人仅执行已签名的包。 
- 
                                                禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。 
- 
                                                禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。 
 
- 
                                 
UiPathRobot.msi 通常安装在主要执行自动化任务的 Windows 计算机上。 此安装不附加任何开发环境,因此资源分配主要用于运行机器人。 它包括 UiPath 机器人和 UiPath Assistant。
               可用的安装选项
- 
                        快速安装 - 在%localappdata%\Programs\UiPath目录中安装默认配置。默认配置包括:- 
                              Studio、StudioX 和 Assistant 
- 
                              用户模式机器人 
- 
                              StudioX Excel 加载项(如果您的计算机上已经安装了 Microsoft Excel) 
- 
                              Chrome 扩展程序(如果您的计算机上安装了 Google Chrome) 
- 
                              Edge Chromium 扩展程序(如果您的计算机上已经安装了 Microsoft Edge Chromium) 
- 
                              JavaScript Robot 附加项 
- 
                              Microsoft 远程桌面扩展程序 
 
- 
                              
- 
                        自定义安装 - 允许您选择要安装的组件,并配置高级设置。安装路径%LocalAppData%\Programs适用于当前用户安装,%ProgramFiles%适用于设备上所有用户的安装。
自定义 - 可用的安装包
- 
                           仅为我安装:Attended - 安装 Robot 和 Assistant 以运行 Attended 自动化。 - 
                                 您的自定义配置将应用于当前的用户配置文件。 
- 
                                 机器人安装在用户模式下。 
- 
                                 无需管理员权限。 
 选择此选项时,高级设置配置变为可用。高级设置 描述 安装包 - 
                                                   Orchestrator URL - 使用交互式登录连接上的 Orchestrator 实例的 URL。此值保存在 uipath.config 文件中。 
- 
                                                   自动登录 - 当您的环境配置为将 SSO 与 Azure Active Directory 一起使用时,您可以为您的账户启用自动身份验证。 
 扩展程序 > 工具 - 
                                                   UiPath JavaScript 机器人插件 (*) 
- 
                                                   适用于 Chrome 的 UiPath 扩展程序 (*) 
- 
                                                   适用于 Edge Chromium 的 UiPath 扩展程序 (*) 
- 
                                                   Firefox 版 UiPath 扩展程序 
- 
                                                   Microsoft Remote Desktop 的 UiPath 扩展程序 
 (*) 这些选项默认处于选中状态。 扩展程序 > 包配置 - 
                                                   禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。 
 安全性 - 
                                                   强制签名执行 - 指示机器人仅执行已签名的包。 
- 
                                                   禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。 
- 
                                                   禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。 
 
- 
                                 
- 
                           为所有用户安装:Attended - 安装 Robot 和 Assistant 以运行 Attended 自动化。 - 
                                 您的自定义配置将应用于计算机上的所有用户。 
- 
                                 机器人安装在用户模式下。 
- 
                                 需要管理员权限。 
- 
                                 随 Windows 自动启动 Assistant。 
 选择此选项时,高级设置配置变为可用。高级设置 描述 安装包 - 
                                                   安装路径 - 所安装程序的目标文件夹。默认路径为%ProgramFiles%。
- 
                                                   许可证代码(可选) - 您的独立试用或企业许可证的密钥。 在独立试用设置期间,如无密钥,Studio 会在首次启动时提示输入密钥。 
- 
                                                   Orchestrator URL - 要使用交互式登录连接的 Orchestrator 实例的 URL。 此值保存在uipath.config文件中。
- 
                                                   自动登录 - 当您的环境配置为将 SSO 与 Azure Active Directory 一起使用时,您可以为您的账户启用自动身份验证。 
- 
                                                   随 Windows 自动启动 Assistant - 在 Windows 启动时启动 Assistant。 
 扩展程序 > 工具 - 
                                                   UiPath Java 扩展程序 
- 
                                                   UiPath JavaScript 机器人插件 (*) 
- 
                                                   UiPath Citrix 扩展程序 
- 
                                                   适用于 Chrome 的 UiPath 扩展程序 (*) 
- 
                                                   适用于 Edge Chromium 的 UiPath 扩展程序 (*) 
- 
                                                   Firefox 版 UiPath 扩展程序 
- 
                                                   Microsoft Remote Desktop 的 UiPath 扩展程序 
- 
                                                   适用于 VMware 的 UiPath 扩展程序 
 (*) 这些选项默认处于选中状态。 扩展程序 > 默认下载位置 活动包的下载位置。 默认位置为%userprofile%.nuget\packages。扩展程序 > 包配置 - 
                                                   禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。 
 安全性 - 
                                                   强制签名执行 - 指示机器人仅执行已签名的包。 
- 
                                                   禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。 
- 
                                                   禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。 
 
- 
                                 
- 
                        为所有用户安装: Unattended - 安装机器人以通过 Orchestrator 运行 Unattended 自动化任务,并安装 Assistant 以解决问题。 - 
                              您的自定义配置将应用于计算机上的所有用户。 
- 
                              机器人安装在服务模式下。 
- 
                              需要管理员权限。 
 选择此选项时,高级设置配置变为可用。高级设置 描述 安装包 - 
                                                安装路径 - 所安装程序的目标文件夹。默认路径为%ProgramFiles%。
- 
                                                许可证代码(可选) - 您的独立试用或企业许可证的密钥。 在独立试用设置期间,如无密钥,Studio 会在首次启动时提示输入密钥。 
- 
                                                Orchestrator URL - 要使用交互式登录连接的 Orchestrator 实例的 URL。 此值保存在uipath.config文件中。
- 
                                                客户端 ID 和客户端密码 - 来自计算机模型对象的客户端凭据。这一对生成令牌,允许 Unattended 机器人访问 Orchestrator 资源。 
 扩展程序 > 工具 - 
                                                UiPath Java 扩展程序 
- 
                                                UiPath JavaScript 机器人插件 
- 
                                                UiPath Citrix 扩展程序 
- 
                                                适用于 Chrome 的 UiPath 扩展程序 (*) 
- 
                                                适用于 Edge Chromium 的 UiPath 扩展程序 (*) 
- 
                                                Firefox 版 UiPath 扩展程序 
- 
                                                Microsoft Remote Desktop 的 UiPath 扩展程序 
- 
                                                适用于 VMware 的 UiPath 扩展程序 
 (*) 这些选项默认处于选中状态。 扩展程序 > 默认下载位置 活动包的下载位置。 默认位置为%userprofile%.nuget\packages。扩展程序 > 包配置 - 
                                                禁用在线订阅源 - (可选择)禁用用于活动包的官方和 Marketplace 在线订阅源。建议用于离线环境。 
 安全性 - 
                                                强制签名执行 - 指示机器人仅执行已签名的包。 
- 
                                                禁用受保护的 XAML 文件 - 对于作为 Windows 服务安装的机器人,禁用 XAML 文件的安全保护。未受保护的 XAML 文件允许用户阅读和修改流程文件和逻辑。 
- 
                                                禁用遥测 - 禁止收集 Studio 和机器人的匿名使用数据。 
 
- 
                              
使用命令行参数安装机器人或 Studio 对于多台计算机上的安装、静默安装以及节省图形向导可能消耗的系统资源非常有用。它还允许自定义安装设置并与脚本集成。
如要使用命令提示符安装机器人,您需要管理员权限。
最佳实践
- 
                        如要转义系统变量名称中的 "%" 字符,如 %username%,请使用以下命令: ^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%^ - UiPathRobot.msi PACKAGES_FOLDER=C:\Some\Path\^%USERNAME^%备注:在 PowerShell 中,不需要转义。 
- 
                        使用 Active Directory 域账户时,请在文件夹结构中指定域名: C:\packages\^%UserDomain^%.^%Username^%C:\packages\^%UserDomain^%.^%Username^%
- 
                        如要使用包含空格的路径,请使用引号: - 
                              在命令提示符中,使用双引号: UiPathRobot.msi APPLICATIONFOLDER="C:\folder name"UiPathRobot.msi APPLICATIONFOLDER="C:\folder name"
- 
                              在 PowerShell 中,使用单引号和双引号: ./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'./UiPathRobot.msi APPLICATIONFOLDER='"C:\folder name"'
 
- 
                              
清洁安装 - 命令行参数
UiPathStudio.msi或UiPathRobot.msi时,可使用这些参数。
                     
                     | 命令 | 描述 | 
|---|---|
| 
 | 
 | 
| 
 | 
 | 
| 
 | 
 | 
| 
 | 
 以下选项在按用户安装中不可用:RegisterService、CitrixExtension、VMwareExtension、PACKAGES_FOLDER、CODE。 | 
| SAP_SOL_MAN_HOST(仅限UiPathStudio.msi) | 
 | 
| 
 | 
 | 
| 
 | 
 备注: 
                                        URL 订阅源仍保留在配置文件中,但会被忽略。 | 
| 
 | 
 注意:确保需要执行流程的所有用户均具有新文件夹的读取权限。
                                     
 | 
| 
 | 
 | 
| 
 | 
 | 
| 
 | 
 | 
| CLIENT_ID和CLIENT_SECRET | 
 | 
| 
 | 
 注意:旧的安装方法名称( STORE和GLOBAL)会保留下来,以保持向后兼容性。 | 
| 
 | 
 注意:旧的安装方法名称( STORE和GLOBAL)会保留下来,以保持向后兼容性。 | 
| 
 | 
 | 
| 
 | 
 | 
| 
 | 
 | 
| 
 | 
 | 
| 
 | 
 | 
| 
 | 
 | 
| ASSISTANT_OPTIONS | 
 | 
| ORCHESTRATOR_AUTO_SIGNIN | 
 | 
| ENFORCE_DEFAULT_SERVICE_URL | 
 | 
| PROXY_SCRIPT_ADDRESS | 决定如何以及何时使用代理的脚本的地址。 应包含脚本文件的 URI,例如 http://localhost/proxy.pac。备注: 
                                           
 | 
| 
 需与以下内容一起使用: 
 或使用以下内容: 
 | 代理服务器的地址(IP 或域名)。例如, http://my.proxy.net:8008。 | 
| 
 需与以下内容一起使用: 
 | 允许绕过代理服务器直接连接本地地址。 如果绕过本地地址,则将其设置为 1,否则设置为 0。 | 
| 
 需与以下内容一起使用: 
 | 绕过代理服务器直接连接到互联网的地址列表。应包含正则表达式字符串,而这些字符串包含要绕过的服务器 URI。例如,“server.domain.local$;www.google.com;192.168.\d{1,3}.\d{1,3}”。 | 
| 
 需要  PROXY_PASSWORD。 | 用于代理服务器身份验证的用户名凭据。 | 
| 
 | 与用于代理服务器身份验证的用户名关联的密码。 | 
| 
 | 代理服务器所在的域,用于身份验证。 | 
更新或修改现有安装 - 命令行参数
UiPathStudio.msi时,可使用这些参数。
                     
                     | 命令 | 描述 | 
|---|---|
| 
 不支持更改现有安装。 | 
 | 
| 
 | 
 | 
| 
 | 
 | 
| 
 不支持更改现有安装。 | 
 备注: 
                                        URL 订阅源仍保留在配置文件中,但会被忽略。 | 
| 
 不支持更改现有安装。 | 
 | 
| 
 | 
 | 
| 
 不支持更改现有安装。 | 
 | 
| ASSISTANT_OPTIONS | 
 | 
| 
 不支持更改现有安装。 | 
 | 
ADDLOCAL参数。 如果您选择在命令提示符中使用ADDLOCAL参数,那么您必须添加LiveStreaming标志。
               UiPathRobot.msi命令执行自定义安装或升级操作,该操作还安装实时流式传输所需的软件 RealVNC:
               UiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,LiveStreamingUiPathRobot.msi ADDLOCAL=DesktopFeature,Robot,RegisterService,LiveStreaming在早于 2024.10.5 的机器人版本中,实时流式传输和远程控制功能在代理设置状态下无法使用。将您的机器人升级到 2024.10.5 以上版本,以在代理设置状态下使用这些功能。