OpenClaw Operations (openclaw-ops) for Openclaw

A specialized operational toolkit designed for rescue agents to diagnose, repair, and maintain OpenClaw Gateway instances.

dinstein
v1.2.1
Feb 25, 2026
0
1.6k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install openclaw-ops

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install openclaw-ops using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is OpenClaw Operations (openclaw-ops)?

The openclaw-ops skill is an essential utility for developers and system administrators managing AI agent infrastructure. It provides a structured framework for two critical scenarios: rescuing a gateway that is down and performing routine health maintenance on a running service. By integrating deeply with platform-specific service managers like systemd on Linux and launchd on macOS, it enables precise control over the gateway lifecycle. This skill ensures that your environment remains stable, making it a cornerstone for those deploying professional-grade Openclaw Skills.

OpenClaw Operations (openclaw-ops) Use Cases

  • Diagnosing root causes for gateway crashes or port conflicts.
  • Repairing corrupted openclaw.json configuration files with automated validation.
  • Performing safe software upgrades with built-in backup and rollback procedures.
  • Managing disk space by cleaning up old session transcripts and orphan files.
  • Troubleshooting network connectivity and reverse proxy setups like Tailscale Serve.

How OpenClaw Operations (openclaw-ops) Works

  1. The skill first detects the host platform (Linux or macOS) and identifies the active gateway port.
  2. It assesses the service status using system logs and process monitors to locate errors.
  3. Based on the diagnosis, it performs configuration repairs or resource cleanups while maintaining timestamped backups.
  4. It executes service restarts using platform-native commands (systemctl or launchctl).
  5. Finally, it runs a comprehensive health check via the doctor utility to verify that the system is fully operational.

OpenClaw Operations (openclaw-ops) Setup

To utilize this skill, ensure you have the OpenClaw CLI and Node.js 18+ installed on your machine. Access to the configuration directory is required.

# Check the current status of your gateway
openclaw status

# Run the health doctor to identify issues
openclaw doctor

# If safe repairs are needed
openclaw doctor --fix

OpenClaw Operations (openclaw-ops) Data Schema & Taxonomy

The skill manages data within the standard OpenClaw directory structure, ensuring high portability and clear metadata taxonomy.

Path Purpose
~/.openclaw/openclaw.json The primary gateway configuration file.
~/.openclaw/env Contains environment variables and secure tokens.
~/.openclaw/agents/ Per-agent configurations and session transcript logs.
~/.openclaw/workspace/ The designated area for agent file operations.
~/.openclaw/logs/ System-level logs for gateway performance tracking.

OpenClaw Operations (openclaw-ops) Advanced Features

  • Automated JSON syntax validation using Python to prevent service failures.
  • Support for Tailscale Serve integration to manage secure public URLs for local gateways.
  • Deep-scan capabilities to find and resolve conflicting gateway installations across the system.
  • Non-interactive mode for automated maintenance scripts and CI/CD pipelines.
  • Comprehensive backup routines that capture core configurations, service files, and agent data.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*