Setup & Installation
openclaw skills install @rogue-agent1/port-check
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install port-check
What This Skill Does
Checks whether services are responding on specified host:port pairs. Supports both TCP connectivity and HTTP status verification, with a configurable timeout. Exits with a non-zero code if any target is down, making it scriptable.
Combines TCP and HTTP checks into a single command so you don't have to switch between nc and curl manually.
When to use it
- Confirming a local dev server is up before running tests
- Checking if a database port is accessible after a deploy
- Verifying SSH is reachable on a home network device
- Diagnosing which service in a stack failed to start
- Monitoring an API endpoint for HTTP 200 responses
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: 'Are my database and web server up?'
AGENT
- 1Run port-check against localhost:5432 and localhost:3000
- 2Attempt TCP connection to each target within the timeout window
- 3Optionally request HTTP status with --http flag
- 4Report open or closed status for each host:port pair
- 5Exit with code 1 if any target fails to respond
OUTPUT
localhost:5432 — open, localhost:3000 — open