AGENT SKILL

win-terminal

Controls the Windows Terminal to run commands, scripts, and manage processes on Windows. Enables AI agents to execute git, npm, pip, node, and any CLI commands. Use when you need to run terminal commands, manage dev servers, check git status, install dependencies, or automate Windows command-line workflows.

License 许可
MIT
最近更新
2026-06-07
Stars
★ 0
Forks
1

01 前言 Front Matter

name
win-terminal
description
Controls the Windows Terminal to run commands, scripts, and manage processes on Windows. Enables AI agents to execute git, npm, pip, node, and any CLI commands. Use when you need to run terminal commands, manage dev servers, check git status, install dependencies, or automate Windows command-line workflows.

03 SKILL.md 正文

Windows Terminal Control

A skill that enables AI agents to execute shell commands on Windows machines through PowerShell or Windows Terminal. Perfect for automating development workflows without context switching.

Core Capabilities

  • Run Commands: Execute any command-line tool or script (git, npm, pip, node, python, etc.)
  • Capture Output: Read stdout and stderr from commands with proper encoding support
  • Timeout Protection: Commands automatically timeout after 30 seconds (configurable) to prevent hangs
  • Working Directory Control: Execute commands in specific project folders
  • Fallback Support: Falls back to PowerShell if Windows Terminal is not installed

Usage

Basic Command Execution

# Check git status
run-command.ps1 -Command "git status" -WorkingDirectory "C:\Users\kanja\projects\my-app"

# Install dependencies
run-command.ps1 -Command "npm install" -WorkingDirectory "C:\Users\kanja\projects\my-app" -TimeoutSeconds 60

# Run a dev server (non-blocking)
run-command.ps1 -Command "npm run dev" -WorkingDirectory "C:\Users\kanja\projects\my-app"

Parameters

Parameter Type Default Description
Command string required The command to execute
WorkingDirectory string current directory Directory to execute command in
TimeoutSeconds int 30 Maximum time to wait for command
NoGui switch false Force PowerShell instead of Windows Terminal

Security & Limitations

What This Skill CAN Do

✅ Run standard CLI tools (git, npm, pip, python, node, etc.)
✅ Execute PowerShell commands
✅ Read command output and errors
✅ Operate in any directory you have access to
✅ Start background processes
✅ Handle output up to 100KB

What This Skill CANNOT Do

❌ Run interactive commands (vim, nano, ssh, etc.)
❌ Run commands requiring Administrator privileges without approval
❌ Access other users' files or system directories outside your workspace
❌ Run indefinitely (30-second default timeout)
❌ Execute commands with dangerous patterns (sanitization blocks known attack vectors)

Security Safeguards

  • Input Sanitization: Blocks known dangerous patterns (command injection attempts)
  • Timeout Protection: Prevents hanging commands
  • No Interactive Mode: Interactive tools are blocked to prevent hangs
  • User Permissions Only: Operates with your standard Windows user permissions
  • Output Limits: Large outputs (>100KB) are truncated to prevent memory issues

Important Notes

  • Not a Sandbox: Commands run with your actual user permissions. The skill trusts command input.
  • GUI Commands: Commands that spawn GUI windows may behave unexpectedly
  • Network Commands: Commands requiring network access may timeout if the network is slow
  • Windows Terminal vs PowerShell: Prefers Windows Terminal if installed, falls back to PowerShell

Prerequisites

  • Windows 10/11
  • PowerShell 5.1 or later
  • Windows Terminal (optional, but recommended)
  • PowerShell Execution Policy set to RemoteSigned (for script execution)

Troubleshooting

"Command timed out"

Increase the timeout: run-command.ps1 -Command "slow-command" -TimeoutSeconds 120

"Interactive command detected"

Use non-interactive alternatives:

  • Instead of vim file.txt, use Get-Content file.txt
  • Instead of ssh user@host, use ssh user@host "command"

"Access denied"

The command may require elevated privileges. OpenClaw will ask for approval if needed.

"Windows Terminal not found"

The skill automatically falls back to PowerShell. Install Windows Terminal for better experience.

Examples

# Git workflow
run-command.ps1 -Command "git add ." -WorkingDirectory "C:\projects\my-app"
run-command.ps1 -Command "git commit -m 'Update'" -WorkingDirectory "C:\projects\my-app"

# Python development
run-command.ps1 -Command "pip install -r requirements.txt" -WorkingDirectory "C:\projects\my-app" -TimeoutSeconds 120
run-command.ps1 -Command "python manage.py migrate" -WorkingDirectory "C:\projects\my-app"

# Node.js development
run-command.ps1 -Command "npm run build" -WorkingDirectory "C:\projects\my-app" -TimeoutSeconds 60
run-command.ps1 -Command "npm test" -WorkingDirectory "C:\projects\my-app"

# File operations
run-command.ps1 -Command "Get-ChildItem -Recurse -Filter '*.py' | Select-Object Name" -WorkingDirectory "C:\projects\my-app"

04 同仓库更多 Skills

javimosch
javimosch/open-claw-skills

crowd-prompting

A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.

★ 0
javimosch
javimosch/open-claw-skills

ceaser

Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).

★ 0
javimosch
javimosch/open-claw-skills

ceaser-send

Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.

★ 0
javimosch
javimosch/open-claw-skills

dilemm-ai

Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).

★ 0
javimosch
javimosch/open-claw-skills

moldium

Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.

★ 0
javimosch
javimosch/open-claw-skills

arxiv-paper-reviews

Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.

★ 0