A powerful agentless skill that enables AI Agents to securely connect and operate remote Mac or Linux computers through encrypted SSH tunnels.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ssh-remote-control
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install ssh-remote-control using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is SSH Remote Control?
The SSH Remote Control skill for Openclaw Skills bridges the gap between cloud-hosted AI agents and local hardware. By leveraging standard Secure Shell (SSH) protocols, it allows an AI to execute commands, manage files, and control applications on remote Mac, Linux, or WSL systems without requiring any proprietary agent software on the target machine.
This approach prioritizes security and simplicity. Because it uses industry-standard SSH key authentication and can be paired with intranet penetration tools like frp or ngrok, users maintain full physical control over when the connection is open. It transforms a remote AI into a hands-on administrator capable of performing system monitoring, development tasks, and even macOS-specific automation via AppleScript.
SSH Remote Control Use Cases
- Remote Office Management: Use an AI agent on your mobile device to trigger workflows or retrieve files from your office Mac.
- Smart Home Automation: Connect AI to Raspberry Pi or IoT devices to execute localized automation scripts.
- Cross-Device Coordination: Centralize the management of multiple remote servers or workstations through a single AI interface.
- DevOps & System Admin: Monitor system resources, check Git statuses, or manage Docker containers on remote environments without local CLI access.
- macOS Automation: Remotely launch applications, capture screenshots, or query browser tabs using AppleScript integration.
How SSH Remote Control Works
- Target Configuration: The remote computer is configured to allow SSH access and, if behind a NAT, mapped to a public endpoint using a penetration tool.
- Key Generation: The AI server generates a secure SSH key pair (e.g., ED25519) to establish a trust relationship.
- Authorization: The public key is added to the remote computer's authorized_keys file to enable passwordless, secure authentication.
- Command Execution: The AI Agent sends encrypted commands over the SSH tunnel, receiving real-time console output to inform its next actions.
- Lifecycle Management: The connection remains active only as long as the user-controlled tunnel or SSH service is running, ensuring physical-layer security.
SSH Remote Control Setup
Remote Host Setup (macOS)
- Enable Remote Login in System Settings -> Sharing.
- Add your AI's public key to
~/.ssh/authorized_keys.
Remote Host Setup (Linux)
sudo apt install openssh-server
sudo systemctl enable ssh
Environment Variables
Configure these variables within your Openclaw Skills environment:
SSH_TARGET_HOST: The public IP or domain of the remote PC.SSH_TARGET_PORT: SSH port (default is 22).SSH_TARGET_USER: Remote username.SSH_KEY_PATH: Path to your local private key file.
Connection Test
ssh -i $SSH_KEY_PATH -p $SSH_TARGET_PORT $SSH_TARGET_USER@$SSH_TARGET_HOST 'echo "SSH Connection Successful"'
SSH Remote Control Data Schema & Taxonomy
The skill manages data through standard Unix-style command outputs and file transfer protocols. It does not maintain a proprietary database, instead interacting directly with the remote filesystem.
| Data Type | Interaction Method | Storage Location |
|---|---|---|
| System Metadata | sw_vers, df -h, top |
Volatile (AI Context) |
| Files | scp, cat, ls |
Remote Filesystem |
| Automation Scripts | osascript (macOS) |
Remote System Events |
| Authentication | SSH Keys | Local .ssh Directory |
SSH Remote Control Advanced Features
- AppleScript Integration: Deep control over macOS apps like Safari, Chrome, and NetEase Music.
- Intranet Penetration Support: Compatible with frp, ngrok, and NATAPP for reaching devices behind firewalls.
- Granular Permissions: Supports
command=restrictions inauthorized_keysto limit the AI to specific scripts. - Secure Tunneling: Data is never routed through third-party cloud servers; the SSH tunnel provides end-to-end encryption.
- Physical Isolation: Closing the local penetration tool creates an instant 'kill-switch' for AI access.
SKILL.md
Loading
Related Openclaw Skills
Security Stack Builder
An automated platform that generates data-driven cybersecurity technology stack recommendations tailored to specific organizational risk profiles and compliance needs.
Subagent Collaboration Analysis & Construction
A comprehensive framework for analyzing subagent capabilities and orchestrating complex multi-agent collaboration patterns within the OpenClaw ecosystem.
Windows Security Hardening Tool
A professional-grade API service for automating the generation of standardized, security-focused Windows configuration policies.
Reddit Publisher
An advanced toolset for AI agents to research subreddits and publish authentic, human-sounding content via ScrapeCreators and Late APIs.
Security Posture Maturity Assessment
A professional-grade evaluation framework for measuring organizational security maturity across eight critical technical and operational domains.
China Bid Generator
An AI-powered tool for generating professional, legally compliant Chinese bidding and tender documents across multiple industries.
Featured*
