Skip to content
TrustedSkillsbeta
Back to all skills

Restart Guard

Listed
Zjianru·v2.2.0·agents·MIT

Safe OpenClaw gateway restart with state-machine verification. Preserves context across restarts and sends post-restart ACK via Telegram, Discord, Slack, or custom webhook.

Repository

Install on your platform

Showing OpenClaw.

  1. 1

    Run this in your terminal

    terminal
    $ openclaw skills install restart-guard

What we know about this skill

Publisher

Zjianru

Taken from the source listing. We haven't verified who controls this account.

Install target

Pinned to 96c32cf2

Installs fetch a stored snapshot of that commit, so the code can't change after the fact.

No human has reviewed this code. The checks below are a static scan of the files at one commit — nobody has run this skill or judged whether it works. A skill runs with whatever access you give your agent, so read the source before you install it.

Automated safety checks

scanned

This skill failed 2 of 6 checks. A failure is not proof of bad intent; it means something in the code needs a human to look at it before you run it.

  • No undeclared network calls: failed

    Contacts 1 host that is neither well-known infrastructure nor declared in the skill's frontmatter: api.telegram.org.

    Every host the skill dials — from its scripts, its config endpoints or the commands it tells the agent to run — is either well-known package and API infrastructure or declared in its own frontmatter. Links in documentation are not counted.

    Hosts contacted

    api.telegram.orgundeclared

    What it found

    • scripts/notify.py:199contacts api.telegram.org
      f"https://api.telegram.org/bot{token}/sendMessage",

  • No credential access: failed

    Touches credential material in 3 places.

    Neither the code nor the SKILL.md instructions read SSH keys, cloud credentials, keychains, token stores, browser cookie databases or dotfiles that hold secrets.

    What it found

    • scripts/notify.py:11environment file outside the project
      env_path = os.path.expanduser("~/.openclaw/.env")
    • scripts/restart.py:741environment file outside the project
      env_file = os.path.expanduser("~/.openclaw/.env")
    • tests/test_security_fixes.py:215environment dumped into a network call
      os.environ["RESTART_GUARD_WEBHOOK_URL"] = "http://example.com/webhook"

  • Declares what it does: passed

    SKILL.md parses and declares a name and a description.

    SKILL.md exists, its frontmatter parses, and it declares a name and a description.

  • No obfuscated payloads: passed

    No encoded or obfuscated payloads.

    No base64, hex or compressed blob is decoded and then executed, and no encoded shell commands.

  • No pipe-to-shell installers: passed

    No pipe-to-shell or download-and-run installers.

    No `curl … | sh` pattern, in the code or in the instructions, that runs code fetched at run time.

  • Pinned to a commit: passed

    Scanned zjianru/restart-guard at 96c32cf276.

    The exact upstream commit SHA that was scanned is recorded, so the result refers to specific bytes.

Commit
96c32cf276
Manifest
SKILL.md
Scanned
22 files, 5,113 lines
This is a static scan, not a review. It reads the skill's files; it does not run them, and it cannot tell you whether the skill is any good or whether the code does what its description says. A skill runs with whatever access you give your agent.
What each check looks for →

About this skill

What it does

The restart-guard skill provides a deterministic way to restart an OpenClaw gateway while preserving the existing context and proactively reporting results back to the originating session. It ensures a controlled restart process, handling the transition with a guardian script that monitors the gateway's health and confirms successful resumption. The user experience focuses on simplicity – just expressing the intent to restart is sufficient.

When to use it

  • Configuration Changes: After making changes to the OpenClaw configuration, use restart-guard to ensure a clean and controlled restart.
  • Troubleshooting Issues: If experiencing unexpected behavior or errors within the gateway, a restart initiated by this skill can help resolve underlying problems.
  • Scheduled Maintenance: Implement restarts as part of regular maintenance routines without disrupting user sessions significantly.
  • Automated Restart Flows: Integrate restart-guard into automated workflows to handle restarts based on specific triggers or conditions.

Key capabilities

  • Deterministic OpenClaw gateway restart.
  • Context preservation during the restart process.
  • Proactive reporting of results back to the originating session.
  • Automatic discovery of enabled channels for notifications.
  • Supports generic channel passthrough (e.g., Feishu).
  • Uses a disaster route (origin -> agent:main:main -> external broadcast) with retry budget.

Example prompts

  • "可以重启了" (Can I restart?)
  • "restart now"
  • “Please restart the gateway”

Tips & gotchas

The skill automatically discovers enabled channels from openclaw.json and the skill configuration, so no manual channel arguments are typically required for basic usage. Ensure that the necessary configurations in ~/.openclaw/custom/config/restart-guard.yaml are set up correctly before attempting to use the skill.

Requirements

Required binaries

python3curl

Environment variables

GATEWAY_AUTH_TOKEN

This skill expects these to be set in its environment — it will have access to their values.

Tags

gatewayrestartmonitoringsafetywatchdognotification