{
  "id": "AGT-01",
  "title": "OpenClaw install fails: \"this OpenClaw release requires Node >=24.22.1 <25 || >=26.12.1\"",
  "error_string": "[openclaw] error: this OpenClaw release requires Node >=24.22.1 <25 || >=26.12.1.",
  "also_appears_as": [
    "npm error [openclaw] detected Node 20.19.2 (exec: /usr/bin/node).",
    "Windows Companion: Node 24.19.0 is unsupported (even though Windows has Node 26 installed)"
  ],
  "platforms": [
    "OpenClaw"
  ],
  "primary_platform": "openclaw",
  "versions": {
    "os": "Debian 13 (x64 container)",
    "node_before": "20.19.2",
    "node_after": "26.12.1",
    "npm": "11.20.0 (bundled with Node 26.12.1)",
    "openclaw": "2026.10.7 (157d8c2)"
  },
  "last_verified": "2026-10-26",
  "status": "manually-verified",
  "status_label": "Manually verified",
  "ci_status": "pending-ci",
  "ci_results_url": null,
  "retest_due": "2026-11-25",
  "published": "2026-10-30",
  "repro_url": "https://stucktoshipped.com/repros/AGT-01/",
  "repro_files_url": "https://stucktoshipped.com/repros/AGT-01/index.json",
  "fix_summary": "Your Node version is older than OpenClaw's supported range. The full fix shows the supported versions, three ways to switch Node safely, the reinstall, and the check that confirms it worked, plus the Windows Companion variant.",
  "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": "4ef3dc3e00f906c2163f270a113a0460a1cda691184ae458edc6f448889b74dc",
    "words": 571,
    "code_blocks": 1,
    "sections": [
      "Fix",
      "How to check it worked",
      "What we actually tested (Oct 26, 2026)"
    ]
  },
  "repro_bundle": {
    "access": "paid",
    "product_id": "repro-bundle",
    "price_usd": 9,
    "files": 6,
    "manifest_url": "https://stucktoshipped.com/repros/AGT-01/index.json"
  },
  "url": "https://stucktoshipped.com/fixes/openclaw/requires-node-24-or-26/",
  "markdown_url": "https://stucktoshipped.com/fixes/openclaw/requires-node-24-or-26/index.md",
  "json_url": "https://stucktoshipped.com/fixes/openclaw/requires-node-24-or-26/index.json",
  "sources": [
    {
      "title": "OpenClaw docs: Node.js runtime (supported versions)",
      "url": "https://docs.openclaw.ai/install/node"
    },
    {
      "title": "OpenClaw docs: Node.js compatibility",
      "url": "https://docs.openclaw.ai/install/node-compatibility"
    },
    {
      "title": "OpenClaw Community forum: Installation Error - Node Version Fix (Windows Companion variant, Oct 25, 2026)",
      "url": "https://community.openclaw.ai/t/installation-error-node-version-fix/223"
    },
    {
      "title": "openclaw-windows-node#1843 (Companion installs Node 24.19.0 in WSL)",
      "url": "https://github.com/openclaw/openclaw-windows-node/issues/1843"
    },
    {
      "title": "GitHub #145658: Setup fails in install-cli step due to unsupported Node version",
      "url": "https://github.com/openclaw/openclaw/issues/145658"
    },
    {
      "title": "GitHub #164396: clean Node 22 LTS install fails to connect",
      "url": "https://github.com/openclaw/openclaw/issues/164396"
    },
    {
      "title": "GitHub PR #81264: installer Node floor aligned with package engine",
      "url": "https://github.com/openclaw/openclaw/pull/81264"
    }
  ],
  "indexable": true,
  "reviewed_by_human": null,
  "content_sha256": "456d118553fba867b0c2727417203febff838c18420d459f3012f66425d3bc1b"
}