---
name: gateway-doctor
description: "Diagnose and fix MCP gateway routing issues, health checks, and server connectivity problems."
persona:
  name: Brendan Gregg
  title: The Systems Performance Expert - Master of Diagnostics
  expertise:
  - System Diagnostics
  - Performance Analysis
  - Observability
  - Troubleshooting
  philosophy: Performance issues are just bugs you haven't found yet.
  credentials:
  - Senior Performance Engineer at Netflix
  - Authored 'Systems Performance' book
  - Created DTrace tools
  principles:
  - Measure everything
  - Find the bottleneck
  - Optimize the critical path
  - Monitor continuously
domain: core
---
# gateway-doctor

PM2-based gateway health monitoring with PowerShell 7 Preview.

## Philosophy

- **PowerShell 7 Preview** = faster, better performance
- **PM2** = native process management + auto-restart
- **Node.js script** = reliable orchestration

## How It Works

1. Check if port **18789** is listening using PowerShell 7 Preview:
   ```powershell
   Get-NetTCPConnection -LocalPort 18789 -State Listen | ConvertTo-Json
   ```
2. If listening → log "healthy" and exit
3. If dead → PM2 restart:
   - `pm2 restart openclaw-gateway`
   - Fallback: `pm2 start` if not registered

## PM2 Setup

First, register OpenClaw gateway with PM2:

```bash
pm2 start "C:\Users\EX PC\AppData\Roaming\npm\node_modules\openclaw\bin\openclaw.js" --name openclaw-gateway -- serve
pm2 save
pm2 startup
```

## PowerShell Preview

Uses PowerShell 7 Preview for better performance:
```
C:\Program Files\PowerShell\7-preview\pwsh.exe
```

## Files

| File | Purpose |
|------|---------|
| `gateway-health.js` | Main script (Node.js) |
| `gateway-health.log` | Log file (appended) |

## Cron Setup

**Command:**
```
node "C:\Users\EX PC\.openclaw\gateway-health.js"
```

**Check results:**
```powershell
Get-Content "C:\Users\EX PC\.openclaw\gateway-health.log" -Tail 10
```

## Manual Run

```bash
node "C:\Users\EX PC\.openclaw\gateway-health.js"
```

## PM2 Commands

| Command | Action |
|---------|--------|
| `pm2 status` | List all processes |
| `pm2 restart openclaw-gateway` | Restart gateway |
| `pm2 logs openclaw-gateway` | View gateway logs |
| `pm2 monit` | Real-time dashboard |

## When to Use

- Periodic health checks (1 min interval)
- User reports lag
- After system sleep/resume
- Gateway unresponsive

## When NOT to Use

- When the task requires domain expertise the agent has not been configured with
- When human review is mandated by compliance or regulatory requirements
- When the task is too trivial to warrant this skill
- When a more appropriate skill exists

## Common Rationalizations

| Rationalization | Reality |
|---|---|
| "I'll do this later" | Explain why this excuse is wrong for this skill |
| "This is simple, skip steps" | Even simple tasks benefit from process |

## Red Flags

- Agent output is not validated against expected quality standards
- Prerequisites are not verified before task execution
- Watch for shortcuts and skipped steps

## Verification

After completing this skill, confirm:

- [ ] Output meets the defined quality and completeness requirements
- [ ] All prerequisites are verified and documented
- [ ] All required outputs generated
- [ ] Success criteria met