🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Port Check

by @rogue-agent1

Check if services are responding on given host:port pairs. Supports TCP and HTTP checks with configurable timeout. Use for service monitoring, health checks,...

Versionv1.0.0
Downloads1,855
TERMINAL
clawhub install port-check

πŸ“– About This Skill


name: port-check version: 1.0.0 description: Check if services are responding on given host:port pairs. Supports TCP and HTTP checks with configurable timeout. Use for service monitoring, health checks, and network debugging. metadata: {"clawdbot":{"emoji":"πŸ”Œ","requires":{"bins":["nc","curl"]}}}

Port Check Skill

Quickly verify if services are up and responding on specific ports.

Usage

# Basic TCP check
bash scripts/port-check.sh localhost:8080 localhost:5432

Multiple targets with HTTP status check

bash scripts/port-check.sh localhost:80 api.example.com:443 --http

Custom timeout (default 3s)

bash scripts/port-check.sh 192.168.1.1:22 --timeout 5

Output

  • βœ… host:port β€” open (TCP connected)
  • βœ… host:port β€” open (HTTP 200) (with --http flag)
  • ⚠️ host:port β€” open but HTTP 500 (port open, bad HTTP status)
  • ❌ host:port β€” closed/timeout (no response)
  • Exit Codes

  • 0 β€” all targets up
  • 1 β€” one or more targets down
  • Common Checks

    # OpenClaw gateway
    bash scripts/port-check.sh localhost:18789 --http

    Database + web stack

    bash scripts/port-check.sh localhost:5432 localhost:6379 localhost:3000

    Home network devices

    bash scripts/port-check.sh 192.168.1.1:80 192.168.1.50:22 --timeout 2

    πŸ’‘ Examples

    # Basic TCP check
    bash scripts/port-check.sh localhost:8080 localhost:5432

    Multiple targets with HTTP status check

    bash scripts/port-check.sh localhost:80 api.example.com:443 --http

    Custom timeout (default 3s)

    bash scripts/port-check.sh 192.168.1.1:22 --timeout 5