openclaw-cleaner OpenClaw Skill

OpenClaw 临时文件自动清理工具。扫描 ~/.openclaw/workspace/ 下的临时文件，按规则自动归档或删除，防止工作区膨胀。面向 ClawHub 小白用户，默认安全（dry-run）+ 自动备份归档。

v1.0.0 Recently Updated Updated 2 days ago

Installation

clawhub install cleaner4rookies

Requires npm i -g clawhub

View on ClawHub Download .zip

56

Downloads

0

Stars

0

current installs

0 all-time

1

Versions

EU-Hosted Inference API

Power your OpenClaw skills with
the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

openclaw-cleaner 🧹

清理 OpenClaw 临时文件，防止工作区膨胀。默认安全，值得信赖。

功能

自动扫描 ~/.openclaw/workspace/ 下的临时文件（音频/文档/图片/日志等）
支持归档（安全移走）和删除两种处理方式
默认 dry-run：先显示清理预览，确认后才执行
操作前自动创建归档目录，文件不会凭空消失
支持 cron 定时或手动触发
白名单机制：重要文件永不误删

安装

npx skills add ~/.openclaw/workspace/skills/openclaw-cleaner

或手动安装：

            git clone https://github.com/your-repo/openclaw-cleaner.git ~/.openclaw/workspace/skills/openclaw-cleaner
          

快速开始

1. 预览（推荐先跑）

bash ~/.openclaw/workspace/skills/openclaw-cleaner/scripts/cleaner.sh

输出示例：

            ═══════════════════════════════════════════
  🧹 openclaw-cleaner
  模式: 🔍 dry-run（只显示，不删除）
═══════════════════════════════════════════

━━ 归档规则 ━━
  [Telegram等下载文件尽快分流] (3 个文件)
    🔍 [dry-run] doc1.docx (12K)
    🔍 [dry-run] doc2.pdf (8K)

━━ 删除规则 ━━
  [测试音频残留，无保留价值] (2 个文件)
    🔍 [dry-run] lobster-test.mp3 (128K)
          

2. 正式执行

加 --force 才真正删/归档：

bash ~/.openclaw/workspace/skills/openclaw-cleaner/scripts/cleaner.sh --force

配置

编辑 ~/.openclaw/workspace/cleaner.yaml（不存在则自动使用内置 config.yaml）：

            # 清理规则
rules:
  - pattern: "*.mp3 *.wav *.m4a"
    action: delete
    age_days: 0          # 0 = 立即

  - pattern: "*.docx *.doc *.pdf"
    action: archive       # 移到归档目录
    age_days: 1           # 超过1天触发

  - pattern: "*.png *.jpg *.gif"
    action: delete
    age_days: 7           # 超过7天触发

  - pattern: "media/inbound/*"
    action: archive
    age_days: 3

# 执行控制
dry_run: true             # 默认预览，要关闭设为 false
archive_dir: "~/.openclaw/workspace/cleaner-archive"
cron_schedule: ""         # 填 "0 3 * * *" = 每天凌晨3点

# 白名单（绝对路径，不会被删除）
whitelist:
  - "~/.openclaw/workspace/SOUL.md"
  - "~/.openclaw/workspace/MEMORY.md"
          

cron 定时任务

在 cleaner.yaml 里填入 cron 表达式：

cron_schedule: "0 3 * * *"   # 每天凌晨3点

或手动通过 OpenClaw cron 管理：

            cron add --name "openclaw-cleaner" \
  --schedule "0 3 * * *" \
  --command "bash ~/.openclaw/workspace/skills/openclaw-cleaner/scripts/cleaner.sh --force"
          

⚠️ 强烈建议：首次用 cron 前，先手动跑一次 dry-run，确认规则符合预期。

安全特性

特性	说明
默认 dry-run	永远先显示预览，不直接操作
自动归档	删除改为归档到 `cleaner-archive/`，可恢复
白名单	显式声明的文件永不删除
详细日志	记录每个文件的处理结果

卸载

            rm -rf ~/.openclaw/workspace/skills/openclaw-cleaner
rm -rf ~/.openclaw/workspace/cleaner-archive
# 如有 cron，手动删除对应的 cron job
          

故障排除

问题	解法
"未找到配置文件"	确认 `~/.openclaw/workspace/cleaner.yaml` 或 `config.yaml` 存在
想恢复归档的文件	去 `~/.openclaw/workspace/cleaner-archive/` 找
某些文件不该删	加入 `whitelist` 列表
dry-run 显示 0 个文件	说明没有符合条件（时间阈值未到）的文件

更新日志

v1.0.0

首发：支持归档/删除、白名单、dry-run、cron 定时

Statistics

Downloads 56

Stars 0

Current installs 0

All-time installs 0

Versions 1

Comments 0

Created Apr 22, 2026

Updated Apr 22, 2026

Author

beforesun

@beforesun

Latest Changes

v1.0.0 · Apr 22, 2026

工作区越来越卡？openclaw-cleaner 自动清理 OpenClaw 临时文件，支持归档备份，默认安全预览，零门槛上手。

Quick Install

clawhub install cleaner4rookies

Related Skills

Other popular skills you might find useful.

Agent Browser

MaTriXy

Headless browser automation CLI optimized for AI agents with accessibility tree snapshots and ref-based element selection

96.9k 350 v0.1.0

Browser Automation

peytoncasper

Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications.

37.3k 50 v1.0.1