# Health Checks on macOS

## Overview

This documentation explains monitoring linked channel health through the macOS menu bar application, including status indicators, settings, and diagnostic procedures.

## Key Features

### Status Indicator

The menu bar displays a colored dot reflecting channel health:

- **Green**: linked + socket opened recently
- **Orange**: connecting/retrying
- **Red**: logged out or probe failed

A secondary line shows authentication age or failure details.

### Settings Interface

The Health card within Settings displays:

- Linked authentication age
- Session storage information
- Last check timestamp

Users can manually trigger checks and access logs through dedicated buttons.

### Diagnostic Process

The system executes `openclaw health --json` approximately every 60 seconds and on-demand. This probe loads creds and reports status without sending messages, maintaining separate caches for successful and failed snapshots.

## Alternative Approaches

For additional troubleshooting, reference the Gateway health section. Recommended CLI commands include:

```bash
openclaw status
openclaw status --deep
```

Review log files at `/tmp/openclaw/openclaw-*.log` for connection-related events.
