{
  "schemaVersion": "1.0",
  "item": {
    "slug": "auto-updater-pro",
    "name": "Auto Updater Pro",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/newolf20000/auto-updater-pro",
    "canonicalUrl": "https://clawhub.ai/newolf20000/auto-updater-pro",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/auto-updater-pro",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=auto-updater-pro",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "references/agent-guide.md",
      "references/summary-examples.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/auto-updater-pro"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/auto-updater-pro",
    "agentPageUrl": "https://openagent3.xyz/skills/auto-updater-pro/agent",
    "manifestUrl": "https://openagent3.xyz/skills/auto-updater-pro/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/auto-updater-pro/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Auto-Updater Pro",
        "body": "Enhanced auto-updater with detailed logging, missed run recovery, and Gateway restart protection.\n\nVersion: 1.1.0 (Updated 2026-02-22)\n\nWhat's New:\n\n✅ Detailed logging at each step (prevents state loss on restart)\n✅ Missed run recovery (auto-runs if Gateway was offline)\n✅ 30-second delay after updates (prevents interruption)\n✅ Email report support (less intrusive than chat messages)\n✅ Better error handling and retry logic\n\nNote: This is an enhanced version of the original auto-updater skill with production-ready features."
      },
      {
        "title": "What It Does",
        "body": "This skill sets up a daily cron job that:\n\nUpdates Clawdbot itself (via clawdbot doctor or package manager)\nUpdates all installed skills (via clawdhub update --all)\nMessages you with a summary of what was updated\nNew: Logs every step to prevent state loss on Gateway restart\nNew: Auto-recovers if the scheduled time was missed"
      },
      {
        "title": "Quick Start",
        "body": "Ask Clawdbot to set up the auto-updater:\n\nSet up daily auto-updates for yourself and all your skills.\n\nOr manually add the cron job:\n\nclawdbot cron add \\\n  --name \"Daily Auto-Update\" \\\n  --cron \"0 4 * * *\" \\\n  --tz \"America/Los_Angeles\" \\\n  --session isolated \\\n  --wake now \\\n  --deliver \\\n  --message \"Run daily auto-updates: check for Clawdbot updates and update all skills. Report what was updated.\""
      },
      {
        "title": "Recommended Configuration (v1.1.0+)",
        "body": "For production use, add these settings to your cron job:\n\n{\n  \"schedule\": {\n    \"expr\": \"0 4 * * *\",\n    \"kind\": \"cron\",\n    \"tz\": \"Asia/Shanghai\"\n  },\n  \"missedRunPolicy\": \"run-immediately\",\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"...\",\n    \"timeoutSeconds\": 600\n  }\n}\n\nKey Settings:\n\nmissedRunPolicy: \"run-immediately\" - Auto-runs if Gateway was offline at scheduled time\ntimeoutSeconds: 600 - Allow 10 minutes for updates to complete\ntz: \"Asia/Shanghai\" - Set to your timezone"
      },
      {
        "title": "Configuration Options",
        "body": "OptionDefaultDescriptionTime4:00 AMWhen to run updates (use --cron to change)TimezoneSystem defaultSet with --tzDeliveryMain sessionWhere to send the update summaryTimeout300sRecommended: 600s for npm updatesMissed RunNoneRecommended: run-immediately"
      },
      {
        "title": "Clawdbot Updates",
        "body": "For npm/pnpm/bun installs:\n\nnpm update -g clawdbot@latest\n# or: pnpm update -g clawdbot@latest\n# or: bun update -g clawdbot@latest\n\nFor source installs (git checkout):\n\nclawdbot update\n\nAlways run clawdbot doctor after updating to apply migrations."
      },
      {
        "title": "Skill Updates",
        "body": "clawdhub update --all\n\nThis checks all installed skills against the registry and updates any with new versions available."
      },
      {
        "title": "Update Summary Format",
        "body": "After updates complete, you'll receive a message like:\n\n🔄 Daily Auto-Update Complete\n\n**Clawdbot**: Updated to v2026.1.10 (was v2026.1.9)\n\n**Skills Updated (3)**:\n- prd: 2.0.3 → 2.0.4\n- browser: 1.2.0 → 1.2.1  \n- nano-banana-pro: 3.1.0 → 3.1.2\n\n**Skills Already Current (5)**:\ngemini, sag, things-mac, himalaya, peekaboo\n\nNo issues encountered."
      },
      {
        "title": "Detailed Logging (v1.1.0+)",
        "body": "To prevent state loss during Gateway restarts, the update process logs every step:"
      },
      {
        "title": "Log File Location",
        "body": "~/.openclaw/workspace/memory/openclaw-update-YYYY-MM-DD.md"
      },
      {
        "title": "Log Format",
        "body": "# OpenClaw 更新日志 YYYY-MM-DD\n\n## 更新前\n- 开始时间：HH:mm:ss\n- 当前版本：x.x.x\n- 最新版本：x.x.x\n\n## 更新中\n- 更新开始：HH:mm:ss\n- 更新命令：...\n- 更新完成：HH:mm:ss\n- 验证版本：x.x.x\n\n## 更新后\n- 状态：已是最新 / 已更新 / 更新失败\n- 报告发送：成功 / 失败\n- 完成时间：HH:mm:ss\n\n## 更新内容\n（从 CHANGELOG 或 npm 获取）"
      },
      {
        "title": "Six-Phase Update Process",
        "body": "Phase 1: Preparation\n\nRecord start time\nCheck current version\nWrite to log file immediately\n\nPhase 2: Check for Updates\n\nCheck latest version (npm view)\nAppend to log file\nCompare versions\n\nPhase 3: Execute Update\n\nRecord update start\nRun openclaw update run or npm install -g openclaw@latest\nImmediately log completion\nVerify new version\n\nPhase 4: Persist State\n\nAppend full results to log\nWait 3 seconds for disk sync\n\nPhase 5: Send Report\n\nSend email/chat report\nLog delivery status\n\nPhase 6: Delay Restart (Critical!)\n\nWait 30 seconds before any Gateway restart\nEnsures npm processes complete\nPrevents state loss"
      },
      {
        "title": "Manual Commands",
        "body": "Check for updates without applying:\n\nclawdhub update --all --dry-run\n\nView current skill versions:\n\nclawdhub list\n\nCheck Clawdbot version:\n\nclawdbot --version"
      },
      {
        "title": "Updates Not Running",
        "body": "Verify cron is enabled: check cron.enabled in config\nConfirm Gateway is running continuously\nCheck cron job exists: clawdbot cron list\nCheck if missed run policy is set: missedRunPolicy: \"run-immediately\""
      },
      {
        "title": "Update Failures",
        "body": "If an update fails, the summary will include the error. Common fixes:\n\nPermission errors: Ensure the Gateway user can write to skill directories\nNetwork errors: Check internet connectivity\nPackage conflicts: Run clawdbot doctor to diagnose\nGateway restart interruption: Check log file for partial completion"
      },
      {
        "title": "Gateway Restart During Update",
        "body": "If Gateway restarts during update (common with npm installs):\n\nCheck log file: ~/.openclaw/workspace/memory/openclaw-update-*.md\nVerify version: openclaw --version\nManually send report if needed (log file has all info)"
      },
      {
        "title": "Disabling Auto-Updates",
        "body": "Remove the cron job:\n\nclawdbot cron remove \"Daily Auto-Update\"\n\nOr disable temporarily in config:\n\n{\n  \"cron\": {\n    \"enabled\": false\n  }\n}"
      },
      {
        "title": "1. Schedule During Low Activity",
        "body": "Choose a time when you're unlikely to be using the system:\n\n\"expr\": \"0 4 * * *\"  // 4:00 AM"
      },
      {
        "title": "2. Enable Missed Run Recovery",
        "body": "Prevents missing updates if Gateway is offline:\n\n\"missedRunPolicy\": \"run-immediately\""
      },
      {
        "title": "3. Use Email for Reports",
        "body": "Less intrusive than chat messages:\n\nConfigure email-163-com or similar skill\nSend plain text reports\nInclude log file path"
      },
      {
        "title": "4. Log Everything",
        "body": "Always write to log file before sending reports:\n\nPrevents state loss\nEnables debugging\nProvides audit trail"
      },
      {
        "title": "5. Wait After Updates",
        "body": "Add 30-second delay before any Gateway restart:\n\nsleep 30"
      },
      {
        "title": "Resources",
        "body": "Clawdbot Updating Guide\nClawdHub CLI\nCron Jobs\nChange Log"
      },
      {
        "title": "v1.1.0 (2026-02-22)",
        "body": "Improvements:\n\n✅ Added detailed logging at each step\n✅ Added missed run recovery policy\n✅ Added 30-second delay after updates\n✅ Added email report support\n✅ Improved error handling\n\nBug Fixes:\n\n🐛 Fixed state loss on Gateway restart\n🐛 Fixed missed scheduled runs\n🐛 Fixed report delivery failures"
      },
      {
        "title": "v1.0.0 (2026-01-13)",
        "body": "✅ Initial release\n✅ Basic daily update check\n✅ Simple report format\n\nPublished: 2026-02-22\nMaintainer: OpenClaw Team\nLicense: MIT"
      }
    ],
    "body": "Auto-Updater Pro\n\nEnhanced auto-updater with detailed logging, missed run recovery, and Gateway restart protection.\n\nVersion: 1.1.0 (Updated 2026-02-22)\n\nWhat's New:\n\n✅ Detailed logging at each step (prevents state loss on restart)\n✅ Missed run recovery (auto-runs if Gateway was offline)\n✅ 30-second delay after updates (prevents interruption)\n✅ Email report support (less intrusive than chat messages)\n✅ Better error handling and retry logic\n\nNote: This is an enhanced version of the original auto-updater skill with production-ready features.\n\nWhat It Does\n\nThis skill sets up a daily cron job that:\n\nUpdates Clawdbot itself (via clawdbot doctor or package manager)\nUpdates all installed skills (via clawdhub update --all)\nMessages you with a summary of what was updated\nNew: Logs every step to prevent state loss on Gateway restart\nNew: Auto-recovers if the scheduled time was missed\nSetup\nQuick Start\n\nAsk Clawdbot to set up the auto-updater:\n\nSet up daily auto-updates for yourself and all your skills.\n\n\nOr manually add the cron job:\n\nclawdbot cron add \\\n  --name \"Daily Auto-Update\" \\\n  --cron \"0 4 * * *\" \\\n  --tz \"America/Los_Angeles\" \\\n  --session isolated \\\n  --wake now \\\n  --deliver \\\n  --message \"Run daily auto-updates: check for Clawdbot updates and update all skills. Report what was updated.\"\n\nRecommended Configuration (v1.1.0+)\n\nFor production use, add these settings to your cron job:\n\n{\n  \"schedule\": {\n    \"expr\": \"0 4 * * *\",\n    \"kind\": \"cron\",\n    \"tz\": \"Asia/Shanghai\"\n  },\n  \"missedRunPolicy\": \"run-immediately\",\n  \"payload\": {\n    \"kind\": \"agentTurn\",\n    \"message\": \"...\",\n    \"timeoutSeconds\": 600\n  }\n}\n\n\nKey Settings:\n\nmissedRunPolicy: \"run-immediately\" - Auto-runs if Gateway was offline at scheduled time\ntimeoutSeconds: 600 - Allow 10 minutes for updates to complete\ntz: \"Asia/Shanghai\" - Set to your timezone\nConfiguration Options\nOption\tDefault\tDescription\nTime\t4:00 AM\tWhen to run updates (use --cron to change)\nTimezone\tSystem default\tSet with --tz\nDelivery\tMain session\tWhere to send the update summary\nTimeout\t300s\tRecommended: 600s for npm updates\nMissed Run\tNone\tRecommended: run-immediately\nHow Updates Work\nClawdbot Updates\n\nFor npm/pnpm/bun installs:\n\nnpm update -g clawdbot@latest\n# or: pnpm update -g clawdbot@latest\n# or: bun update -g clawdbot@latest\n\n\nFor source installs (git checkout):\n\nclawdbot update\n\n\nAlways run clawdbot doctor after updating to apply migrations.\n\nSkill Updates\nclawdhub update --all\n\n\nThis checks all installed skills against the registry and updates any with new versions available.\n\nUpdate Summary Format\n\nAfter updates complete, you'll receive a message like:\n\n🔄 Daily Auto-Update Complete\n\n**Clawdbot**: Updated to v2026.1.10 (was v2026.1.9)\n\n**Skills Updated (3)**:\n- prd: 2.0.3 → 2.0.4\n- browser: 1.2.0 → 1.2.1  \n- nano-banana-pro: 3.1.0 → 3.1.2\n\n**Skills Already Current (5)**:\ngemini, sag, things-mac, himalaya, peekaboo\n\nNo issues encountered.\n\nDetailed Logging (v1.1.0+)\n\nTo prevent state loss during Gateway restarts, the update process logs every step:\n\nLog File Location\n~/.openclaw/workspace/memory/openclaw-update-YYYY-MM-DD.md\n\nLog Format\n# OpenClaw 更新日志 YYYY-MM-DD\n\n## 更新前\n- 开始时间：HH:mm:ss\n- 当前版本：x.x.x\n- 最新版本：x.x.x\n\n## 更新中\n- 更新开始：HH:mm:ss\n- 更新命令：...\n- 更新完成：HH:mm:ss\n- 验证版本：x.x.x\n\n## 更新后\n- 状态：已是最新 / 已更新 / 更新失败\n- 报告发送：成功 / 失败\n- 完成时间：HH:mm:ss\n\n## 更新内容\n（从 CHANGELOG 或 npm 获取）\n\nSix-Phase Update Process\n\nPhase 1: Preparation\n\nRecord start time\nCheck current version\nWrite to log file immediately\n\nPhase 2: Check for Updates\n\nCheck latest version (npm view)\nAppend to log file\nCompare versions\n\nPhase 3: Execute Update\n\nRecord update start\nRun openclaw update run or npm install -g openclaw@latest\nImmediately log completion\nVerify new version\n\nPhase 4: Persist State\n\nAppend full results to log\nWait 3 seconds for disk sync\n\nPhase 5: Send Report\n\nSend email/chat report\nLog delivery status\n\nPhase 6: Delay Restart (Critical!)\n\nWait 30 seconds before any Gateway restart\nEnsures npm processes complete\nPrevents state loss\nManual Commands\n\nCheck for updates without applying:\n\nclawdhub update --all --dry-run\n\n\nView current skill versions:\n\nclawdhub list\n\n\nCheck Clawdbot version:\n\nclawdbot --version\n\nTroubleshooting\nUpdates Not Running\nVerify cron is enabled: check cron.enabled in config\nConfirm Gateway is running continuously\nCheck cron job exists: clawdbot cron list\nCheck if missed run policy is set: missedRunPolicy: \"run-immediately\"\nUpdate Failures\n\nIf an update fails, the summary will include the error. Common fixes:\n\nPermission errors: Ensure the Gateway user can write to skill directories\nNetwork errors: Check internet connectivity\nPackage conflicts: Run clawdbot doctor to diagnose\nGateway restart interruption: Check log file for partial completion\nGateway Restart During Update\n\nIf Gateway restarts during update (common with npm installs):\n\nCheck log file: ~/.openclaw/workspace/memory/openclaw-update-*.md\nVerify version: openclaw --version\nManually send report if needed (log file has all info)\nDisabling Auto-Updates\n\nRemove the cron job:\n\nclawdbot cron remove \"Daily Auto-Update\"\n\n\nOr disable temporarily in config:\n\n{\n  \"cron\": {\n    \"enabled\": false\n  }\n}\n\nBest Practices\n1. Schedule During Low Activity\n\nChoose a time when you're unlikely to be using the system:\n\n\"expr\": \"0 4 * * *\"  // 4:00 AM\n\n2. Enable Missed Run Recovery\n\nPrevents missing updates if Gateway is offline:\n\n\"missedRunPolicy\": \"run-immediately\"\n\n3. Use Email for Reports\n\nLess intrusive than chat messages:\n\nConfigure email-163-com or similar skill\nSend plain text reports\nInclude log file path\n4. Log Everything\n\nAlways write to log file before sending reports:\n\nPrevents state loss\nEnables debugging\nProvides audit trail\n5. Wait After Updates\n\nAdd 30-second delay before any Gateway restart:\n\nsleep 30\n\nResources\nClawdbot Updating Guide\nClawdHub CLI\nCron Jobs\nChange Log\nVersion History\nv1.1.0 (2026-02-22)\n\nImprovements:\n\n✅ Added detailed logging at each step\n✅ Added missed run recovery policy\n✅ Added 30-second delay after updates\n✅ Added email report support\n✅ Improved error handling\n\nBug Fixes:\n\n🐛 Fixed state loss on Gateway restart\n🐛 Fixed missed scheduled runs\n🐛 Fixed report delivery failures\nv1.0.0 (2026-01-13)\n✅ Initial release\n✅ Basic daily update check\n✅ Simple report format\n\nPublished: 2026-02-22\nMaintainer: OpenClaw Team\nLicense: MIT"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/newolf20000/auto-updater-pro",
    "publisherUrl": "https://clawhub.ai/newolf20000/auto-updater-pro",
    "owner": "newolf20000",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/auto-updater-pro",
    "downloadUrl": "https://openagent3.xyz/downloads/auto-updater-pro",
    "agentUrl": "https://openagent3.xyz/skills/auto-updater-pro/agent",
    "manifestUrl": "https://openagent3.xyz/skills/auto-updater-pro/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/auto-updater-pro/agent.md"
  }
}