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/                 # 代码仓库
```

## 执行命令

### 完整目录健康检查
```bash
python3 ~/clawd/skills/workspace-directory-manager/scripts/health-check.py
```

### 清理临时文件
```bash
python3 ~/clawd/skills/workspace-directory-manager/scripts/cleanup-tmp.py --dry-run   # 预览
python3 ~/clawd/skills/workspace-directory-manager/scripts/cleanup-tmp.py               # 执行
```

### 重复 Skill 检测
```bash
python3 ~/clawd/skills/workspace-directory-manager/scripts/detect-duplicates.py
```

### 磁盘空间报告
```bash
python3 ~/clawd/skills/workspace-directory-manager/scripts/disk-usage.py
```

### 目录结构可视化
```bash
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: 初版创建