Skip to main content
The troubleshooting steps below apply to AgentOS running as a Windows service. For standalone mode on macOS or Linux, check the terminal output for errors.

​
Logs

Service logs are stored at: 
C:\Windows\System32\config\systemprofile\.askui\logs
Use these for troubleshooting startup, crash, or connectivity issues.

​
Common Issues

​
Agent can’t press CTRL+ALT+DEL

The login/lock screen cannot be automated unless the local security policy allows services to simulate a Secure Attention Sequence (SAS). To enable it:
  1. Open the Group Policy Editor (gpedit.msc).
  2. Navigate to Computer Configuration → Administrative Templates → Windows Components → Windows Logon Options.
  3. Set Disable or enable software Secure Attention Sequence to Enabled.
Also verify that SERVICE_ENABLE_SAS is set to 1 (default) in the Silent installer parameters.
The service includes a windows.forceSas option that overrides group policies. This is not recommended as it may trigger system integrity checks. Configure the GPE policy instead.

​
Agent can’t interact with apps running as Administrator

Windows prevents non-elevated processes from sending input to elevated (Run as Administrator) applications. If your agent can’t click or type into an app running as Administrator, you need to start the Remote Device Controller in elevated mode. To enable elevated mode:
  • Service Installer (GUI): Open Windows Add/Remove Programs, find AskUI AgentOS, click Modify, and enable the elevated execution engine option. Alternatively, reinstall AgentOS with the option enabled.
  • Silent Installer: Set SERVICE_EXECUTION_ENGINE_ELEVATED to 1 — see Silent installer parameters.
Running the execution engine elevated grants it higher privileges. Only enable this when you need to automate applications that run as Administrator.

​
Need to reinstall or remove

Do not stop or remove the service from Windows Services manually. Always uninstall the full AskUI AgentOS application via Windows Add/Remove Programs. This ensures proper cleanup so the SDK falls back to standalone mode.