AgentSkillsCN

windows-remote

通过SSH远程控制Windows机器。在需要在Windows上执行命令、检查GPU状态（nvidia-smi）、运行脚本，或管理远程Windows系统时使用此功能。可通过“在Windows上运行”“在远程执行”“检查GPU”“nvidia-smi”“远程执行”“Windows命令”等触发器来启动该操作。

SKILL.md
--- frontmatter
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:

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

Or export directly:

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

Quick Commands

Check Connection

bash
scripts/win-exec.sh "echo connected"

GPU Status

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

Run PowerShell

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

Execute Script

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

Script Reference

win-exec.sh

Execute a single command on the remote Windows machine.

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

win-gpu.sh

Quick GPU status check (nvidia-smi wrapper).

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

win-upload.sh

Upload files to the remote machine via SCP.

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

win-download.sh

Download files from the remote machine.

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

Common Tasks

Check if Ollama is Running

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

Start a Service

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

Run Python with GPU

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

Check Disk Space

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

Troubleshooting

IssueSolution
Connection refusedCheck SSH service: Get-Service sshd
Permission deniedVerify SSH key in ~/.ssh/authorized_keys or administrators_authorized_keys
TimeoutCheck firewall rules, verify IP/port
Command not foundUse 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