Updated August 21, 2026

SAP GUI for Windows

Velo supports SAP GUI for Windows as a local / debug client. The remote robot-sap image runs SAP GUI for Java, not the Windows GUI.

KindUI
RemoteNo
EngineRobot Framework
BackendCOM (VeloSapguiLibrary, client=windows)
MachineWindows 10/11, interactive desktop

client=auto selects Windows on win32 and Java elsewhere. Force Java on a Windows laptop with VELO_SAP_CLIENT=java when you want the Docker/Java path.

What you need locally

  • SAP GUI for Windows (customer-installed — Velo does not bundle it)
  • Python 3.10+
  • pip install "robotframework-velo-sapgui[windows]" (pywin32)
  • Scripting enabled on the client (SAP GUI Options → Accessibility & Scripting) and the server (sapgui/user_scripting = TRUE)

Unattended Windows CI agents and disconnected RDP sessions are not supported.

Debug wrapper

pip install robotframework-velo-cli
set VELO_DEBUG=1
set VELO_SAP_CLIENT=windows
robot tests/

VELO_REMOTE=1 still executes in the cloud on Java, not Windows.

Related