A specialized skill for managing, transferring, and synchronizing files across remote machines via secure Tailscale SSH connections.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install ssh-filemanager
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-filemanager 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 Tailnet SSH File Manager?
The Tailnet SSH File Manager is a powerful tool designed for the Openclaw Skills ecosystem, enabling seamless file operations between an OpenClaw Gateway and remote Nodes. It abstracts the complexities of Tailscale SSH, scp, and sftp into a unified interface, allowing for secure file manipulation across a private Tailnet without exposing ports to the public internet.
This skill is engineered for performance and reliability, featuring built-in intelligence to handle different file sizes efficiently. By leveraging the security of Tailscale ACLs and the simplicity of MagicDNS, it provides developers and system administrators with a robust way to automate remote filesystem tasks directly through an AI coding agent.
Tailnet SSH File Manager Use Cases
- Deploying configuration files or scripts from a local dev machine to multiple remote OpenClaw nodes.
- Retrieving logs or diagnostic data from remote servers for local analysis.
- Managing remote directory structures, including recursive deletes, moves, and permission updates via chmod.
- Searching for specific files across a distributed network of machines using remote find operations.
- Synchronizing binary assets between nodes using secure scp protocols.
How Tailnet SSH File Manager Works
- The skill identifies the target remote host using its Tailscale IP or MagicDNS hostname.
- It determines the specific filesystem action (e.g., list, read, push) and validates the target paths.
- A file size evaluation is performed; files under 3KB are handled via inline text/base64 streams, while larger files automatically trigger scp-based push/pull operations.
- The skill executes a Python-based helper script that wraps the underlying SSH/SCP commands.
- Results are returned as a JSON payload, providing status updates or file metadata to the user.
Tailnet SSH File Manager Setup
To utilize this skill within the Openclaw Skills framework, ensure your environment meets these requirements:
- Connect your Gateway to your Tailnet.
- Enable Tailscale SSH on your target nodes and configure appropriate ACLs.
- Verify connectivity using the built-in check tool:
python3 ./scripts/ssh_tunnel.py check --host <your-node-hostname>
- Ensure Python 3 is installed on the remote node for full metadata support.
Tailnet SSH File Manager Data Schema & Taxonomy
The skill returns structured JSON data for every operation to ensure compatibility with Openclaw Skills workflows. Key metadata includes:
| Attribute | Description |
|---|---|
| host | The Tailscale identifier (IP or MagicDNS) of the node. |
| path | The absolute path on the remote filesystem. |
| metadata | Includes size, mode (permissions), UID, GID, and mtime. |
| success | Boolean indicating the result of the operation. |
| error | Detailed error message if the operation fails. |
Tailnet SSH File Manager Advanced Features
- Intelligent SCP Fallback: Automatically switches from inline payloads to scp for files larger than 3KB to prevent payload limits.
- Recursive Operations: Supports recursive directory copying and deletion for complex cleanup or deployment tasks.
- Multi-Format Reading: Capable of reading remote files as plain text or base64 encoded strings for binary compatibility.
- Reachability Diagnostics: Integrates with ssh_tunnel tools to diagnose connectivity issues before attempting file operations.
- Permission Management: Native support for remote chmod and stat operations to maintain system security posture.
SKILL.md
Loading
Related Openclaw Skills
AI Image Generation
A powerful multi-model image generation skill that connects AI agents to over 50 state-of-the-art visual models through a single unified API.
Free Video Mockup Generator
A high-speed, cloud-powered agent that transforms raw screenshots and screen recordings into professional 1080p device mockup videos.
Senior Java & Spring Boot Development
A world-class Java and Spring Boot development skill designed for building enterprise-grade microservices and cloud-native applications with automated scaffolding and security.
Karaoke Video Maker Free
A powerful AI skill for Openclaw Skills that transforms audio files and lyrics into high-quality 1080p synced karaoke videos in seconds.
Adaptive Reasoning
A cognitive preprocessing layer that automatically adjusts reasoning depth based on the complexity and ambiguity of user requests.
AI Daily Briefing
The AI Daily Briefing skill aggregates your tasks, calendar, and meeting context into a single, actionable morning report.
Featured*
