Background

OpenClaw ships a **** command that:

• Detects risky or misconfigured settings (e.g., open DM policies, missing secrets)
• Auto-repairs common issues (--fix flag)
• Runs migrations for config schema changes
• Checks channel connectivity and auth health
• Reports overall system health with actionable suggestions

Hermes Agent has no equivalent diagnostic tool. Troubleshooting requires manual inspection of logs, config files, and environment variables.

Proposal

Add hermes doctor command:

1. Config validation: Check config.yaml schema, missing required keys, deprecated options
2. Channel health checks: Attempt to connect to each configured channel and report status
3. Secret verification: Check all required env vars are set (API keys, tokens)
4. Disk/storage check: Workspace size, log rotation status
5. Auto-fix mode (hermes doctor --fix): Auto-repair common issues (schema migration, file permissions, etc.)
6. Report output: Human-readable summary + machine-readable JSON for CI integration

References

• OpenClaw openclaw doctor: docs/gateway/doctor