← Back to Skills Marketplace
1128
Downloads
1
Stars
10
Active Installs
6
Versions
Install in OpenClaw
/install system-maintenance
Description
Complete maintenance system for OpenClaw with unified architecture, filesystem governance, and cross-platform design
Usage Guidance
Do not run installer scripts or the package's maintenance scripts without manual review. Specific steps to reduce risk:
- Inspect the upstream GitHub repo linked in SKILL.md (https://github.com/jazzqi/openclaw-system-maintenance) and verify the scripts/ directory and install scripts exist and are what you expect.
- Do not run install-maintenance-system.sh or any other installer as root; open the script first and review its contents.
- Verify the scripts that would be placed into crontab before installing; back up your current crontab (crontab -l > crontab.bak) so you can restore it.
- The published package here lacks the referenced scripts and entry.js contains duplicated/malformed sections (uses fs without requiring it and has multiple CLI blocks). Ask the author to publish a complete, consistent package or provide the scripts inline.
- If you want to test: run inside an isolated VM or container, and run monitoring/cleanup scripts in --dry-run/test modes first (SKILL.md indicates some scripts support --dry-run/--test).
- If you need this capability, prefer installing from the verified upstream repo (after review) rather than blindly running recommended one-click installers.
Capability Analysis
Type: OpenClaw Skill
Name: system-maintenance
Version: 1.3.2
The skill bundle performs high-risk system operations including arbitrary shell command execution via 'execSync' and modification of the user's crontab for persistence. While these actions are aligned with the stated purpose of system maintenance, the 'entry.js' file is syntactically malformed, containing redundant logic and function definitions outside of the class structure that would cause runtime errors. The instructions in 'SKILL.md' also encourage high-risk patterns such as 'curl | bash' style installations and manual permission changes ('chmod +x'), which increase the attack surface without providing sufficient security safeguards.
Capability Assessment
Purpose & Capability
The skill claims a full maintenance system and the code/instructions show maintenance tasks (monitoring, log cleanup, backups, cron install). However the SKILL.md references many shell scripts (scripts/*.sh) and a scripts/ directory that are not present in the package manifest. The package contains entry.js which invokes those scripts and other paths that don't exist in this bundle, indicating the published package is incomplete or mispackaged.
Instruction Scope
SKILL.md instructs users/agents to clone a repo, chmod and run several installer and maintenance scripts, and to install cron tasks. entry.js executes shell commands via child_process.execSync, performs deletions (find ... -delete on /tmp paths), runs curl against localhost:18789, reads disk/workspace sizes, and writes to crontab. These actions are within a maintenance skill's scope but are potentially destructive/persistent — and the instructions assume scripts exist that are not bundled here. The SKILL.md is also permissive about installing/running remote install scripts (bash scripts), which increases risk.
Install Mechanism
There is no formal install spec; this is effectively instruction-only. SKILL.md suggests git-clone or a bunx clawhub install that would pull content from GitHub — running the recommended git/one-click install would execute shell installers referenced in the repo. Because the package as published is missing the scripts directory, the instructions will either fail or prompt the user to fetch/execute code from the remote GitHub. Executing remote install scripts without inspection is higher risk.
Credentials
The skill does not request environment variables or external credentials. The code touches local system resources (/tmp, ~/.openclaw/workspace, crontab) and queries localhost endpoints; these are consistent with a system maintenance purpose and do not demand unrelated credentials.
Persistence & Privilege
The skill (and SKILL.md) explicitly installs cron jobs and instructs running installer scripts that create persistent scheduled tasks and backups. The package metadata does not set always:true, but the capability to modify system crontab and install long-running maintenance scripts means the skill will create persistence on the host when used — be aware this persists beyond the agent process.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install system-maintenance - After installation, invoke the skill by name or use
/system-maintenance - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.2
Updated to version 1.3.2 with core maintenance functionality
v1.3.0
**Version 1.3.0 Changelog**
- Added comprehensive Chinese documentation (`README.zh-CN.md`, `SKILL.zh-CN.md`).
- Introduced pre-commit safety and quality checks (`pre-commit-checklist.md`, `scripts/check-before-commit.sh`).
- Added platform analysis and cross-platform architecture documentation.
- Included automated version update reporting (`VERSION_UPDATE_REPORT.md`).
- Updated existing documentation to reflect new features and to support multilingual usage.
- Revised `package.json` and other core files for improved maintainability.
v1.2.1
- 移除所有旧的备份和历史脚本文件，精简存储空间。
- 新增 FINAL_RELEASE_REPORT.md 和 README.md 文件，补充文档说明。
- 精简和清理了无用维护脚本和旧系统配置相关内容，便于维护和管理。
- 保留核心维护功能及当前架构文档，确保主系统正常运行。
v1.2.0
v1.2.0 introduces a unified, modular architecture for OpenClaw system maintenance with enhanced reporting and migration support.
- Added weekly optimization script and enhanced real-time monitoring, daily maintenance, and log management scripts
- Introduced full migration and rollback guides, backup strategies, and final status/optimization report templates
- Improved health scoring system and macOS compatibility
- Unified documentation, reduced script redundancy, and enhanced safety features
- Removed outdated/duplicated scripts and old backup/config directories
v1.1.0
v1.1.0 introduces a unified maintenance system with significant enhancements:
- Added real-time monitoring, advanced log management, installation, and configuration scripts.
- Introduced schedule-based configuration (schedule.json) for flexible task management.
- Implemented backup, restore, and integration scripts for safer maintenance.
- Improved system architecture with layered maintenance (real-time, daily, weekly) and standardized log output.
- Ensured backward compatibility by retaining previous scripts while adding new features.
v1.0.0
system-maintenance v1.0.0
- 初始版本发布
- 提供日志清理、内存整理、Token 优化和系统维护自动化功能
- 包含日常维护及定时任务脚本
- 支持磁盘、Gateway 状态、定时任务等多项系统监控
- 提供详细设置指南和最佳实践建议
Metadata
Frequently Asked Questions
What is System Maintenance?
Complete maintenance system for OpenClaw with unified architecture, filesystem governance, and cross-platform design. It is an AI Agent Skill for Claude Code / OpenClaw, with 1128 downloads so far.
How do I install System Maintenance?
Run "/install system-maintenance" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is System Maintenance free?
Yes, System Maintenance is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does System Maintenance support?
System Maintenance is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created System Maintenance?
It is built and maintained by jazzqi (@jazzqi); the current version is v1.3.2.
More Skills