OpenClaw can feel “invisible” when:
- it’s working on something long-running,
- it fails silently (rate limit / auth / relay mismatch),
- or you don’t know whether cron actually executed.
This guide gives you a low-tech, high-signal operability layer that works on any host.
0) The evidence mindset (the one rule)
If a run doesn’t leave:
- a log trail, and
- a timestamped artifact (file),
then you can’t prove it ran, and you can’t debug it when it doesn’t.
This single mindset fixes most “it promised and never delivered” frustrations.
Persistence basics:
1) The 3 probes to standardize
Run on the gateway host:
openclaw status --deep
openclaw models status --probe
openclaw channels status --probe
Interpretation:
status --deep→ is the gateway alive and reachable?models ... --probe→ can it actually call the model (auth/quota/routing)?channels ... --probe→ can it deliver/receive on the channel?
If “not responding” is your symptom:
2) Make cron observable (stop relying on announce as the only signal)
Cron reliability and the three common failure modes:
The high-value pattern:
- Every cron run writes a timestamped artifact (report JSON/MD).
- Every cron run sends an explicit summary with the artifact path.
- If delivery is flaky, use webhook delivery or store artifacts and pull them.
3) A lightweight task board that works everywhere
If you need Trello-style visibility but don’t want another SaaS dependency, use your workspace as the source of truth.
Download the ready-made template:
Option A (simplest): a single TASKS.md
Create TASKS.md in your OpenClaw workspace:
- Columns: Backlog / Doing / Blocked / Done
- Each task is a checkbox with an owner, timestamp, and links to artifacts
Because it’s just a file:
- it survives reboots
- it can be reviewed in git (if you version it)
- it can be updated by cron runs (append a line each run)
Option B: file-per-task (more automation-friendly)
Create directories:
tasks/backlog/tasks/doing/tasks/done/
Each task is a small markdown file with:
- goal
- inputs/links
- “definition of done”
- last run timestamp
- artifact paths
Automations can “move” a task by renaming the file between folders.
4) Safety: logs and boards are secrets magnets
Do not paste:
- API keys
- OAuth tokens
- full email bodies from sensitive inboxes
Use redaction and separate accounts: