← Back to Skills Marketplace
778
Downloads
2
Stars
7
Active Installs
6
Versions
Install in OpenClaw
/install gateway-notify
Description
Set up automatic notifications when OpenClaw gateway restarts. Use when user wants to be notified of gateway startup events via any messaging channel (iMessa...
README (SKILL.md)
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:
scripts/setup_gateway_notify.sh \x3Cchannel> \x3Caddress>
Examples:
scripts/setup_gateway_notify.sh imessage [email protected]
scripts/setup_gateway_notify.sh whatsapp +1234567890
scripts/setup_gateway_notify.sh telegram @username
The script will:
- Create the hook directory at
~/.openclaw/hooks/gateway-restart-notify - Generate the handler with the specified channel configuration
- Enable the hook in OpenClaw config
- Restart the gateway to activate
How It Works
The hook uses OpenClaw's internal hook system:
- Listens for
gateway:startupevents - Collects gateway status (model, time, port)
- Sends notification via the configured channel CLI
Supported Channels
See CHANNELS.md for channel-specific CLI commands and address formats.
Manual Setup
If you need to customize the hook, see MANUAL.md for step-by-step instructions.
Usage Guidance
This skill appears coherent with its purpose. Before installing: (1) inspect scripts/setup_gateway_notify.sh yourself — it creates files under ~/.openclaw/hooks and writes handler.ts; (2) ensure the messaging CLIs it will call (imsg, wacli, openclaw message) are the official/trusted binaries on your system — a malicious replacement binary with one of those names could be invoked; (3) optionally open the generated handler.ts after running the setup script to confirm the embedded address and command look correct; (4) if you are concerned about command injection, test with a dummy address and review the SAFE_ADDRESS escaping in the setup script. No extra credentials are requested by this skill.
Capability Analysis
Type: OpenClaw Skill
Name: gateway-notify
Version: 1.0.5
The gateway-notify skill is a utility designed to send notifications via messaging platforms (iMessage, WhatsApp, Telegram, etc.) whenever the OpenClaw gateway starts. The setup script (scripts/setup_gateway_notify.sh) creates a hook handler (handler.ts) that uses shell commands to send messages. The code demonstrates good security practices, including strict regex-based input validation for channel names and addresses, and proper shell escaping to prevent command injection. There is no evidence of malicious intent, data exfiltration, or unauthorized access.
Capability Assessment
Purpose & Capability
Name and description (notify on gateway startup) align with the files and script. The setup script only creates a hook under ~/.openclaw/hooks/gateway-restart-notify, generates HOOK.md and handler.ts, enables the hook, and asks the user to restart the gateway. No unrelated cloud credentials or global config paths are requested.
Instruction Scope
SKILL.md and setup script stay within the described scope: they write to the skill's hook directory, enable the hook, and the handler only collects timestamp and a hardcoded port. The handler executes external CLI commands (imsg, wacli, openclaw message) to send notifications — this is expected for a notification skill but means the skill will invoke local binaries. The script performs input validation and attempts to escape single quotes before embedding the address into handler.ts.
Install Mechanism
Instruction-only skill with no install spec; the only code written to disk is created by the provided setup script in the user's home directory. No remote downloads or archive extraction are performed by the skill itself.
Credentials
No environment variables, secrets, or external credentials are requested. The messaging address is provided by the user at setup. The handler does not read OpenClaw config files (project changelog/SECURITY.md explicitly documents removal of config reads).
Persistence & Privilege
The skill does not request always: true and does not modify other skills. It enables a hook via the OpenClaw CLI (openclaw hooks enable) which is the expected mechanism for registering event handlers.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gateway-notify - After installation, invoke the skill by name or use
/gateway-notify - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
Version 1.0.5 of gateway-notify
- No changes detected in this release.
v1.0.4
- Updated all references from "OpenAWS" to "OpenClaw" to reflect correct gateway software.
- No functional or code changes; documentation clarity improved.
v1.0.3
- Updated iMessage example address in the Quick Start section to use [email protected] instead of a numeric QQ address.
- No functional or code changes; documentation wording improved for clarity and consistency.
v1.0.2
Version 1.0.2 of gateway-notify
- No file changes detected in this release.
- Functionality and documentation remain unchanged from the previous version.
v1.0.1
gateway-notify 1.0.1
- No changes to code or documentation were detected in this release.
- Functionality and usage remain the same as the previous version.
v1.0.0
- Initial release of gateway-notify.
- Automatically sends notifications on OpenAWS gateway startup events.
- Supports multiple messaging channels, including iMessage, WhatsApp, Telegram, and Discord.
- Simple setup via included shell script with custom channel and address.
- Provides manual setup instructions and channel reference documentation.
Metadata
Frequently Asked Questions
What is gateway-notify?
Set up automatic notifications when OpenClaw gateway restarts. Use when user wants to be notified of gateway startup events via any messaging channel (iMessa... It is an AI Agent Skill for Claude Code / OpenClaw, with 778 downloads so far.
How do I install gateway-notify?
Run "/install gateway-notify" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is gateway-notify free?
Yes, gateway-notify is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does gateway-notify support?
gateway-notify is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created gateway-notify?
It is built and maintained by Deemo (@deemoartisan); the current version is v1.0.5.
More Skills