{
  "id": "AGT-25",
  "title": "\"openclaw update\" fails with reason code doctor-failed (update rolls back)",
  "error_string": "Reason code: doctor-failed",
  "also_appears_as": [
    "candidate doctor lint ... failed",
    "lint: Candidate lint failed",
    "Rollback outcome: verified safe to restart",
    "Update history reconciliation could not complete: RangeError: Maximum call stack size exceeded",
    "unsupported-plugin-install-index"
  ],
  "platforms": [
    "OpenClaw"
  ],
  "primary_platform": "openclaw",
  "versions": {
    "reported_on": "OpenClaw 2026.9.4 → 2026.9.5 (macOS, Node 26.8.2); 2026.9.5 → 2026.9.6 (Linux, Node 24.21.0); → 2026.10.8 (macOS, Node 26.13.0)",
    "tested_by_us": "not yet reproduced"
  },
  "last_verified": null,
  "status": "as-reported",
  "status_label": "As reported (not yet reproduced)",
  "ci_status": "pending-ci",
  "ci_results_url": null,
  "retest_due": null,
  "published": "2026-10-30",
  "repro_url": null,
  "repro_files_url": null,
  "fix_summary": "The update ran OpenClaw's own checks against your state and rolled back. The full guide maps the official recovery order (what to check first, what never to delete) and the version-specific reports, with sources.",
  "fix_summary_is_teaser": true,
  "full_fix": {
    "access": "paid",
    "product_id": "full-fix",
    "also_in": [
      "repro-bundle",
      "fix-pass",
      "agent-api"
    ],
    "price_usd": 4,
    "currency": "USD",
    "prices_are_placeholders": true,
    "purchase_status": "not_yet_available",
    "buy_url": "https://stucktoshipped.com/pricing/#full-fix",
    "stripe_payment_link": "TODO",
    "sha256": "484970283c25bdcf10e0e53e77f337973697f8a2efdd9ba7218a55452bcdc3c2",
    "words": 617,
    "code_blocks": 1,
    "sections": [
      "Fix (from OpenClaw's docs)",
      "How to check it worked",
      "What we actually tested"
    ]
  },
  "repro_bundle": null,
  "url": "https://stucktoshipped.com/fixes/openclaw/update-doctor-failed/",
  "markdown_url": "https://stucktoshipped.com/fixes/openclaw/update-doctor-failed/index.md",
  "json_url": "https://stucktoshipped.com/fixes/openclaw/update-doctor-failed/index.json",
  "sources": [
    {
      "title": "OpenClaw docs: Update troubleshooting (reason codes, incl. doctor-failed)",
      "url": "https://docs.openclaw.ai/install/update-troubleshooting"
    },
    {
      "title": "GitHub #152759: update 2026.9.4 → 2026.9.5 fails with reason code doctor-failed; auto-rollback succeeds (closed)",
      "url": "https://github.com/openclaw/openclaw/issues/152759"
    },
    {
      "title": "GitHub #157011: managed update 2026.9.5 → 2026.9.6 always rolls back (survives doctor --fix) (closed)",
      "url": "https://github.com/openclaw/openclaw/issues/157011"
    },
    {
      "title": "OpenClaw Community forum: Update to 2026.10.8 failed, stuck between database migration and Doctor errors (Oct 29, 2026)",
      "url": "https://community.openclaw.ai/t/update-to-2026-10-8-failed-stuck-between-database-migration-and-doctor-errors/266"
    },
    {
      "title": "GitHub search: issues with \"update\" and \"doctor\" in the title since Sep 1, 2026",
      "url": "https://github.com/openclaw/openclaw/issues?q=is%3Aissue+in%3Atitle+update+doctor+created%3A%3E%3D2026-09-01"
    }
  ],
  "indexable": false,
  "reviewed_by_human": null,
  "content_sha256": "d624e522d9c8504a7a0c2f5ac3d6856f3551d5019c14070268d3e9eebb9b5425"
}
