System State Injection

System State Injection

Solves: agents answering "is X working?" from stale memory instead of live state.

Pattern: cron → JSON → agent reads at session open → always-current answers.

Architecture

┌─────────────┐  every 30min  ┌────────────────────┐
│  Cron job   │ ────────────▶ │ system_state.json  │
│  checks:    │               │  (compact JSON)    │
│  - gateway  │               └────────┬───────────┘
│  - disk     │                        │
│  - integs   │                        ▼
│  - sessions │               ┌────────────────────┐
└─────────────┘               │ Agent reads at     │
                              │ session open       │
                              │ → always-current   │
                              └────────────────────┘

What It Checks (configurable)

Setup

1. Configure integrations

Edit scripts/integrations.json:

{
  "integrations": [
    {"name": "WhatsApp", "check": "openclaw status | grep WhatsApp"},
    {"name": "Google Drive", "check": "test -f ~/.config/google/token.json && echo ok"},
    {"name": "Twitch Bot", "check": "pgrep -f chatbot.py && echo running || echo stopped"}
  ],
  "output_path": "~/agent-workspace/brain/system_state.json",
  "timezone_offset_hours": 5.5
}

2. Run manually

python3 scripts/update_state.py
cat ~/agent-workspace/brain/system_state.json

3. Cron (every 30 min)

*/30 * * * * /usr/bin/python3 /path/to/system-state-injection/scripts/update_state.py >> /tmp/state-injection.log 2>&1

4. Wire into your agent

Add to your agent's system prompt or AGENTS.md:

Before answering any question about integration/service/tool status:
read brain/system_state.json first. This is the authoritative source.
Never answer from assumption.

Output Format

{
  "generated": "2026-04-05T22:30:00+05:30",
  "gateway": {"status": "running", "uptime": "3d 14h"},
  "disk": {"free_gb": 142.3, "used_pct": 68},
  "sessions": {"active": 2},
  "integrations": {
    "WhatsApp": "linked",
    "Google Drive": "connected",
    "Twitch Bot": "running"
  }
}

Scripts

• scripts/update_state.py — Main script. Runs all checks, writes JSON.
• scripts/integrations.json — Configuration for custom integration probes.

Why This Matters

Without state injection, agents rely on memory for status answers. Memory is often hours or days stale. One cron job eliminates an entire class of wrong answers.