--- name: windows-remote description: Control remote Windows machines via SSH. Use when executing commands on Windows, checking GPU status (nvidia-smi), running scripts, or managing remote Windows systems. Triggers on "run on Windows", "execute on remote", "check GPU", "nvidia-smi", "远程执行", "Windows 命令". metadata: { "openclaw": { "emoji": "🖥️", "requires": { "bins": ["ssh"], "env": ["WINDOWS_SSH_HOST", "WINDOWS_SSH_USER"] }, "env": { "WINDOWS_SSH_HOST": { "description": "Remote Windows IP or hostname", "required": true, "example": "192.168.1.100" }, "WINDOWS_SSH_PORT": { "description": "SSH port (default: 22)", "required": false, "default": "22", "example": "23217" }, "WINDOWS_SSH_USER": { "description": "SSH username", "required": true, "example": "Administrator" }, "WINDOWS_SSH_KEY": { "description": "Path to SSH private key (default: ~/.ssh/id_ed25519)", "required": false, "default": "~/.ssh/id_ed25519" }, "WINDOWS_SSH_TIMEOUT": { "description": "Connection timeout in seconds", "required": false, "default": "10" } } } } ---

Windows Remote Control

Execute commands on remote Windows machines via SSH.

Configuration

Set environment variables in ~/.openclaw/openclaw.json under skills.windows-remote.env:

{
  "skills": {
    "windows-remote": {
      "env": {
        "WINDOWS_SSH_HOST": "192.168.1.100",
        "WINDOWS_SSH_PORT": "22",
        "WINDOWS_SSH_USER": "Administrator"
      }
    }
  }
}

Or export directly:

export WINDOWS_SSH_HOST="192.168.1.100"
export WINDOWS_SSH_PORT="22"
export WINDOWS_SSH_USER="Administrator"

Quick Commands

Check Connection

scripts/win-exec.sh "echo connected"

GPU Status

scripts/win-exec.sh "nvidia-smi"

Run PowerShell

scripts/win-exec.sh "powershell -Command 'Get-Process | Select-Object -First 10'"

Execute Script

scripts/win-exec.sh "python C:\\path\\to\\script.py"

Script Reference

win-exec.sh

Execute a single command on the remote Windows machine.

scripts/win-exec.sh "<command>"

win-gpu.sh

Quick GPU status check (nvidia-smi wrapper).

scripts/win-gpu.sh
scripts/win-gpu.sh --query  # Compact output

win-upload.sh

Upload files to the remote machine via SCP.

scripts/win-upload.sh <local-file> <remote-path>

win-download.sh

Download files from the remote machine.

scripts/win-download.sh <remote-path> <local-file>

Common Tasks

Check if Ollama is Running

scripts/win-exec.sh "tasklist | findstr ollama"

Start a Service

scripts/win-exec.sh "net start <service-name>"

Run Python with GPU

scripts/win-exec.sh "python -c \"import torch; print(torch.cuda.is_available())\""

Check Disk Space

scripts/win-exec.sh "wmic logicaldisk get size,freespace,caption"

Troubleshooting

| Issue | Solution | |-------|----------| | Connection refused | Check SSH service: Get-Service sshd | | Permission denied | Verify SSH key in ~/.ssh/authorized_keys or administrators_authorized_keys | | Timeout | Check firewall rules, verify IP/port | | Command not found | Use full path or check PATH on Windows |

Security Notes

• Use SSH keys instead of passwords
• Keep private keys secure (chmod 600)
• Consider using Tailscale for cross-network access