| name | secrets-hygiene |
| description | Audits which skills have access to secrets, flags stale or unrotated credentials, and prompts rotation. Use weekly to keep credentials clean. |
| cron | 0 9 * * 1 |
| stateful | true |
Secrets Hygiene
State file: ~/.openclaw/skill-state/secrets-hygiene/state.yaml
Credentials you forgot about are credentials that will leak.
When to Use
- On Monday 9am cron wakeup
- When adding or removing a skill that uses credentials
- After any suspected security incident
The Audit Process
Step 1: Inventory
List all secrets currently configured in OpenClaw (env vars, config files, keychain entries referenced by installed skills). For each, record: name, which skills access it, when it was last rotated (if known).
Step 2: Flag Stale Secrets
A secret is stale if:
- Last rotated more than 90 days ago (or unknown rotation date)
- The skill that uses it is no longer installed
- It grants broader access than the skill needs
Step 3: Report
Send a summary:
Secrets Audit — [date]
[N] secrets tracked
[N] flagged for rotation: [names]
[N] orphaned (skill removed): [names]
Action needed: [yes/no]
Step 4: Update State
Write last_audit_at, updated tracked_secrets list, flagged_count, orphaned_count to state file.
Cron Wakeup Behavior
On Monday 9am wakeup:
- Read state; if
last_audit_at is within the last 6 days, skip
- Otherwise run the audit and update state
