Support
Get help with ClawSentinel.
Settings Reference
Monitoring Intervals
How often ClawSentinel pings the gateway to check if it's responding. A lower value means faster detection of outages but slightly higher CPU use. 30 seconds is the recommended default for most setups.
How often ClawSentinel runs the full diagnostic suite — checking memory, processes, port conflicts, and more. More thorough than a health check but heavier. 120 seconds is the recommended default.
Alert Thresholds
Shows a yellow warning in the Status tab when your OpenClaw session token usage exceeds this level. A prompt reminder to think about wrapping up your current context.
Shows a red critical alert when token usage exceeds this level. At this point, consider starting a new session soon to avoid hitting the context limit mid-task.
Automation
When enabled, ClawSentinel will automatically run openclaw gateway restart after two consecutive failed health checks. Disable this if you prefer to receive alerts and handle restarts yourself.
Allows ClawSentinel to automatically repair known issues — for example, re-registering the LaunchAgent plist when it goes missing. Disable this if you prefer to review and approve repairs manually before they run.
Notifications
Receive standard macOS notifications when recovery fails or diagnostics need your attention. Note: if auto-recovery handles an issue silently and successfully, you won't be notified for that routine recovery.
Gateway Connection
The host where your OpenClaw gateway runs. Leave this as the default unless you have a non-standard or remote gateway setup.
The port your OpenClaw gateway listens on. Change this only if you configured OpenClaw to use a non-default port.
CLI Overrides
Leave blank for auto-detection. ClawSentinel checks /opt/homebrew/bin and /usr/local/bin by default. Set this if OpenClaw is installed somewhere else. Run which openclaw in Terminal to find the path.
Leave blank for auto-detection. Set this only if Node.js is installed in a non-standard location and ClawSentinel is having trouble finding it.
Logs Tab
Filter the live log view by severity: All, INFO, WARN, or ERROR. Useful for cutting through noise when diagnosing a specific issue.
Filter the log view by keyword. Useful for finding entries related to a specific component or error message.
Save the current log output to a file. Handy when sharing logs with support to help diagnose a problem.
Clears the current log view. This does not delete the underlying log files — it just resets what's displayed.
Toggle whether the log view automatically scrolls to new entries as they come in. Turn this off when you need to read back through older entries without losing your place.
License
Your license is active on this machine. ClawSentinel supports up to 3 simultaneous activations per license key.
Removes this Mac's activation slot. Use this before transferring ClawSentinel to a new machine. You can re-activate with the same license key on any Mac — up to 3 activations total.
Reset to Defaults
Resets all settings to factory defaults. This does not affect your license activation — your license key remains valid after a reset.
Common Issues
ClawSentinel can't find my OpenClaw install.
Use the CLI Override field in Settings to specify the exact path — for example, /opt/homebrew/bin/openclaw. You can find the correct path by running which openclaw in Terminal.
Auto-recovery isn't working.
Make sure Enable Auto-Recovery is checked in Settings. ClawSentinel waits for 2 consecutive failed health checks before attempting a restart — depending on your Health Check Interval, this can take up to 60 seconds. If recovery still doesn't fire, check the Diagnostics tab for details on what the health check is seeing.
I'm getting token capacity warnings even though my session is fine.
Try lowering your Health Check Interval in Settings so ClawSentinel gets fresher data more frequently. You can also click Run Diagnostics in the Diagnostics tab to force a fresh check immediately.
How do I move ClawSentinel to a new Mac?
Click Deactivate License in Settings on your current Mac to free up the activation slot. Then install ClawSentinel on the new Mac and activate using the same license key. You have up to 3 activations total.
How do I uninstall ClawSentinel?
Quit ClawSentinel from the menu bar icon, then drag the app from your Applications folder to Trash. No background processes, LaunchAgents, or hidden files remain after quitting.