openclaw-ops

name	openclaw-ops
license	MIT
version	1.2.1
description	Use when diagnosing, repairing, or maintaining an OpenClaw Gateway on the same machine. Designed for rescue agents to fix a down gateway or check operational health. Supports Linux (systemd) and macOS (launchd).
repository	https://github.com/dinstein/openclaw-ops-skill
requirements	["Shell access on the same machine as the OpenClaw Gateway","Read/write access to ~/.openclaw/ (config, agents, sessions)","Read access to systemd user service config (Linux) or LaunchAgents (macOS)","Node.js 18+ and npm (for openclaw CLI)",{"Optional":"Tailscale CLI (for reverse proxy troubleshooting)"}]
security_notes	["This skill instructs the agent to read and modify OpenClaw config files","The agent will access env files containing tokens (but is instructed never to print them)","Config edits are always preceded by timestamped backups","Destructive operations require user confirmation"]
source	https://github.com/1yihui/YiHui
compatibility	openclaw

OpenClaw Operations

Design Philosophy

This skill serves two core scenarios and nothing else:

1. Rescue — The main OpenClaw Gateway is down or broken. You (the rescue agent) need to diagnose the root cause, fix it, and bring the gateway back online.
2. Health Check — The main OpenClaw Gateway is running. You need to verify its operational health, clean up resources, or perform maintenance tasks like upgrades.

What this skill is NOT for:

• Day-to-day business configuration (adding channels, configuring agents, setting up integrations)
• Application-level issues (agent behavior, prompt tuning, skill management)
• Initial deployment or first-time setup (use openclaw daemon install and openclaw configure)

Principle: Diagnose → Judge → Act → Verify. Never skip steps.

Platform Detection

Detect the platform first — commands differ between Linux (systemd) and macOS (launchd):

OS=$(uname -s)  # "Linux" or "Darwin"
echo "Platform: $OS"

Port Detection

Do NOT assume port 18789. Detect the actual configured port first:

PORT=$(openclaw config get gateway.port 2>/dev/null | grep -oE '[0-9]+')
PORT=${PORT:-18789}  # fallback to default only if config unavailable
echo "Gateway port: $PORT"

Use $PORT in all port-related commands throughout this guide.

---

Scenario A: Rescue (Gateway Down)

Follow these sections in order when the main gateway is not running.

A1. Assess the Situation

# Is the service running at all?
# Linux:
systemctl --user status openclaw-gateway
# macOS:
launchctl list | grep openclaw

# Is the process alive?
pgrep -af openclaw

# Is the port listening?
# Linux:
ss -tlnp | grep 

lsof -iTCP: -sTCP:LISTEN