Menu
Diagnose and fix OpenClaw gateway and node host issues. Use when openclaw services have warnings, connection failures, pairing errors, or port conflicts.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Fix Claude Code appearing logged-out over SSH on a headless macOS machine — its credentials sit in the login keychain, which stays locked in SSH/headless sessions. Offers two fixes and asks the user to choose: a keychain-free long-lived OAuth token (recommended), or auto-unlocking the login keychain with a stored password. Use when Claude Code shows unauthenticated over SSH on a Mac, when setting up a Mac mini or headless Mac for remote/CI Claude Code use, or when `security show-keychain-info` reports the login keychain locked.
Attach popular brand prefixes/suffixes to a seed word and check each `.com` via Verisign RDAP. Use when the user names a word and asks for prefix/suffix `.com` variants, or wants domains generated by adding endings like -ly/-ify/-hub or beginnings like open-/get-/go-.
Set up Google Chrome on macOS to always launch with the Chrome DevTools Protocol enabled (127.0.0.1:9222) via a Dock launcher app, so local AI agents (Playwright, Puppeteer, browser-use, OpenClaw) can drive the real logged-in browser. Use when the user wants to enable a CDP/remote-debugging port for Chrome, connect an agent to Chrome, test a CDP connection, or troubleshoot/revert an existing Chrome-CDP Dock setup.
Use when setting up a Mac (especially Mac Mini or Apple Silicon Mac Studio) for unattended 24/7 server operation, headless use, or remote-only access. Covers sleep prevention, screen saver, Wake-on-LAN, auto-restart, App Nap, SSH enablement, and — on Apple Silicon — a caffeinate LaunchDaemon that stops the headless display from parking (physical panel and VNC/screen-share going black even with displaysleep=0). Targets macOS 15 (Sequoia) and later.
Build a patched, fully-stealth RustDesk.app from source on Apple Silicon, from a maintained private fork — no menu-bar icon, no Dock icon, no on-screen CM panel compiled in, remote keyboard still works, codesigned and ready to deploy. Use when building or version-bumping the stealth RustDesk binary; deploy the result with the deploy-stealth-rustdesk skill.
Deploy a prebuilt stealth-patched RustDesk.app as an unattended macOS LaunchAgent service — no Dock icon, no menu-bar icon, no on-screen CM panel, remote keyboard still works, survives reboot with nobody logged in. Use when installing a stealth RustDesk on a target Mac; build the app first with the build-stealth-rustdesk skill.
| name | openclaw-diagnose |
| description | Diagnose and fix OpenClaw gateway and node host issues. Use when openclaw services have warnings, connection failures, pairing errors, or port conflicts. |
| allowed-tools | Bash Read Grep |
When the user asks you to diagnose or fix OpenClaw gateway/node issues, follow this structured investigation.
Run these in parallel:
openclaw gateway status
openclaw node status
openclaw nodes status
openclaw nodes pending
Look for these common issues:
ai.openclaw.gateway and ai.openclaw.node are registered as LaunchAgentslaunchctl print gui/$(id -u)/<label> to inspect each servicelsof -iTCP:<port> -sTCP:LISTEN -P to confirm which process owns the port~/.openclaw/logs/node.err.log for pairing required or ECONNREFUSEDopenclaw nodes pending to find the pending requestopenclaw nodes approve <requestId>openclaw node restart) and immediately re-check pending + approvelsof -iTCP:<port> -sTCP:LISTEN -Popenclaw gateway restartKeepAlive: true so it will automatically reconnect once the gateway is upAfter taking corrective action, confirm health:
openclaw nodes status # Should show: paired · connected
openclaw nodes pending # Should show: No pending pairing requests
tail -5 ~/.openclaw/logs/node.err.log # Check for new errors
ai.openclaw.gateway): WebSocket server that listens on a port (default 18789)ai.openclaw.node): Client that connects to the gateway via WebSocket to register capabilities (browser, system commands)--host and --port flags on openclaw node run specify the gateway address to connect to, not a port to bind~/Library/LaunchAgents/ai.openclaw.node.plist~/Library/LaunchAgents/ai.openclaw.gateway.plist~/.openclaw/logs/node.log and ~/.openclaw/logs/node.err.log