{
  "schemaVersion": "1.0",
  "item": {
    "slug": "prometheus",
    "name": "Prometheus",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/Akellacom/prometheus",
    "canonicalUrl": "https://clawhub.ai/Akellacom/prometheus",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/prometheus",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=prometheus",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "package.json",
      "scripts/cli.js",
      "scripts/common.js",
      "scripts/query.js"
    ],
    "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/prometheus"
    },
    "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/prometheus",
    "agentPageUrl": "https://openagent3.xyz/skills/prometheus/agent",
    "manifestUrl": "https://openagent3.xyz/skills/prometheus/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/prometheus/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": "Prometheus Skill",
        "body": "Query Prometheus monitoring data from one or multiple instances. Supports federation across multiple Prometheus servers with a single command."
      },
      {
        "title": "1. Initial Setup",
        "body": "Run the interactive configuration wizard:\n\ncd ~/.openclaw/workspace/skills/prometheus\nnode scripts/cli.js init\n\nThis will create a prometheus.json config file in your OpenClaw workspace (~/.openclaw/workspace/prometheus.json)."
      },
      {
        "title": "2. Start Querying",
        "body": "# Query default instance\nnode scripts/cli.js query 'up'\n\n# Query all instances at once\nnode scripts/cli.js query 'up' --all\n\n# List configured instances\nnode scripts/cli.js instances"
      },
      {
        "title": "Config File Location",
        "body": "By default, the skill looks for config in your OpenClaw workspace:\n\n~/.openclaw/workspace/prometheus.json\n\nPriority order:\n\nPath from PROMETHEUS_CONFIG environment variable\n~/.openclaw/workspace/prometheus.json\n~/.openclaw/workspace/config/prometheus.json\n./prometheus.json (current directory)\n~/.config/prometheus/config.json"
      },
      {
        "title": "Config Format",
        "body": "Create prometheus.json in your workspace (or use node cli.js init):\n\n{\n  \"instances\": [\n    {\n      \"name\": \"production\",\n      \"url\": \"https://prometheus.example.com\",\n      \"user\": \"admin\",\n      \"password\": \"secret\"\n    },\n    {\n      \"name\": \"staging\",\n      \"url\": \"http://prometheus-staging:9090\"\n    }\n  ],\n  \"default\": \"production\"\n}\n\nFields:\n\nname — unique identifier for the instance\nurl — Prometheus server URL\nuser / password — optional HTTP Basic Auth credentials\ndefault — which instance to use when none specified"
      },
      {
        "title": "Environment Variables (Legacy)",
        "body": "For single-instance setups, you can use environment variables:\n\nexport PROMETHEUS_URL=https://prometheus.example.com\nexport PROMETHEUS_USER=admin        # optional\nexport PROMETHEUS_PASSWORD=secret   # optional"
      },
      {
        "title": "Global Flags",
        "body": "FlagDescription-c, --config <path>Path to config file-i, --instance <name>Target specific instance-a, --allQuery all configured instances"
      },
      {
        "title": "Commands",
        "body": "Setup\n\n# Interactive configuration wizard\nnode scripts/cli.js init\n\nQuery Metrics\n\ncd ~/.openclaw/workspace/skills/prometheus\n\n# Query default instance\nnode scripts/cli.js query 'up'\n\n# Query specific instance\nnode scripts/cli.js query 'up' -i staging\n\n# Query ALL instances at once\nnode scripts/cli.js query 'up' --all\n\n# Custom config file\nnode scripts/cli.js query 'up' -c /path/to/config.json\n\nCommon Queries\n\nDisk space usage:\n\nnode scripts/cli.js query '100 - (node_filesystem_avail_bytes / node_filesystem_size_bytes * 100)' --all\n\nCPU usage:\n\nnode scripts/cli.js query '100 - (avg by (instance) (irate(node_cpu_seconds_total{mode=\"idle\"}[5m])) * 100)' --all\n\nMemory usage:\n\nnode scripts/cli.js query '(node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes) / node_memory_MemTotal_bytes * 100' --all\n\nLoad average:\n\nnode scripts/cli.js query 'node_load1' --all"
      },
      {
        "title": "List Configured Instances",
        "body": "node scripts/cli.js instances\n\nOutput:\n\n{\n  \"default\": \"production\",\n  \"instances\": [\n    { \"name\": \"production\", \"url\": \"https://prometheus.example.com\", \"hasAuth\": true },\n    { \"name\": \"staging\", \"url\": \"http://prometheus-staging:9090\", \"hasAuth\": false }\n  ]\n}"
      },
      {
        "title": "Other Commands",
        "body": "# List all metrics matching pattern\nnode scripts/cli.js metrics 'node_memory_*'\n\n# Get label names\nnode scripts/cli.js labels --all\n\n# Get values for a label\nnode scripts/cli.js label-values instance --all\n\n# Find time series\nnode scripts/cli.js series '{__name__=~\"node_cpu_.*\", instance=~\".*:9100\"}' --all\n\n# Get active alerts\nnode scripts/cli.js alerts --all\n\n# Get scrape targets\nnode scripts/cli.js targets --all"
      },
      {
        "title": "Multi-Instance Output Format",
        "body": "When using --all, results include data from all instances:\n\n{\n  \"resultType\": \"vector\",\n  \"results\": [\n    {\n      \"instance\": \"production\",\n      \"status\": \"success\",\n      \"resultType\": \"vector\",\n      \"result\": [...]\n    },\n    {\n      \"instance\": \"staging\",\n      \"status\": \"success\",\n      \"resultType\": \"vector\",\n      \"result\": [...]\n    }\n  ]\n}\n\nErrors on individual instances don't fail the entire query — they appear with \"status\": \"error\" in the results array."
      },
      {
        "title": "Common Queries Reference",
        "body": "MetricPromQL QueryDisk free %node_filesystem_avail_bytes / node_filesystem_size_bytes * 100Disk used %100 - (node_filesystem_avail_bytes / node_filesystem_size_bytes * 100)CPU idle %avg by (instance) (irate(node_cpu_seconds_total{mode=\"idle\"}[5m])) * 100Memory used %(node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes) / node_memory_MemTotal_bytes * 100Network RXrate(node_network_receive_bytes_total[5m])Network TXrate(node_network_transmit_bytes_total[5m])Uptimenode_time_seconds - node_boot_time_secondsService upup"
      },
      {
        "title": "Notes",
        "body": "Time range defaults to last 1 hour for instant queries\nUse range queries [5m] for rate calculations\nAll queries return JSON with data.result containing the results\nInstance labels typically show host:port format\nWhen using --all, queries run in parallel for faster results\nConfig is stored outside the skill directory so it persists across skill updates"
      }
    ],
    "body": "Prometheus Skill\n\nQuery Prometheus monitoring data from one or multiple instances. Supports federation across multiple Prometheus servers with a single command.\n\nQuick Start\n1. Initial Setup\n\nRun the interactive configuration wizard:\n\ncd ~/.openclaw/workspace/skills/prometheus\nnode scripts/cli.js init\n\n\nThis will create a prometheus.json config file in your OpenClaw workspace (~/.openclaw/workspace/prometheus.json).\n\n2. Start Querying\n# Query default instance\nnode scripts/cli.js query 'up'\n\n# Query all instances at once\nnode scripts/cli.js query 'up' --all\n\n# List configured instances\nnode scripts/cli.js instances\n\nConfiguration\nConfig File Location\n\nBy default, the skill looks for config in your OpenClaw workspace:\n\n~/.openclaw/workspace/prometheus.json\n\n\nPriority order:\n\nPath from PROMETHEUS_CONFIG environment variable\n~/.openclaw/workspace/prometheus.json\n~/.openclaw/workspace/config/prometheus.json\n./prometheus.json (current directory)\n~/.config/prometheus/config.json\nConfig Format\n\nCreate prometheus.json in your workspace (or use node cli.js init):\n\n{\n  \"instances\": [\n    {\n      \"name\": \"production\",\n      \"url\": \"https://prometheus.example.com\",\n      \"user\": \"admin\",\n      \"password\": \"secret\"\n    },\n    {\n      \"name\": \"staging\",\n      \"url\": \"http://prometheus-staging:9090\"\n    }\n  ],\n  \"default\": \"production\"\n}\n\n\nFields:\n\nname — unique identifier for the instance\nurl — Prometheus server URL\nuser / password — optional HTTP Basic Auth credentials\ndefault — which instance to use when none specified\nEnvironment Variables (Legacy)\n\nFor single-instance setups, you can use environment variables:\n\nexport PROMETHEUS_URL=https://prometheus.example.com\nexport PROMETHEUS_USER=admin        # optional\nexport PROMETHEUS_PASSWORD=secret   # optional\n\nUsage\nGlobal Flags\nFlag\tDescription\n-c, --config <path>\tPath to config file\n-i, --instance <name>\tTarget specific instance\n-a, --all\tQuery all configured instances\nCommands\nSetup\n# Interactive configuration wizard\nnode scripts/cli.js init\n\nQuery Metrics\ncd ~/.openclaw/workspace/skills/prometheus\n\n# Query default instance\nnode scripts/cli.js query 'up'\n\n# Query specific instance\nnode scripts/cli.js query 'up' -i staging\n\n# Query ALL instances at once\nnode scripts/cli.js query 'up' --all\n\n# Custom config file\nnode scripts/cli.js query 'up' -c /path/to/config.json\n\nCommon Queries\n\nDisk space usage:\n\nnode scripts/cli.js query '100 - (node_filesystem_avail_bytes / node_filesystem_size_bytes * 100)' --all\n\n\nCPU usage:\n\nnode scripts/cli.js query '100 - (avg by (instance) (irate(node_cpu_seconds_total{mode=\"idle\"}[5m])) * 100)' --all\n\n\nMemory usage:\n\nnode scripts/cli.js query '(node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes) / node_memory_MemTotal_bytes * 100' --all\n\n\nLoad average:\n\nnode scripts/cli.js query 'node_load1' --all\n\nList Configured Instances\nnode scripts/cli.js instances\n\n\nOutput:\n\n{\n  \"default\": \"production\",\n  \"instances\": [\n    { \"name\": \"production\", \"url\": \"https://prometheus.example.com\", \"hasAuth\": true },\n    { \"name\": \"staging\", \"url\": \"http://prometheus-staging:9090\", \"hasAuth\": false }\n  ]\n}\n\nOther Commands\n# List all metrics matching pattern\nnode scripts/cli.js metrics 'node_memory_*'\n\n# Get label names\nnode scripts/cli.js labels --all\n\n# Get values for a label\nnode scripts/cli.js label-values instance --all\n\n# Find time series\nnode scripts/cli.js series '{__name__=~\"node_cpu_.*\", instance=~\".*:9100\"}' --all\n\n# Get active alerts\nnode scripts/cli.js alerts --all\n\n# Get scrape targets\nnode scripts/cli.js targets --all\n\nMulti-Instance Output Format\n\nWhen using --all, results include data from all instances:\n\n{\n  \"resultType\": \"vector\",\n  \"results\": [\n    {\n      \"instance\": \"production\",\n      \"status\": \"success\",\n      \"resultType\": \"vector\",\n      \"result\": [...]\n    },\n    {\n      \"instance\": \"staging\",\n      \"status\": \"success\",\n      \"resultType\": \"vector\",\n      \"result\": [...]\n    }\n  ]\n}\n\n\nErrors on individual instances don't fail the entire query — they appear with \"status\": \"error\" in the results array.\n\nCommon Queries Reference\nMetric\tPromQL Query\nDisk free %\tnode_filesystem_avail_bytes / node_filesystem_size_bytes * 100\nDisk used %\t100 - (node_filesystem_avail_bytes / node_filesystem_size_bytes * 100)\nCPU idle %\tavg by (instance) (irate(node_cpu_seconds_total{mode=\"idle\"}[5m])) * 100\nMemory used %\t(node_memory_MemTotal_bytes - node_memory_MemAvailable_bytes) / node_memory_MemTotal_bytes * 100\nNetwork RX\trate(node_network_receive_bytes_total[5m])\nNetwork TX\trate(node_network_transmit_bytes_total[5m])\nUptime\tnode_time_seconds - node_boot_time_seconds\nService up\tup\nNotes\nTime range defaults to last 1 hour for instant queries\nUse range queries [5m] for rate calculations\nAll queries return JSON with data.result containing the results\nInstance labels typically show host:port format\nWhen using --all, queries run in parallel for faster results\nConfig is stored outside the skill directory so it persists across skill updates"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Akellacom/prometheus",
    "publisherUrl": "https://clawhub.ai/Akellacom/prometheus",
    "owner": "Akellacom",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/prometheus",
    "downloadUrl": "https://openagent3.xyz/downloads/prometheus",
    "agentUrl": "https://openagent3.xyz/skills/prometheus/agent",
    "manifestUrl": "https://openagent3.xyz/skills/prometheus/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/prometheus/agent.md"
  }
}