← Back to Skills Marketplace
davidme6

Openclaw Gateway Guardian

by davidme6 · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ⚠ suspicious
259
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install openclaw-gateway-guardian
Description
OpenClaw Gateway Guardian - Automatic monitoring, protection, and restart of OpenClaw Gateway service. Prevents gateway from stopping, crashing, or disappear...
Usage Guidance
This package is not clearly dishonest or malicious, but it has multiple inconsistencies you should resolve before installing: - Confirm the presence and trustworthiness of the `openclaw` CLI on the host; the guardian calls `openclaw gateway restart` but the skill metadata does not declare that binary as required. - The README/SKILL.md mention commands (init, health) and notification features that the included script does not implement — expect limited functionality (start/stop/status/logs) as shipped. - The docs encourage creating scheduled tasks (even under SYSTEM); avoid running unfamiliar scripts as SYSTEM. If you need autostart, prefer running under a dedicated low-privilege service account and review the install script (there are references to an install_powerShell script that is not present in the package manifest). - Inspect the script yourself (it is small): it writes files under ~/.openclaw_guardian, creates PID/state files, and uses subprocess to restart the gateway. Run it in a safe test environment first to confirm behavior. - If you plan to rely on notifications, verify whether those features are implemented or implement them yourself; do not paste secrets into configs unless you understand where they will be used. If the author can (a) declare the `openclaw` binary requirement, (b) update/remove docs so commands match the actual script (or ship an updated script implementing init/health/notifications), and (c) avoid recommending SYSTEM-level scheduled tasks or clearly explain why elevated privileges are required, the package would be much more coherent and easier to trust.
Capability Analysis
Type: OpenClaw Skill Name: openclaw-gateway-guardian Version: 1.0.3 The bundle is a utility designed to monitor and automatically restart the OpenClaw Gateway service. The primary logic in `scripts/gateway_guardian.py` performs health checks via TCP port monitoring and uses hardcoded subprocess calls to restart the service if it fails. While the documentation (README.md, SKILL.md) claims to support notifications that are not yet implemented in the provided Python script, and includes highly specific local environment paths (e.g., in STATUS.md), there is no evidence of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
The stated purpose (monitor and restart an OpenClaw gateway) matches the script's behavior: it checks a local port and calls `openclaw gateway restart`. However the package metadata does not declare the openclaw CLI as a required binary even though the code depends on it. Documentation promises notification channels (Feishu/Telegram/WeChat) and an 'init' workflow that the shipped script does not implement. These are inconsistencies between claimed capabilities and actual implementation.
Instruction Scope
SKILL.md (and other docs) instruct users to run commands such as `python scripts/gateway_guardian.py init`, `health`, and references to logs/health/notifications — but the included Python script only supports start|stop|status|logs. The docs also recommend creating scheduled tasks that run as SYSTEM. The runtime instructions therefore ask the agent/user to perform actions the shipped code does not support or that escalate privileges; this is scope creep and can mislead operators.
Install Mechanism
There is no external install spec or downloads — the skill is instruction-only with a local Python script and a small requirements.txt (aiohttp). That lowers supply-chain risk. No network-download install steps or obscure URLs are present in the package itself.
Credentials
The skill declares no required environment variables, but the documentation and example config reference notification tokens and webhooks. The runtime script does not read environment secrets (notifications are disabled by default), but it depends on an external `openclaw` CLI which is not declared in metadata. Also docs suggest running scheduled tasks as SYSTEM (implying higher privileges) without documenting why such privilege is needed.
Persistence & Privilege
The package instructs (in multiple docs) how to create an OS-level scheduled task and even shows it running under the SYSTEM account. The skill metadata itself doesn't request persistent/global privileges, but the install/deployment instructions encourage configuration that would run the guardian with system-level privileges. Combined with the undeclared dependency on an external CLI, this is a privilege-related concern and should be a conscious operator decision rather than a default.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclaw-gateway-guardian
  3. After installation, invoke the skill by name or use /openclaw-gateway-guardian
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Updated scripts/gateway_guardian.py. - Internal code improvements or fixes (details not provided). - No user-facing documentation changes. - Version updated to 1.0.3.
v1.0.2
- Updated scripts/gateway_guardian.py (details of changes not specified). - No changes to documentation (SKILL.md remains at version 1.0.0). - Incremented skill version to 1.0.2.
v1.0.1
- Added main script: scripts/gateway_guardian.py, implementing the core monitoring and protection logic. - Initial release of OpenClaw Gateway Guardian skill.
v1.0.0
Initial release of OpenClaw Gateway Guardian. - Provides automatic monitoring, protection, and restart of the OpenClaw Gateway service. - Features real-time health checks (port and process), health logging, and process protection against multiple instances. - Supports up to 10 auto-restart attempts if the gateway fails. - Offers multi-channel notifications through Feishu, Telegram, and WeChat. - Includes flexible configuration and command-line utilities for status, logs, and health reports.
Metadata
Slug openclaw-gateway-guardian
Version 1.0.3
License MIT-0
All-time Installs 1
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is Openclaw Gateway Guardian?

OpenClaw Gateway Guardian - Automatic monitoring, protection, and restart of OpenClaw Gateway service. Prevents gateway from stopping, crashing, or disappear... It is an AI Agent Skill for Claude Code / OpenClaw, with 259 downloads so far.

How do I install Openclaw Gateway Guardian?

Run "/install openclaw-gateway-guardian" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Openclaw Gateway Guardian free?

Yes, Openclaw Gateway Guardian is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Openclaw Gateway Guardian support?

Openclaw Gateway Guardian is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Openclaw Gateway Guardian?

It is built and maintained by davidme6 (@davidme6); the current version is v1.0.3.

💬 Comments