SkillHub

oc-ssh-tunnel-node-recovery

v0.1.0

Diagnose and recover OpenClaw node connectivity over SSH tunnel. Use for pairing-required errors, tunnel conflicts, wrong remote endpoint, and ssh target mismatch.

Sourced from ClawHub, Authored by xyezir

Installation

Please help me install the skill `oc-ssh-tunnel-node-recovery` from SkillHub official store. npx skills add xyezir/oc-ssh-tunnel-node-recovery

OC SSH Tunnel Node Recovery

When to use

  • gateway closed (1008): pairing required
  • cannot listen to port / Address already in use
  • remote endpoint unreachable after migration
  • node can connect intermittently but status is unstable

Inputs expected

  • <ssh-target>
  • <api-endpoint>
  • <gateway-credential>
  • target node id/name

Procedure

  1. Validate tunnel process exists and local forward is bound.
  2. Verify endpoint is tunnel-local and not public plaintext.
  3. Verify ssh target maps to correct gateway host.
  4. Verify credential is present and matches gateway auth mode.
  5. Re-run probe then status check; record outcome.

Deliverable format

  • Root cause (single sentence)
  • Fixes applied (ordered list)
  • Verification evidence (probe/status snippets)
  • Residual risk and next action

Safety

  • Never expose real IP/domain/path/credential in external reports.
  • Use placeholders for all network and identity fields.