Clawdoctor

Self-healing monitor for OpenClaw gateways, crons, and agent sessions. Use when you need to watch if OpenClaw is running, get Telegram alerts on failures, au...

What to consider before installing: - Function: this is a local OpenClaw monitor/healer that reads ~/.openclaw files, writes data under ~/.clawdoctor, sends Telegram alerts, and can restart OpenClaw via systemctl or the openclaw CLI. That behavior matches the README and SKILL.md. - Permissions: healing actions (systemctl restart or killing sessions) may require appropriate user permissions; prefer running with the least privilege needed and test in dry-run mode first (clawdoctor start --dry-run). - Telegram: you must provide a bot token and chat id in config to receive alerts. If you enable inline-approval buttons, a dedicated callback bot token may be required; otherwise inline buttons fall back to suggested CLI commands. - Licenses: paid-plan activation uses a remote validation call to clawdoctor.dev; the factsheet shows server-side bugs in their license endpoints (idempotency and query handling). Treat any license keys or payment flows with the usual caution and prefer using environment-based caching or local license files rather than exposing other secrets. - Advertising mismatches: Slack/Discord alerting is advertised but not implemented—Telegram is the only alerter in code. RetentionDays and monitor limits are configurable but not strictly enforced automatically by the client. - Review before auto-fix: enable dry-run and review the audit/snapshot files (~/.clawdoctor/audit.jsonl and snapshots/) before allowing auto-heal in production. Consider running the CLI manually for initial testing and confirm behavior for your systemd setup. - Source trust: code is included in the skill bundle. If you plan to install globally (npm -g), inspect the package and prefer installing from the official npm name and repository (links are provided) and verify the package integrity.

Type: OpenClaw Skill Name: turleydesigns-clawdoctor Version: 0.4.13 The bundle contains 'ClawDoctor', a legitimate monitoring and self-healing utility designed for the OpenClaw platform. The code implements watchers for gateway processes, cron jobs, and agent sessions, and includes 'healers' that can restart services or retry failed tasks using the 'openclaw' CLI and systemd. While the tool requires significant permissions (shell execution and network access for Telegram alerts and license validation at clawdoctor.dev), its behavior is transparent, well-documented, and strictly aligned with its stated purpose. Security best practices are observed, such as using allowlists for rollback commands in 'src/snapshots.ts' and enforcing restrictive file permissions (0o600) for configuration and license data in 'src/config.ts'.