{
  "schemaVersion": "1.0",
  "item": {
    "slug": "aave-liquidation-monitor",
    "name": "Aave Liquidation Monitor",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/jgramajo4/aave-liquidation-monitor",
    "canonicalUrl": "https://clawhub.ai/jgramajo4/aave-liquidation-monitor",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/aave-liquidation-monitor",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aave-liquidation-monitor",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "INSTALLATION.md",
      "SECURITY.md",
      "SKILL.md",
      "assets/config-template.json",
      "references/aave-api.md",
      "references/config-guide.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/aave-liquidation-monitor"
    },
    "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/aave-liquidation-monitor",
    "agentPageUrl": "https://openagent3.xyz/skills/aave-liquidation-monitor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/aave-liquidation-monitor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/aave-liquidation-monitor/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": "Quick Start",
        "body": "Configure your wallet and thresholds once, then the skill runs automatically every 6 hours (configurable)."
      },
      {
        "title": "Step 1: Initialize Your Config",
        "body": "Run /aave-config init to set up:\n\nYour Ethereum wallet address (read-only; no private keys required)\nHealth factor thresholds (default: critical 1.05, warning 1.2, stable >1.5)\nCheck interval in hours (default: 6)\nNotification verbosity (verbose = daily summaries even if stable; quiet = only alerts)\nPreferred notification channel (Telegram default, or specify Discord/Slack)\n\nExample:\n\n/aave-config init\n→ Wallet: 0x1234...5678\n→ Thresholds: 1.05 (critical), 1.2 (warning)\n→ Interval: 6 hours\n→ Verbosity: quiet (alerts only)\n→ Channel: telegram"
      },
      {
        "title": "Step 2: Test the Monitor",
        "body": "Run /aave-monitor check to fetch your position immediately and see the alert format:\n\n/aave-monitor check\n→ Fetching position for 0x1234...5678 on Ethereum...\n→ Health Factor: 2.31 (Stable ✓)\n→ Total Collateral: $50,342.12\n→ Total Debt: $21,804.00\n→ Borrowed Assets: USDC (15,000), WETH (0.5), USDT (6,804)\n→ Supplied Assets: WETH (10), USDC (20,000), DAI (30,000)"
      },
      {
        "title": "Step 3: Enable Proactive Monitoring",
        "body": "Run /aave-monitor enable to start automatic checks every 6 hours. The skill registers a cron job that silently runs in the background and alerts you only when health factor drops below threshold.\n\nFor manual override:\n\n/aave-monitor enable --interval 4   # Check every 4 hours\n/aave-monitor disable               # Stop monitoring\n/aave-monitor status                # See current config + last check result"
      },
      {
        "title": "Configuration Reference",
        "body": "See references/config-guide.md for detailed config options, chain support, and threshold guidance.\n\nSee references/aave-api.md for Aave V3 GraphQL schema and query patterns.\n\nSecurity & Credentials: See SECURITY.md for how credentials are handled and threat model.\n\nFor auditors: See SECURITY.md for code review checklist and architecture details."
      },
      {
        "title": "How It Works",
        "body": "Query Phase: Calls Aave V3 GraphQL API with your wallet address\nAnalysis Phase: Extracts health factor, collateral, debt, borrowed/supplied assets\nAlert Logic:\n\nIf HF < 1.05 → CRITICAL (red alert, send immediately)\nIf HF < 1.2 → WARNING (yellow alert, send immediately)\nIf HF > 1.5 → STABLE (no alert, unless verbose mode enables daily summary)\n\n\nNotification Phase: Posts alert to your configured channel with clear summary\nRetry Logic: If API fails, retries up to 3 times with exponential backoff"
      },
      {
        "title": "Error Handling",
        "body": "Invalid wallet address → Logs error, skips check, retries next interval\nAPI timeout → Retries up to 3x with exponential backoff (2s, 4s, 8s)\nMalformed response → Alerts you to API changes, logs full response for debugging\nNetwork errors → Silently retries; alerts only if all retries fail"
      },
      {
        "title": "Security & Credentials",
        "body": "NO private keys are requested or stored — this is read-only monitoring only."
      },
      {
        "title": "How messaging credentials work",
        "body": "The skill uses OpenClaw's built-in message routing — it does NOT store Telegram, Discord, or Slack tokens.\n\nYou configure your messaging channel in OpenClaw (outside this skill)\nThe skill calls OpenClaw's messaging API with just the alert text\nOpenClaw routes the message using your configured channels\n\nExample:\n\n/aave-config set channel telegram\n→ OpenClaw sends alerts via your pre-configured Telegram channel\n\nYou must have a messaging channel already set up in OpenClaw. See OpenClaw docs for setting up Telegram/Discord/Slack integrations."
      },
      {
        "title": "Data handling",
        "body": "Wallet address: Stored in OpenClaw's encrypted config (never sent to external services except Aave's public API)\nAPI responses: Parsed for health factor only; sensitive position data is NOT logged\nCredentials: Managed by OpenClaw, never stored in skill files"
      },
      {
        "title": "What the skill accesses",
        "body": "✅ Aave GraphQL API (public) — reads your position data\n✅ OpenClaw message routing — sends formatted alerts to your configured channel\n✅ Cron scheduler — runs background checks on your interval\n\n❌ Does NOT:\n\nRequest private keys\nStore API tokens\nExecute transactions\nModify your positions"
      },
      {
        "title": "Alert Examples",
        "body": "Critical Alert (HF < 1.05):\n\n🚨 AAVE LIQUIDATION RISK – CRITICAL\nHealth Factor: 1.02 (Liquidation threshold: 1.0)\n⏰ Action required immediately!\n\n📊 Position Summary:\nTotal Collateral: $50,000\nTotal Debt: $48,000\nDebt Ratio: 96%\n\nBorrowed (at risk):\n- USDC: 40,000\n- WETH: 8 ETH (~$31k)\n\nSuggested Actions:\n1. Repay debt (especially WETH)\n2. Supply more collateral\n3. Enable eMode if available (higher LTV on correlated assets)\n\nLast checked: 2026-02-11 08:15 UTC\n\nWarning Alert (HF < 1.2):\n\n⚠️ AAVE WARNING\nHealth Factor: 1.15 (Approaching 1.2 threshold)\n\nPosition approaching liquidation. Consider:\n- Repaying $2,000 USDC or\n- Adding $5,000 collateral (WETH or stETH)\n\nStable Position (HF > 1.5, verbose mode only):\n\n✅ AAVE POSITION HEALTHY\nHealth Factor: 2.31\nTotal Collateral: $50,342.12\nTotal Debt: $21,804.00\n\nAll clear. Check again tomorrow."
      },
      {
        "title": "Command Examples",
        "body": "# One-time position check\n/aave-monitor check\n\n# Start automatic monitoring\n/aave-monitor enable\n\n# Change thresholds (e.g., earlier warning at HF 1.3)\n/aave-config set thresholds 1.05 1.3\n\n# Check monitoring status\n/aave-monitor status\n\n# View last 5 check results with alerts\n/aave-monitor history 5\n\n# Disable monitoring temporarily\n/aave-monitor disable"
      },
      {
        "title": "Chains Supported",
        "body": "Primary: Ethereum mainnet\n\nAlso works (with same config address where applicable):\n\nPolygon\nArbitrum\nOptimism\nBase\nAvalanche\nGnosis\n\nEdit scripts/monitor.js to add chains or customize per-chain endpoints."
      },
      {
        "title": "Customization",
        "body": "Change check interval:\n\n/aave-config set interval 4  # Check every 4 hours\n\nChange alert thresholds:\n\n/aave-config set thresholds 1.1 1.25  # Critical at 1.1, warning at 1.25\n\nEnable verbose mode (daily summaries even if stable):\n\n/aave-config set verbosity verbose\n\nSwitch notification channel:\n\n/aave-config set channel discord"
      },
      {
        "title": "Implementation Details",
        "body": "See scripts/monitor.js for the core monitoring logic (GraphQL queries, health factor calculation, alert formatting).\n\nSee scripts/cron-runner.js for cron job integration with OpenClaw's cron scheduler."
      },
      {
        "title": "Troubleshooting",
        "body": "\"Invalid wallet address\"\n→ Check format: must be 0x... format. Try /aave-config view to see current config.\n\n\"Health factor not returned by API\"\n→ Wallet may not have Aave position. Try /aave-monitor check for immediate response.\n\n\"API endpoint unreachable\"\n→ Aave API may be down. Skill retries automatically. Check https://status.aave.com.\n\n\"No notifications sent\"\n→ Check that your notification channel is active. Run /aave-monitor check to test delivery."
      },
      {
        "title": "Notes",
        "body": "Health factor = Total Collateral / Total Debt (net of liquidation threshold ratios)\nLiquidation occurs when HF ≤ 1.0\nVariable debt accrues interest; stable debt is fixed-rate\neMode allows higher LTV for correlated assets (e.g., stablecoins, ETH-LSTs)\nSupplied assets are collateral; they earn interest but can be seized if you're liquidated\n\nLast Updated: 2026-02-11 | Status: Ready for configuration"
      }
    ],
    "body": "Aave Liquidation Monitor\nQuick Start\n\nConfigure your wallet and thresholds once, then the skill runs automatically every 6 hours (configurable).\n\nStep 1: Initialize Your Config\n\nRun /aave-config init to set up:\n\nYour Ethereum wallet address (read-only; no private keys required)\nHealth factor thresholds (default: critical 1.05, warning 1.2, stable >1.5)\nCheck interval in hours (default: 6)\nNotification verbosity (verbose = daily summaries even if stable; quiet = only alerts)\nPreferred notification channel (Telegram default, or specify Discord/Slack)\n\nExample:\n\n/aave-config init\n→ Wallet: 0x1234...5678\n→ Thresholds: 1.05 (critical), 1.2 (warning)\n→ Interval: 6 hours\n→ Verbosity: quiet (alerts only)\n→ Channel: telegram\n\nStep 2: Test the Monitor\n\nRun /aave-monitor check to fetch your position immediately and see the alert format:\n\n/aave-monitor check\n→ Fetching position for 0x1234...5678 on Ethereum...\n→ Health Factor: 2.31 (Stable ✓)\n→ Total Collateral: $50,342.12\n→ Total Debt: $21,804.00\n→ Borrowed Assets: USDC (15,000), WETH (0.5), USDT (6,804)\n→ Supplied Assets: WETH (10), USDC (20,000), DAI (30,000)\n\nStep 3: Enable Proactive Monitoring\n\nRun /aave-monitor enable to start automatic checks every 6 hours. The skill registers a cron job that silently runs in the background and alerts you only when health factor drops below threshold.\n\nFor manual override:\n\n/aave-monitor enable --interval 4   # Check every 4 hours\n/aave-monitor disable               # Stop monitoring\n/aave-monitor status                # See current config + last check result\n\nConfiguration Reference\n\nSee references/config-guide.md for detailed config options, chain support, and threshold guidance.\n\nSee references/aave-api.md for Aave V3 GraphQL schema and query patterns.\n\nSecurity & Credentials: See SECURITY.md for how credentials are handled and threat model.\n\nFor auditors: See SECURITY.md for code review checklist and architecture details.\n\nHow It Works\nQuery Phase: Calls Aave V3 GraphQL API with your wallet address\nAnalysis Phase: Extracts health factor, collateral, debt, borrowed/supplied assets\nAlert Logic:\nIf HF < 1.05 → CRITICAL (red alert, send immediately)\nIf HF < 1.2 → WARNING (yellow alert, send immediately)\nIf HF > 1.5 → STABLE (no alert, unless verbose mode enables daily summary)\nNotification Phase: Posts alert to your configured channel with clear summary\nRetry Logic: If API fails, retries up to 3 times with exponential backoff\nError Handling\nInvalid wallet address → Logs error, skips check, retries next interval\nAPI timeout → Retries up to 3x with exponential backoff (2s, 4s, 8s)\nMalformed response → Alerts you to API changes, logs full response for debugging\nNetwork errors → Silently retries; alerts only if all retries fail\nSecurity & Credentials\n\nNO private keys are requested or stored — this is read-only monitoring only.\n\nHow messaging credentials work\n\nThe skill uses OpenClaw's built-in message routing — it does NOT store Telegram, Discord, or Slack tokens.\n\nYou configure your messaging channel in OpenClaw (outside this skill)\nThe skill calls OpenClaw's messaging API with just the alert text\nOpenClaw routes the message using your configured channels\n\nExample:\n\n/aave-config set channel telegram\n→ OpenClaw sends alerts via your pre-configured Telegram channel\n\n\nYou must have a messaging channel already set up in OpenClaw. See OpenClaw docs for setting up Telegram/Discord/Slack integrations.\n\nData handling\nWallet address: Stored in OpenClaw's encrypted config (never sent to external services except Aave's public API)\nAPI responses: Parsed for health factor only; sensitive position data is NOT logged\nCredentials: Managed by OpenClaw, never stored in skill files\nWhat the skill accesses\n\n✅ Aave GraphQL API (public) — reads your position data\n✅ OpenClaw message routing — sends formatted alerts to your configured channel\n✅ Cron scheduler — runs background checks on your interval\n\n❌ Does NOT:\n\nRequest private keys\nStore API tokens\nExecute transactions\nModify your positions\nExamples\nAlert Examples\n\nCritical Alert (HF < 1.05):\n\n🚨 AAVE LIQUIDATION RISK – CRITICAL\nHealth Factor: 1.02 (Liquidation threshold: 1.0)\n⏰ Action required immediately!\n\n📊 Position Summary:\nTotal Collateral: $50,000\nTotal Debt: $48,000\nDebt Ratio: 96%\n\nBorrowed (at risk):\n- USDC: 40,000\n- WETH: 8 ETH (~$31k)\n\nSuggested Actions:\n1. Repay debt (especially WETH)\n2. Supply more collateral\n3. Enable eMode if available (higher LTV on correlated assets)\n\nLast checked: 2026-02-11 08:15 UTC\n\n\nWarning Alert (HF < 1.2):\n\n⚠️ AAVE WARNING\nHealth Factor: 1.15 (Approaching 1.2 threshold)\n\nPosition approaching liquidation. Consider:\n- Repaying $2,000 USDC or\n- Adding $5,000 collateral (WETH or stETH)\n\n\nStable Position (HF > 1.5, verbose mode only):\n\n✅ AAVE POSITION HEALTHY\nHealth Factor: 2.31\nTotal Collateral: $50,342.12\nTotal Debt: $21,804.00\n\nAll clear. Check again tomorrow.\n\nCommand Examples\n# One-time position check\n/aave-monitor check\n\n# Start automatic monitoring\n/aave-monitor enable\n\n# Change thresholds (e.g., earlier warning at HF 1.3)\n/aave-config set thresholds 1.05 1.3\n\n# Check monitoring status\n/aave-monitor status\n\n# View last 5 check results with alerts\n/aave-monitor history 5\n\n# Disable monitoring temporarily\n/aave-monitor disable\n\nChains Supported\n\nPrimary: Ethereum mainnet\n\nAlso works (with same config address where applicable):\n\nPolygon\nArbitrum\nOptimism\nBase\nAvalanche\nGnosis\n\nEdit scripts/monitor.js to add chains or customize per-chain endpoints.\n\nCustomization\n\nChange check interval:\n\n/aave-config set interval 4  # Check every 4 hours\n\n\nChange alert thresholds:\n\n/aave-config set thresholds 1.1 1.25  # Critical at 1.1, warning at 1.25\n\n\nEnable verbose mode (daily summaries even if stable):\n\n/aave-config set verbosity verbose\n\n\nSwitch notification channel:\n\n/aave-config set channel discord\n\nImplementation Details\n\nSee scripts/monitor.js for the core monitoring logic (GraphQL queries, health factor calculation, alert formatting).\n\nSee scripts/cron-runner.js for cron job integration with OpenClaw's cron scheduler.\n\nTroubleshooting\n\n\"Invalid wallet address\" → Check format: must be 0x... format. Try /aave-config view to see current config.\n\n\"Health factor not returned by API\" → Wallet may not have Aave position. Try /aave-monitor check for immediate response.\n\n\"API endpoint unreachable\" → Aave API may be down. Skill retries automatically. Check https://status.aave.com.\n\n\"No notifications sent\" → Check that your notification channel is active. Run /aave-monitor check to test delivery.\n\nNotes\nHealth factor = Total Collateral / Total Debt (net of liquidation threshold ratios)\nLiquidation occurs when HF ≤ 1.0\nVariable debt accrues interest; stable debt is fixed-rate\neMode allows higher LTV for correlated assets (e.g., stablecoins, ETH-LSTs)\nSupplied assets are collateral; they earn interest but can be seized if you're liquidated\n\nLast Updated: 2026-02-11 | Status: Ready for configuration"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/jgramajo4/aave-liquidation-monitor",
    "publisherUrl": "https://clawhub.ai/jgramajo4/aave-liquidation-monitor",
    "owner": "jgramajo4",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/aave-liquidation-monitor",
    "downloadUrl": "https://openagent3.xyz/downloads/aave-liquidation-monitor",
    "agentUrl": "https://openagent3.xyz/skills/aave-liquidation-monitor/agent",
    "manifestUrl": "https://openagent3.xyz/skills/aave-liquidation-monitor/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/aave-liquidation-monitor/agent.md"
  }
}