An automated diagnostic and recovery tool for OpenClaw nodes experiencing SSH tunnel connectivity failures, pairing errors, or port conflicts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install oc-ssh-tunnel-node-recovery
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 oc-ssh-tunnel-node-recovery 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 OC SSH Tunnel Node Recovery?
The OC SSH Tunnel Node Recovery skill is a specialized technical utility designed to manage and repair the secure communication layers between distributed nodes. It focuses specifically on the complexities of SSH tunneling, addressing critical failures such as the 1008 pairing required error and local port binding conflicts that can halt development workflows.
By implementing this within the framework of Openclaw Skills, developers can automate the verification of tunnel-local endpoints and ensure that gateway credentials align with the required authentication modes. This skill acts as a safeguard during infrastructure migrations, providing a structured approach to restoring unreachable remote endpoints and stabilizing intermittent connections.
OC SSH Tunnel Node Recovery Use Cases
- Resolving gateway closed (1008) pairing required errors during node initialization.
- Troubleshooting Address already in use errors when local port forwarding fails.
- Restoring node connectivity following a remote endpoint migration or infrastructure change.
- Stabilizing unstable or intermittent node status by validating tunnel process integrity.
How OC SSH Tunnel Node Recovery Works
- The skill initiates by validating the tunnel process and ensuring the local forward port is correctly bound.
- It verifies that the API endpoint is configured for tunnel-local access to prevent plaintext exposure.
- It maps the SSH target against the gateway host to ensure routing accuracy.
- It confirms that the provided gateway credentials match the active authentication mode.
- A final network probe and status check are executed to verify the recovery and record evidence of the fix.
OC SSH Tunnel Node Recovery Setup
To integrate this recovery workflow into your environment, use the following commands within the context of Openclaw Skills:
# Add the skill to your agent configuration
oc skill add oc-ssh-tunnel-node-recovery
# Provide the necessary node identifiers and credentials
# Required inputs: <ssh-target>, <api-endpoint>, <gateway-credential>
Ensure that your SSH environment has the appropriate keys configured for the target node before running the recovery probe.
OC SSH Tunnel Node Recovery Data Schema & Taxonomy
The skill generates a structured recovery report following this schema:
| Data Point | Format | Description |
|---|---|---|
| Root Cause | String | A single-sentence identification of the failure point. |
| Fixes Applied | Ordered List | Sequential steps taken to restore the tunnel. |
| Verification Evidence | Code Snippet | Output logs from probe and status commands. |
| Residual Risk | String | Potential side effects or recommended next actions. |
| Safety Masking | Policy | All IP addresses and credentials are replaced with placeholders. |
OC SSH Tunnel Node Recovery Advanced Features
- Automated port conflict detection and suggested re-binding strategies.
- Validation of tunnel-local vs public plaintext endpoints to prevent security leaks.
- Integration with standard Openclaw Skills reporting formats for multi-agent visibility.
- Placeholder-based security masking to ensure reports can be shared safely across teams.
SKILL.md
Loading
Related Openclaw Skills
OpenClaw SRE On-Demand Service
A comprehensive SRE blueprint for diagnosing, repairing, and hardening OpenClaw node environments and connectivity.
Full Ops Audit Recipe
A comprehensive, repeatable workflow for auditing OpenClaw infrastructure and performing verified system remediation.
OC Evolver Restart Loop Fix
A specialized skill designed to diagnose and repair service restart loops caused by stale singleton locks and PID false positives in Evolver environments.
OpenClaw Approval-Free Node Stabilizer
A specialized utility to stabilize no-approval node execution by mitigating timeouts and noisy failure events within the OpenClaw ecosystem.
Ramadan Times Skill
An intelligent utility for tracking Ramadan fasting times with automatic location detection and multi-language support.
Agentic Browser
A sophisticated browser automation tool that enables AI agents to navigate the web, interact with elements, and record sessions using the inference.sh infrastructure.
Featured*
