---
name: openclaw-tune
description: OpenClaw **system-level** maintenance — cleans sessions/.bak rotation, disk bloat under ~/.openclaw/, validates model fallback chain, audits cron health, prunes short-term-recall noise. Run after `openclaw update` or every 1-2 weeks. Different from **workspace document tune-up** (single-responsibility canonical .md files, token waste scan) which is handled by Claude auto-memory `openclaw-workspace-tuneup` — triggered when user says "优化下 openclaw 的文档/skill/canonical". This skill is for `openclaw` daemon/CLI maintenance, NOT for workspace docs.
---

# OpenClaw Tune-Up

Use this skill to keep kcn's openclaw setup lean. Run it after every `openclaw update`, or as a periodic chore every 1-2 weeks.

## When to invoke

- User says `/openclaw-tune` or `优化下 openclaw`
- After `openclaw update` (defaults may have shifted; configs may need migration)
- When response feels slow / token costs creeping up
- When `agents/main/sessions/` looks suspiciously large

## Operating principles

1. **Don't delete, archive first**: move stale files to `/tmp/openclaw-cleanup-<date>/` so they can be recovered for a day
2. **Verify before touching live state**: if openclaw gateway is running, only touch files it doesn't actively hold (use `lsof`)
3. **Real holdings, real data**: never propose changes that hardcode portfolio numbers — `portfolio.json` is the only source of truth
4. **Report what was done** with sizes/counts; never silent fixes

## Checklist

### 1. Disk bloat

Big offenders found historically:

| Path | What to look for | Action |
|---|---|---|
| `~/.openclaw/agents/main/sessions/*.bak-*` | Transcript backups, no rotation. One active session can accumulate 100+ files (7MB each = 700MB) | Keep latest 3 per session, archive rest |
| `~/.openclaw/agents/main/sessions/*.bak-*` (orphan) | `.bak` file with no matching `.jsonl` (session deleted but backup stayed) | Archive all |
| `~/.openclaw/openclaw.json.clobbered.*` | Config corruption snapshots (e.g. 2026-04-25 had 78) | Archive all (the `.last-good` retains canonical state) |
| `~/.openclaw/logs/stability/*.json` | Crash dumps from past unhandled rejections | Archive if older than 30 days |
| `~/.openclaw/memory/main.sqlite.tmp-*` | Orphaned SQLite migration tmp file from interrupted write. Verify `lsof` returns empty, mtime > 7d, then delete | Delete only if not held |
| `~/.openclaw/media/` | Generated images, voice clips | Check size; archive if > 100MB and not referenced |
| `~/.openclaw/agents/main/sessions/*.trajectory.jsonl` | Audit trajectory logs — large but useful for debugging | Leave unless > 500MB total |

Sample script:

```bash
ARCHIVE=/tmp/openclaw-cleanup-$(date +%Y%m%d_%H%M%S)
mkdir -p "$ARCHIVE"

# Orphan .bak (no matching .jsonl)
SESS=~/.openclaw/agents/main/sessions
for bak in $SESS/*.bak-*; do
    [ -f "$bak" ] || continue
    base=$(echo "$bak" | sed 's/\.jsonl\.bak-.*//')
    [ -f "$base.jsonl" ] || mv "$bak" "$ARCHIVE/"
done

# Rotate .bak: keep latest 3 per session (by trailing timestamp)
ls $SESS/*.bak-* 2>/dev/null | sed 's/\.jsonl\.bak-.*//' | sort -u | while read pfx; do
    files=$(ls -1 ${pfx}.jsonl.bak-* 2>/dev/null)
    count=$(echo "$files" | wc -l)
    [ "$count" -gt 3 ] && \
        echo "$files" | sort -t'-' -k3,3n | head -n -3 | xargs -I{} mv {} "$ARCHIVE/"
done

# Clobbered configs + old crash dumps
mv ~/.openclaw/openclaw.json.clobbered.* "$ARCHIVE/" 2>/dev/null
mv ~/.openclaw/logs/stability/openclaw-stability-*.json "$ARCHIVE/" 2>/dev/null
```

### 2. Prompt bloat (token cost)

OpenClaw injects these files into every system prompt (order: agents.md=10, soul.md=20, identity.md=30, user.md=40, tools.md=50, memory.md=70). Anything fluffy here gets paid for **per turn**.

Check the size of each:

```bash
wc -c ~/.openclaw/workspace/{AGENTS,SOUL,USER,IDENTITY,MEMORY,TOOLS}.md
```

Rough budget:
- AGENTS.md: < 3 KB (core rules only; no philosophical fluff, no group-chat lore, no heartbeat docs — openclaw injects heartbeat prompt itself)
- MEMORY.md: < 5 KB (durable preferences + data rules + key lessons; not historical trade records — those live in `memory/*.md`)
- SOUL.md / IDENTITY.md / USER.md: < 2 KB each
- TOOLS.md: < 4 KB (script reference + fallback chain summary only)

**Common bloat patterns**:

| Pattern | Where it lives | Fix |
|---|---|---|
| "Promoted From Short-Term Memory" in MEMORY.md | Dreaming auto-promotes summaries; they pile up | Trim entries about already-cleared positions |
| Duplicate fallback chains in MEMORY.md + TOOLS.md + INVESTMENT_SOP.md | Same rules 3x | Keep ONE authoritative copy (TOOLS.md); others reference it |
| Group chat / Discord behavior in AGENTS.md | User uses 1:1 weixin | Drop unless multi-user channels are added |
| Verbose heartbeat instructions in AGENTS.md | openclaw injects `HEARTBEAT_CONTEXT_PROMPT` itself | Keep one short line about HEARTBEAT_OK token |
| 50+ line preamble repeating "real data, no cache" | Said 5 times across files | One铁律 block in MEMORY.md, reference elsewhere |

### 3. Model fallback chain (token cost)

In `~/.openclaw/openclaw.json`, check `agents.defaults.model`:

```bash
python3 -c "
import json
cfg = json.load(open('/root/.openclaw/openclaw.json'))
m = cfg['agents']['defaults']['model']
print('primary:', m['primary'])
print('fallbacks:')
for f in m['fallbacks']: print(' ', f)
"
```

Red flags:
- **Different paid providers stacked early** (e.g. `minimax → glm → anthropic → openai`): one minimax 429 burns expensive tokens. Stack the cheap/unlimited provider 3-4x at the head before falling through to paid backups.
- **"Spare" provider with same API key** (`minimax-spare` same key as `minimax`): acts as a retry, not real redundancy. Fine if user knows that. Bad if they think it's a quota pool.
- **Stale model IDs after openclaw update**: e.g., changelog deprecated `gpt-5.3-codex`. Cross-check `npm view openclaw versions` changelog for deprecation notices.

### 4. Cron jobs

`~/.openclaw/cron/jobs.json` — check each enabled job's `payload.message`:

- Does it reference scripts that still exist? (e.g. removed `scripts/legacy/stock_analyzer.py` but cron still calls it)
- Does it reference dead APIs? (e.g. "优先东方财富" but Eastmoney is 502 from this server)
- Does it hardcode tickers? (should read from `portfolio.json` dynamically)
- Pattern to use: **script outputs data block → agent layers analysis on top** (情绪面/技术面/操作建议)
- For intraday: use `--wechat` flag for mobile-friendly compact output

### 5. Short-term-recall noise

`~/.openclaw/workspace/memory/.dreams/short-term-recall.json`:

```bash
python3 -c "
import json
data = json.loads(open('/root/.openclaw/workspace/memory/.dreams/short-term-recall.json','rb').read().decode('utf-8','replace'))
e = data['entries']
recalled = sum(1 for v in e.values() if v.get('recallCount',0) > 0)
print(f'total: {len(e)}  ever recalled: {recalled}  ({recalled*100//len(e)}%)')
"
```

If recall rate < 5% and total > 3000, prune noise:
- Drop `session-corpus` entries with `recallCount=0` AND no trade keywords
- Keep all `memory/*.md` entries (those are real diary)
- Keep all entries with `交易记录|买入|卖出|加仓|减仓|清仓|持仓|盈利|亏损`

### 6. After openclaw update

Run these checks after `openclaw update` succeeds:

```bash
# 1. Defaults shifted? Compare default agent model
diff <(openclaw config get agents.defaults.model) <(cat /tmp/last-known-model.json) 2>/dev/null

# 2. Changelog skim for breaking changes
PKG=$(find /root/.local/share/pnpm/global/5/.pnpm -name "openclaw" -path "*node_modules/openclaw" -type d | sort | tail -1)
head -50 "$PKG/CHANGELOG.md"

# 3. Deprecated model IDs check
grep -i "deprecated\|suppress.*model\|stop advertising" "$PKG/CHANGELOG.md" | head -5

# 4. Re-run the disk + prompt + fallback chain checks above
```

If openclaw introduced a new default model (e.g. M2.8 supersedes M2.7), suggest the user update `primary` in `openclaw.json`.

### 7. Verification before reporting done

```bash
# Confirm openclaw still healthy
curl -sf http://127.0.0.1:18789/health && echo " ✓ gateway up"

# Confirm scripts still run
cd /root/.openclaw/workspace && python3 scripts/data/analyze_hk_stocks.py --no-fetch --no-news --wechat | head -5

# Show cleanup summary
du -sh /tmp/openclaw-cleanup-*/  # what was archived
```

## Output format

End with a structured report:

```
## Tune-Up Report  YYYY-MM-DD

### 清理（已归档到 /tmp/openclaw-cleanup-YYYYMMDD/）
- Session .bak rotation: N 个 → ~X MB
- ...

### Prompt 瘦身
- AGENTS.md: <old> → <new> 行 (-N%)
- ...

### 配置审计
- 模型 fallback 链：<state>
- Cron job 一致性：<state>
- ...

### 建议
- [可选] 重启 gateway: <yes/no, reason>
- [待办] <items needing user attention>

### 跳过项
- <什么没动以及为什么>
```

## Don't

- ❌ Don't restart `openclaw-gateway` automatically — ask user first
- ❌ Don't touch `agents.defaults.model.primary` — that's user's intentional choice
- ❌ Don't delete anything before archiving to /tmp
- ❌ Don't delete `*.trajectory.jsonl` — those are sometimes useful for debugging
- ❌ Don't strip MEMORY.md entries that contain `交易记录` — those are real history kcn refers to
- ❌ Don't propose hardcoding portfolio numbers in any doc/skill — always reference `portfolio.json`

## Inputs / Outputs

- **Reads**: `~/.openclaw/openclaw.json`, `~/.openclaw/cron/jobs.json`, `~/.openclaw/workspace/{AGENTS,MEMORY,TOOLS,USER,SOUL}.md`, `~/.openclaw/workspace/memory/.dreams/short-term-recall.json`, disk usage of `~/.openclaw/`
- **Writes**: trimmed `*.md` workspace files (with bak), `~/.openclaw/cron/jobs.json` (with bak), eventual `portfolio.json` if data refresh happens; everything else archived to `/tmp/openclaw-cleanup-<date>/`
- **Side effects**: may suggest gateway restart at the end (user-confirmed)