← 返回 Skills 市场
Swarm Janitor
作者
LvcidPsyche
· GitHub ↗
· v0.1.0
1293
总下载
2
收藏
2
当前安装
1
版本数
在 OpenClaw 中安装
/install swarm-janitor
功能描述
Enterprise-grade OpenClaw skill for cleaning up orphaned subagent processes, archiving transcripts to SuperMemory, and freeing disk space without losing work. Features dry-run mode, configurable retention policies, and comprehensive safety checks.
安全使用建议
Do not run the shell/python commands shown in SKILL.md until you have the actual implementation to inspect. Specific steps to take before installing or enabling automation:
- Verify origin: visit the claimed homepage (https://github.com/openclawdad/swarm-janitor) and confirm the repository contains the scripts (scripts/swarm_janitor.py) and matches the SKILL.md.
- Inspect the code: review the actual Python scripts for exactly how they detect processes, determine 'orphaned' sessions, and delete files. Look for any network calls, unexpected endpoints, or credential exfiltration.
- Confirm env and creds: SUPERMEMORY_API_KEY (and any S3 or other credentials) are referenced in config.yaml but not declared; understand where and how those values are used before supplying them.
- Test safely: run any discovered script in a safe test environment or a copy of your sessions directory with dry-run enabled. Do not run --clean --force on production until you’ve confirmed behavior.
- Check permissions: cron example writes to /var/log and may require root or elevated permissions; consider running under a restricted account and ensure proper backups exist.
- If you cannot find the implementation repo or the scripts referenced, treat the package as incomplete/untrustworthy and do not enable automated deletions.
Because the package is missing the executable scripts and has undeclared env and path implications, proceed cautiously; the inconsistencies could be benign (incomplete packaging) but could also hide risky operations if the missing code is later obtained from an untrusted source.
功能分析
Type: OpenClaw Skill
Name: swarm-janitor
Version: 0.1.0
The OpenClaw AgentSkills skill 'swarm-janitor' appears benign. Its stated purpose is to clean up orphaned subagent processes and archive transcripts, which involves file system access (deleting sessions, writing logs) and potential network access (archiving to SuperMemory, optional metrics webhook). All described actions and configurations in SKILL.md and references/config.yaml align with this legitimate maintenance function. There is no evidence of prompt injection, malicious execution, or intentional data exfiltration; the optional `webhook_url` for metrics in `references/config.yaml` is set to `null` by default, and SuperMemory archival is a core, stated feature.
能力评估
Purpose & Capability
The skill's functionality (scanning ~/.openclaw/agents/... sessions, archiving to SuperMemory, and deleting orphaned sessions) is coherent with its name and description. However the SKILL.md repeatedly instructs running python3 scripts/swarm_janitor.py and other local scripts which are not present in the package (no scripts/ directory or code files included). That mismatch is a major coherence problem: the README assumes code that isn't bundled. The skill also references writing logs to /var/log and archiving destinations (local, s3, supermemory) that would require additional configuration/dependencies not declared.
Instruction Scope
The instructions instruct the agent/user to scan and remove files under ~/.openclaw/agents/main/sessions/, archive transcripts to SuperMemory, and optionally run cron jobs that write to /var/log. Those are powerful file-system operations and deletions. The SKILL.md also documents a SUPERMEMORY_API_KEY variable in config comments but the skill metadata does not declare or require that env var. Importantly, the instructions assume the existence of scripts that aren't provided—so the declared runtime behavior is unsupported by the packaged content. The instructions are specific enough to cause destructive actions (e.g., --clean --force) if the missing implementation were present.
Install Mechanism
There is no install spec and the skill is instruction-only, which reduces installation risk (nothing will be automatically downloaded or executed by the platform). However, because the SKILL.md tells users to copy files to ~/.openclaw and to run python scripts that aren't included, this points to incomplete packaging (the actual implementation may be expected to come from the referenced GitHub repo). You should not run the described commands until you obtain and inspect the real script sources from a trustworthy repository.
Credentials
Registry metadata declares no required environment variables, but references/config.yaml explicitly documents SUPERMEMORY_API_KEY and notes it is required for SuperMemory archival. The skill will need filesystem write access to ~/.openclaw paths and possibly /var/log for cron examples; those privileges are not declared. The omission of SUPERMEMORY_API_KEY and any S3 credentials (if S3 destination used) is a proportionality/information gap that could lead users to provide sensitive credentials without clear disclosure in metadata.
Persistence & Privilege
The skill does not request always: true and uses default autonomous-invocation settings (normal). It doesn't attempt to modify other skills or system-wide agent settings in the provided instructions. However, its recommended cron usage and writing to /var/log imply persistent scheduled invocation and possible need for elevated permissions; combine that operational persistence with the other concerns before enabling automated runs.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install swarm-janitor - 安装完成后，直接呼叫该 Skill 的名称或使用
/swarm-janitor触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.1.0
Initial release of swarm-janitor.
- Automatically scans and cleans up orphaned OpenClaw subagent sessions.
- Safely archives transcripts to SuperMemory before deletion.
- Features dry-run mode, configurable retention policies, and robust safety checks.
- Generates detailed cleanup reports and logs all actions for auditability.
- Supports enterprise needs with flexible configuration, metrics export, and cron-based automation.
元数据
常见问题
Swarm Janitor 是什么？
Enterprise-grade OpenClaw skill for cleaning up orphaned subagent processes, archiving transcripts to SuperMemory, and freeing disk space without losing work. Features dry-run mode, configurable retention policies, and comprehensive safety checks. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 1293 次。
如何安装 Swarm Janitor？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install swarm-janitor」即可一键安装，无需额外配置。
Swarm Janitor 是免费的吗？
是的，Swarm Janitor 完全免费（开源免费），可自由下载、安装和使用。
Swarm Janitor 支持哪些平台？
Swarm Janitor 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Swarm Janitor？
由 LvcidPsyche（@lvcidpsyche）开发并维护，当前版本 v0.1.0。
推荐 Skills