Windows Remote

核心功能为通过SSH远程操作Windows设备，支持执行各类命令、查询GPU状态、上传/下载文件、管理系统服务等。典型场景包括远程运维Windows系统、运行脚本、检查硬件状态等。需提前配置SSH连接参数（主机地址、用户名等），可通过脚本或触发词调用，输出为执行结果或传输状态反馈。

xiaoyaner0201

热度 14.08

最近更新 2026-07-08 02:23:07

分类：自动化依赖：代码执行应用场景：自动化脚本 / DevOps / 任务管理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add windows-remote

Metadata

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