gateway-notify

# Gateway Notify

Automatically send notifications when the OpenClaw gateway starts up.

## What It Does

Creates a hook that triggers on `gateway:startup` events and sends a notification message to the user's preferred channel with gateway status information.

## Quick Start

Run the setup script with the user's messaging channel and address:

```bash
scripts/setup_gateway_notify.sh <channel> <address>
```

Examples:
```bash
scripts/setup_gateway_notify.sh imessage user@example.com
scripts/setup_gateway_notify.sh whatsapp +1234567890
scripts/setup_gateway_notify.sh telegram @username
```

The script will:
1. Create the hook directory at `~/.openclaw/hooks/gateway-restart-notify`
2. Generate the handler with the specified channel configuration
3. Enable the hook in OpenClaw config
4. Restart the gateway to activate

## How It Works

The hook uses OpenClaw's internal hook system:
- Listens for `gateway:startup` events
- Collects gateway status (model, time, port)
- Sends notification via the configured channel CLI

## Supported Channels

See [CHANNELS.md](references/CHANNELS.md) for channel-specific CLI commands and address formats.

## Manual Setup

If you need to customize the hook, see [MANUAL.md](references/MANUAL.md) for step-by-step instructions.

# Gateway Notify

Auto-notify when OpenClaw gateway restarts. Supports multiple messaging channels.

## Features

- 🚀 Automatic notification on gateway startup
- 📊 Shows model, time, and port info
- 🌐 Supports 5 channels: iMessage, WhatsApp, Telegram, Discord, Slack
- ⚡ One-command setup

## Quick Start

```bash
scripts/setup_gateway_notify.sh <channel> <address>
```

Examples:
```bash
scripts/setup_gateway_notify.sh imessage user@example.com
scripts/setup_gateway_notify.sh telegram @username
```

## Installation

### Method 1: From GitHub

```bash
git clone https://github.com/deemoartisan/gateway-notify.git
cd gateway-notify
scripts/setup_gateway_notify.sh imessage your@email.com
```

### Method 2: Download .skill file

Download `gateway-notify.skill` from releases and install:
```bash
openclaw skills install gateway-notify.skill
```

## Documentation

- [English Manual](SKILL.md)
- [中文手册](https://github.com/deemoartisan/gateway-notify/blob/main/gateway-notify使用手册.md)

## Supported Channels

| Channel | CLI Tool | Address Format |
|---------|----------|----------------|
| iMessage | `imsg` | Email or phone |
| WhatsApp | `wacli` | Phone with country code |
| Telegram | `openclaw message` | Username or Chat ID |
| Discord | `openclaw message` | Channel ID |
| Slack | `openclaw message` | Channel name or ID |

## License

MIT

## Author

哥们鼠 🦞