🔄 Idle Self-Improvement
ให้ AI Agent ดูแลระบบเองเมื่อว่าง🔄 Idle Self-Improvement
Let Your AI Agent Mind the System While It Waits

The Problem We Tend to Overlook

Most AI Agents work in a "question-and-answer" mode — if you do not send a message, they simply sit there doing nothing at all. Like an employee who only ever waits for orders, and never turns around to tidy the desk or check what work is still outstanding.

But if we can tell the Agent "when nobody is talking to you, go check the system instead" — then the idle time that used to be wasted becomes real work that helps us.

What Is Idle Improver?

Idle Improver is a Python script that runs every 30 minutes through a cron job. On each run it:

1. Checks first whether the system is genuinely idle — if someone is in the middle of a conversation with the Agent, it skips the run entirely and does not interrupt.
2. Scans for problems across several fronts — is the disk full? Is memory running high? Is any Docker container broken?
3. Writes the results to a file — it keeps the report as markdown so the Agent can read it later.

What Does It Check?

Idle Improver checks the 7 areas that matter most on a server:

Vault Intelligence — Let the Agent Understand Your Knowledge Base

Beyond Idle Improver, there are three more tools that let the Agent work intelligently with your Obsidian vault:

python3 tools/vault_stats.py

python3 tools/ask_vault.py "machine learning"
python3 tools/ask_vault.py "RAG" --limit 5
python3 tools/ask_vault.py "note.md" --related

python3 tools/vault_insight.py full --save

Set It Up in 5 Steps

Installing it is not as hard as you would think — about 10-15 minutes:

Step 1: Create the folders

mkdir -p ~/.openclaw/workspace/tools
mkdir -p ~/.openclaw/workspace/memory
mkdir -p ~/.openclaw/workspace/logs
mkdir -p ~/.openclaw/workspace/tmp

Step 2: Drop in the scripts

Download or create four files in tools/:

workspace/tools/
├── idle_improver.py    # scans system health
├── vault_insight.py    # analyzes the vault
├── vault_stats.py      # vault dashboard
└── ask_vault.py        # searches the vault

Step 3: Fix the paths

In each script, edit these 2 lines to match your machine:

WORKSPACE = Path("~/.openclaw/workspace").expanduser()
VAULT = Path("~/obsidian-vault").expanduser()  # ← your vault's path

Step 4: Set up the cron job

# open crontab
crontab -e

# add these 2 lines:
*/30 * * * * /usr/bin/python3 ~/.openclaw/workspace/tools/idle_improver.py
0 3 * * 1 /usr/bin/python3 ~/.openclaw/workspace/tools/vault_insight.py full --save

The first line = scan every 30 minutes; the second = analyze the vault every Monday at 3 a.m.

Step 5: Test it

# test idle improver (force a run)
python3 tools/idle_improver.py --force

# test vault stats
python3 tools/vault_stats.py

# test the search
python3 tools/ask_vault.py "test query"

Last step: tell the Agent about the tools

Add this to the workspace's AGENTS.md:

## Vault Intelligence Tools
- `python3 tools/vault_stats.py` — vault dashboard
- `python3 tools/ask_vault.py "query"` — search vault
- `python3 tools/vault_insight.py full` — theme/gap analysis
- `python3 tools/idle_improver.py --force` — system health scan

Why Bother Setting This Up?

Who Is This For?

• Solo developers running their own server — with no ops team watching it for them.
• Obsidian users with a lot of notes — a big vault only gets harder to search without tools to help.
• Small teams who want simple monitoring — without setting up a full Prometheus/Grafana stack.
• Everyone using OpenClaw — your Agent is idle anyway, so why not have it do something useful?

"The best monitoring is the kind you don't have to remember to do."