workspace-directory-manager

name	workspace-directory-manager
description	Workspace directory manager — maintain cleanliness of ~/.openclaw/ and ~/clawd/

Skill: OpenClaw & Workspace Directory Manager

触发条件

• "整理目录"、"清理文件夹"、"目录结构"
• "清理 tmp"、"清理日志"、"清理临时文件"
• "skills 整理"、"重复 skill 检查"
• "磁盘空间"、"空间不足"
• "workspace 维护"、"openclaw 维护"

职责

维护 ~/.openclaw/ 和 ~/clawd/ 两个目录的整洁和秩序。 专属 agent: 小ops — CEO 指定的小ops专用 skill。

目录结构规范

~/.openclaw/ （系统配置目录）

~/.openclaw/
├── openclaw.json          # 主配置（唯一真相源）
├── .env                   # 运行时环境变量（由 rebuild-env.sh 生成，chmod 600）
├── agents/
│   └── <agent-id>/agent/
│       ├── agent.json     # Agent 身份+模型+workspace
│       ├── models.json    # 模型缓存（自动生成）
│       ├── SOUL.md        # Agent 灵魂文件
│       └── AGENTS.md      # Agent 行为规则
├── skills/                # 全局安装的 Skill
├── logs/                  # 运行日志
└── memory/                # 记忆文件

~/clawd/ （工作空间目录）

~/clawd/
├── MEMORY.md              # 长期记忆（main session 维护，只读）
├── SOUL.md                # CEO 灵魂文件
├── AGENTS.md              # 团队规则
├── USER.md                # 用户画像
├── TOOLS.md               # 工具手册
├── IDENTITY.md            # 身份文件
├── HEARTBEAT.md           # 心跳规则
├── memory/                # 日记忆 YYYY-MM-DD.md
├── projects/              # 独立项目
├── reports/               # 研究报告
├── skills/                # 自研 Skill
├── scripts/               # 全局脚本
├── docs/                  # 文档
├── tmp/                   # 临时文件（可定期清理）
└── repos/                 # 代码仓库

执行命令

完整目录健康检查

python3 ~/clawd/skills/workspace-directory-manager/scripts/health-check.py

清理临时文件

python3 ~/clawd/skills/workspace-directory-manager/scripts/cleanup-tmp.py --dry-run   # 预览
python3 ~/clawd/skills/workspace-directory-manager/scripts/cleanup-tmp.py               # 执行

重复 Skill 检测

python3 ~/clawd/skills/workspace-directory-manager/scripts/detect-duplicates.py

磁盘空间报告

python3 ~/clawd/skills/workspace-directory-manager/scripts/disk-usage.py

目录结构可视化

python3 ~/clawd/skills/workspace-directory-manager/scripts/tree-view.py --path ~/clawd --depth 2
python3 ~/clawd/skills/workspace-directory-manager/scripts/tree-view.py --path ~/.openclaw --depth 2

清理规则

tmp/ 清理

• ~/clawd/tmp/ 中超过 7 天的文件自动标记删除
• 不删除正在被 cron/session 使用的文件

日志清理

• ~/.openclaw/logs/ 中超过 30 天的日志自动清理
• 保留最近 7 天的详细日志

Agent Session 残留

• 检查 agents/*/agent/ 下异常大的文件
• models.json 如果超过 10MB → 标记清理

重复 Skill 清理

• 对比 ~/.openclaw/skills/ 和 ~/clawd/skills/
• 同名 skill 以 ~/.openclaw/skills/ 为准
• 功能重复的 skill 报告给 CEO 决定

安全铁律

1. 永不删除 MEMORY.md、SOUL.md、AGENTS.md、USER.md、TOOLS.md
2. 清理前 dry-run，确认无误再执行
3. 用 trash 而非 rm（可恢复）
4. 不修改 openclaw.json（除非 CEO 明确指示）
5. memory/ 文件只追加不覆盖

巡检频率

• 每 6 小时（通过 heartbeat 或 cron）运行 health-check
• 每周日运行一次 cleanup + disk-usage

更新记录

• 2026-03-29: 初版创建