robot

latest

false

重要 :

新发布内容的本地化可能需要 1-2 周的时间才能完成。

机器人管理员指南

上次更新日期 2026年4月17日

配置文件

重新启动机器人组件

编辑配置文件后，您需要重新启动相关机器人组件，以使更改生效。以下列表总结如何根据 Robot 的安装模式重新启动多个组件。

请记得在重新启动之前保存任何正在进行的工作，避免丢失任何未保存的进度。

机器人服务
- 服务模式安装
  1. 打开“任务管理器”>“服务”。
  2. 查找 UiPathRobotSvc 服务。
  3. 右键单击该服务，然后选择“重新启动”。
- 用户模式安装 - 退出，然后重新启动 Assistant，或：
  1. 打开“任务管理器”>“详细信息”。
  2. 选择 UiPath.Service.UserHost.exe 流程。
  3. 选择结束任务。
更新服务
1. 打开“任务管理器”>“服务”。
2. 查找 UiPath.UpdateService.Agent 服务。
3. 右键单击该服务，然后选择“重新启动”。
UiPath RobotJS 服务主机
1. 打开“任务管理器”>“服务”。
2. 查找 UiPath.RobotJS.ServiceHost 服务。
3. 右键单击该服务，然后选择“重新启动”。
UiPath Assistant
1. 在 Assistant 中，选择“首选项”，然后选择“退出”。
2. 重新启动 Assistant。
小组件 - 重新启动 Assistant，或：
1. 右键单击任务栏中的 Assistant 图标。
2. 选择“重新加载小组件”

uipath.config

UiPath.config 文件包含机器人的基本配置参数。作为管理员，您可以通过编辑配置文件中的参数列表来自定义机器人的行为。

备注：

每个环境可能都需要特定的通知，因此 UiPath 可让您根据机器人的当前环境（无论是开发、临时环境还是生产环境）应用不同的配置。编辑此文件时请务必小心，因为配置不正确可能会导致应用程序出现问题。

重要提示：

Starting with Robot 2025.10, proxy settings are configured in proxy.json, not in UiPath.config. For details, see proxy.json.

访问文件

安装机器人时，系统会创建 UiPath.config 文件。

要访问它，请导航到 C:\Program Files\UiPath\Studio\UiPath.config。

可自定义的设置

UiPath.config 文件包含以下参数：

在 connectionSettingsconfig 部分中，
- DefaultServiceUrl （字符串） - 设置机器人用于连接到 Orchestrator 的默认地址。
  
  示例：
  string DefaultServiceUrl = "https://cloud.uipath.com"string DefaultServiceUrl = "https://cloud.uipath.com"
- AutoSignIn （布尔值） - 启用 Assistant 的自动登录功能。默认值为 false。
  
  示例：
  bool AutoSignIn = true.bool AutoSignIn = true.
- EnforceDefaultServiceUrl（布尔值） - 将提供的地址 DefaultServiceUrl 强制用于所有用户。默认值为 false。
  
  示例：
  bool EnforceDefaultServiceUrl = true.bool EnforceDefaultServiceUrl = true.
在 communicationSettingsconfig 部分中，
- MaxMessageSizeInMegabytes （字节） - 设置系统可发送或接收的消息的上限（以 MB 为单位）。默认值为 10。
  
  这用于防止由于处理太大的消息而导致的超载或流程崩溃。
  
  示例：
  byte MaxMessageSizeInMegabytes = 10;byte MaxMessageSizeInMegabytes = 10;
- InstallPackageTimeout （时间跨度） - 设置包安装的时间限制。默认值为 20 分钟。
  
  如果包的安装时间超过定义的时间，系统将中止安装。
  
  示例：
  TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);TimeSpan InstallPackageTimeout = TimeSpan.FromMinutes(20);
- RequestTimeout（时间跨度） - 设定系统等待通信响应的时长。默认值为 40 秒。
  
  如果系统在设置的时段内未收到响应，它会停止等待并继续执行后续流程。这样可以防止系统卡住。
  
  示例：
  TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);TimeSpan RequestTimeout = TimeSpan.FromSeconds(40);
在 packageSettingsconfig 部分中，
- PackagesInstallationFolder(string) - 设置安装包的默认目录。默认值为 C:\UiPath\Packages。
- SkipHttpConfigurationSources （布尔值） - 允许系统忽略通过 HTTP 配置的包来源，例如 NuGet 订阅源。默认值为 false。
  
  这意味着系统不会从这些来源检索包，这在来源不可靠或不安全时非常有用。
- DisableSecureXaml （布尔值） - 允许机器人运行可能不安全的工作流。默认值为 false。
- DirectDownload （布尔值） - 允许直接下载包，而不向用户提示。默认值为 false。
- PackageSaveWithoutNupkg （布尔值） - 允许保存不带 .nupkg 文件的包。默认值为 false。
  
  这有助于减小下载大小。
在 analyticsSettingsconfig 部分中，
- Telemetry.Enabled （布尔值） - 允许 UiPath 收集和发送使用情况数据供分析。默认值为 false。
在 robotCacheSettingsconfig 部分中，
- SessionCacheDuration （时间跨度） - 规定丢弃特定会话中的数据之前应在缓存中保留的时长。默认值为 30 秒。
  
  这对于重用数据（例如变量值或操作详细信息）非常有用，而不是重新创建或重新获取数据。
  
  示例：
  TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);TimeSpan SessionCacheDuration = TimeSpan.FromSeconds(30);
- GetResourceUrlCacheDuration （时间跨度） - 规定 API 或网页等资源的 URL 在缓存中存储的时长。默认值为一 (1) 小时。
  
  在机器人需要定期访问某些资源的情况下，这对于优化性能非常有用。
  
  示例：
  TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);TimeSpan GetResourceUrlCacheDuration = TimeSpan.FromHours(1);
在 robotJsSettingsconfig 部分中，
- ListenerPort (int) - 设置 Robot.js 侦听传入的连接时使用的端口号。默认值为 2323。
  
  这可让机器人服务与在本地或远程服务器上运行的网页应用程序交互。
  
  示例：
  int ListenerPort = 2323;int ListenerPort = 2323;
- TokenExpiryInDays (int) - 设置 UiPath 机器人服务生成的身份验证令牌的有效期（以天为单位）。默认值为 30 天。
  
  机器人服务在与其他软件组件或服务交互时使用这些令牌对自身进行身份验证。
  
  示例：
  int TokenExpiryInDays = 30;int TokenExpiryInDays = 30;
- AllowUrlList(string) - 设置 UiPath 机器人服务可以访问的 URL 的列表。这有助于确保您的 UiPath 机器人服务仅与已批准的服务交互。
  
  示例：
  string AllowUrlList = "https://cloud.uipath.com";string AllowUrlList = "https://cloud.uipath.com";

重要提示：

在进行任何更改之前，请始终创建原始 UiPath.config 文件的备份。如果出现问题，这有助于恢复原始设置。
如要应用对 UiPath.config 文件进行的更新，请重新启动 UiPath 服务或系统。
UiPath.config 文件中的本地设置优先于在 Orchestrator 中配置的设置。
为了提高安全性，可以加密 UiPath.config 文件中的敏感数据。

UiPath Robot 系统变量

可以通过系统环境变量配置进一步的自定义行为。

重要提示：

修改任意系统变量后，请重新启动机器人服务。

以下列表总结了最常见的用例：

UIPATH_SESSION_TIMEOUT - 更改创建交互式会话的默认 60 秒超时时间。根据与机器人交互的系统的性能和加载时间调整此值，以调整机器人的行为。

示例：
```
UIPATH_SESSION_TIMEOUT=75
UIPATH_SESSION_TIMEOUT=75
```
UIPATH_PIP_SESSION_TIMEOUT - 更改在机器人会话中启动流程的默认 180 秒超时时间。

示例：
```
UIPATH_PIP_SESSION_TIMEOUT=60
UIPATH_PIP_SESSION_TIMEOUT=60
```
UIPATH_LANGUAGE - 设置机器人运行时使用的语言。优先级为:
1. UIPATH_LANGUAGE 值
2. 计算机环境变量
3. 当前线程用户界面区域性
4. 默认 UiPath 语言（英语）
示例：
```
UIPATH_LANGUAGE=French
UIPATH_LANGUAGE=French
```
UIPATH_HEADLESS_WITH_USER - 使用先前在 Orchestrator 中配置的特定用户的凭据。

示例：
```
UIPATH_HEADLESS_WITH_USER=True
UIPATH_HEADLESS_WITH_USER=True
```
UIPATH_PRE_LOADED_EXECUTOR - 默认情况下，预加载的执行程序在机器人启动时启动。要更改此行为并仅在第一个流程运行时启动预加载的执行程序，请将此变量设置为 None。

示例：
```
UIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_PRE_LOADED_EXECUTOR=None
```
UIPATH_DISABLE_PRE_LOADED_EXECUTOR - 禁用预加载执行程序功能。

示例：
```
UIPATH_PRE_LOADED_EXECUTOR=None
UIPATH_PRE_LOADED_EXECUTOR=None
```
UIPATH_ROBOTJS_ALLOWLIST - 在机器人 JS SDK 和机器人执行程序之间建立连接时，自动接受机器人同意对话框。

该变量接受用分号分隔的自定义应用程序 URL。如果端口号与标准端口（80 或 443）不同，请在 URL 中包含该端口号。

示例：
```
UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
UIPATH_ROBOTJS_ALLOWLIST=cloud.uipath.com;mydomain.com;
```
UIPATH_DNS_MACHINENAME - 允许在创建 RDP 会话时使用“本地主机” (Localhost) 的 DNS 主机名。要在对 RDP 使用 Kerberos 身份验证的环境中执行 Unattended 作业，请将此值设置为 True。

示例：
```
UIPATH_DNS_MACHINENAME=True
UIPATH_DNS_MACHINENAME=True
```
NUGET_FALLBACK_PACKAGES - 配置备用包文件夹的路径。使用分号分隔多个路径。

如果没有此变量，机器人会在 Nuget.config 文件中搜索回退包文件夹。
NUGET_SCRATCH - 允许同一台计算机上的多个用户模式机器人共享用于存储包的本地路径。

该值必须是不同于 Nuget 安装文件夹的路径，并且充当 NuGet 的临时文件夹。

备注：
只有 NUGET_SCRATCH 变量应使用已配置的临时文件夹。

示例：
```
NUGET_SCRATCH=C:\NuGetTempFolder
NUGET_SCRATCH=C:\NuGetTempFolder
```
UIPATH_PRESERVE_CREDENTIALS_CASE - 保留日志记录凭据的原始大小写（域名\用户名）。

示例：
```
UIPATH_PRESERVE_CREDENTIALS_CASE = True
UIPATH_PRESERVE_CREDENTIALS_CASE = True
```
UIPATH_SESSION_BEHAVIOR - 配置作业完成后会话还原的行为方式。可选择以下选项：
- TryReuseAndRestoreSession — 默认选项。尝试重用会话，并在作业完成后将其恢复到先前的状态。如果没有可以重复使用的初始会话，则会在还原时注销。
- ForceNew — 创建一个全新的会话，无论之前的会话状态如何。始终在还原时注销。
- LeaveSessionActive — 防止恢复初始会话状态。
- LeaveSessionDisconnected — 还原时始终断开会话。
示例：
```
UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected
UIPATH_SESSION_BEHAVIOR = LeaveSessionDisconnected
```
UIPATH_HTTP_CONNECTION_LIFETIME - 规定与 Orchestrator 的连接在关闭并刷新之前保持开启状态的时长。默认时长为 30 分钟，但要调整该值，请使用以秒为单位的值。

示例：
```
// to set 10 minutes                          
UIPATH_HTTP_CONNECTION_LIFETIME = 600
// to set 10 minutes                          
UIPATH_HTTP_CONNECTION_LIFETIME = 600
```
UIPATH_FILE_LOG_LEVEL - 规定本地文件中使用的执行日志级别。这与 Orchestrator 使用的日志级别不同。可选择以下选项：
- 详情
- 追踪
- 信息
- Warning
- 错误
- 重要事项
- 关闭
示例：
```
// to set verbose level locally
UIPATH_FILE_LOG_LEVEL = Verbose
// to set verbose level locally
UIPATH_FILE_LOG_LEVEL = Verbose
```
UIPATH_EXECUTOR_STARTUP_DELAY - 规定从会话创建到执行程序启动之间的等待时间（秒）。当您的基础架构需要在自动化的执行开始之前加载一些服务（VPN、安全）时，需要使用此选项。

示例：
```
// to set the delay to 5 seconds
UIPATH_EXECUTOR_STARTUP_DELAY = 5
// to set the delay to 5 seconds
UIPATH_EXECUTOR_STARTUP_DELAY = 5
```

proxy.json

The proxy.json file stores proxy configuration for the Robot Service and the Update Worker when running in service mode. Available starting with Robot 2025.10, it replaces proxy settings that were previously maintained in UiPath.config.

重要提示：

Starting with Robot 2025.10, proxy settings are configured in proxy.json.

访问文件

File location: %ProgramData%\UiPath\Shared\proxy.json

备注：

If you upgrade from an earlier version and already have proxy settings configured, the system automatically migrates your existing settings to proxy.json.

After editing proxy.json, restart the Robot Service or the device for the changes to take effect.

参数

The following parameters are supported. If both ScriptAddress and ProxyAddress are present in the same file, ScriptAddress takes precedence.

参数	类型	描述
`ScriptAddress`	字符串	URL of the proxy auto-configuration (PAC) script. When present, takes precedence over `ProxyAddress`. Example: `http://proxy.address/proxy.pac`
`ProxyAddress`	字符串	Address and port of the proxy server. Example: `http://proxy.address:1234/`
`BypassLocalAddresses`	布尔值	When `true`, local addresses bypass the proxy server.
`BypassList`	字符串	Semicolon-separated list of regular expression patterns identifying hosts that bypass the proxy. Use `\\` to escape special regex characters. Example: `server\\.domain\\.local$;192\\.168\\.\\d{1,3}\\.\\d{1,3}`
`UserName`	字符串	Username for basic proxy authentication.
`Password`	字符串	Password for basic proxy authentication.
`Domain`	字符串	Domain for basic proxy authentication.

Example configurations

For step-by-step configuration instructions, see Redirecting robots through a proxy server.

PAC script:

{
  "ScriptAddress": "http://proxy.address/proxy.pac"
}
{
  "ScriptAddress": "http://proxy.address/proxy.pac"
}

Proxy address with basic authentication:

{
  "ProxyAddress": "http://proxy.address:1234/",
  "BypassLocalAddresses": true,
  "BypassList": "server\\.domain\\.local$;www.example.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}",
  "UserName": "myUser",
  "Password": "myPassword",
  "Domain": "myDomain"
}
{
  "ProxyAddress": "http://proxy.address:1234/",
  "BypassLocalAddresses": true,
  "BypassList": "server\\.domain\\.local$;www.example.com;192\\.168\\.\\d{1,3}\\.\\d{1,3}",
  "UserName": "myUser",
  "Password": "myPassword",
  "Domain": "myDomain"
}

在此页面上

重新启动机器人组件
uipath.config
访问文件
可自定义的设置
UiPath Robot 系统变量
proxy.json
访问文件
参数
Example configurations

此页面有帮助吗？

前一个配置网络设置

下一个先决条件

机器人管理员指南

重新启动机器人组件​

uipath.config​

访问文件​

可自定义的设置​

UiPath Robot 系统变量​

proxy.json​

访问文件​

参数​

Example configurations​

此页面有帮助吗？

重新启动机器人组件

uipath.config

访问文件

可自定义的设置

UiPath Robot 系统变量

proxy.json

访问文件

参数

Example configurations