{
  "schemaVersion": "1.0",
  "item": {
    "slug": "emporia-energy",
    "name": "Emporia Energy",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/urosorozel/emporia-energy",
    "canonicalUrl": "https://clawhub.ai/urosorozel/emporia-energy",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/emporia-energy",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=emporia-energy",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "assets/example.env",
      "references/README.md",
      "requirements-cloud.txt",
      "requirements-esphome.txt",
      "scripts/common.py"
    ],
    "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-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.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/emporia-energy"
    },
    "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/emporia-energy",
    "agentPageUrl": "https://openagent3.xyz/skills/emporia-energy/agent",
    "manifestUrl": "https://openagent3.xyz/skills/emporia-energy/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/emporia-energy/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": "Emporia Energy Skill",
        "body": "Use the scripts in {baseDir}/scripts to query Emporia Vue data directly.\n\nModes are selected with EMPORIA_MODE:\n\ncloud: Emporia cloud API via PyEmVue (like the Home Assistant integration)\nesphome: Local ESPHome API (for flashed devices)"
      },
      {
        "title": "Choose a mode (cloud vs local)",
        "body": "Use cloud if your Emporia device is still on stock firmware or you want the simplest setup. Requires Emporia account credentials and internet access.\nUse esphome only if the device is flashed with ESPHome and on your LAN. Requires the device IP/hostname and native API access on port 6053.\n\nIf you are unsure whether the device is ESPHome-flashed, choose cloud mode."
      },
      {
        "title": "Cloud mode",
        "body": "EMPORIA_EMAIL\nEMPORIA_PASSWORD\n\nOptional:\n\nEMPORIA_SCALE (MINUTE, SECOND, MINUTES_15, DAY, MONTH) - defaults to MINUTE"
      },
      {
        "title": "ESPHome mode",
        "body": "ESPHOME_HOST\nESPHOME_PORT (optional, default 6053)\nESPHOME_API_KEY (Noise PSK, base64) or ESPHOME_PASSWORD (legacy)"
      },
      {
        "title": "Configuration steps",
        "body": "Cloud:\n\nSet EMPORIA_MODE=cloud.\nSet EMPORIA_EMAIL and EMPORIA_PASSWORD.\n(Optional) Set EMPORIA_SCALE to control power vs energy units.\nRun list first to confirm channels, then summary or circuit <name>.\n\nESPHome:\n\nEnsure the device is flashed with ESPHome and on your LAN.\nSet EMPORIA_MODE=esphome.\nSet ESPHOME_HOST to the device IP/hostname (not Home Assistant).\nIf the ESPHome node uses encryption, set ESPHOME_API_KEY (base64 Noise PSK).\nRun list first to confirm channels, then summary or circuit <name>."
      },
      {
        "title": "Commands",
        "body": "The scripts accept:\n\nsummary (default)\nlist\ncircuit <name>"
      },
      {
        "title": "Usage",
        "body": "Cloud:\n\nexport EMPORIA_MODE=cloud\nexport EMPORIA_EMAIL=\"you@example.com\"\nexport EMPORIA_PASSWORD=\"...\"\npython {baseDir}/scripts/emporia_cloud.py summary\n\nESPHome:\n\nexport EMPORIA_MODE=esphome\nexport ESPHOME_HOST=\"192.168.1.50\"\nexport ESPHOME_API_KEY=\"base64-noise-psk\"\npython {baseDir}/scripts/emporia_esphome.py summary"
      },
      {
        "title": "Dependencies (pip by default)",
        "body": "Cloud:\n\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -r {baseDir}/requirements-cloud.txt\n\nESPHome:\n\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -r {baseDir}/requirements-esphome.txt\n\nOptional: you can use uv instead of pip if preferred."
      },
      {
        "title": "Output",
        "body": "Scripts emit JSON with:\n\ntimestamp\nunit\ntotal (best-effort)\ntop circuits\nchannels used"
      },
      {
        "title": "Safety",
        "body": "Never print secrets (passwords, tokens, keys).\nDo not make hardware or panel wiring recommendations."
      }
    ],
    "body": "Emporia Energy Skill\n\nUse the scripts in {baseDir}/scripts to query Emporia Vue data directly.\n\nModes are selected with EMPORIA_MODE:\n\ncloud: Emporia cloud API via PyEmVue (like the Home Assistant integration)\nesphome: Local ESPHome API (for flashed devices)\nChoose a mode (cloud vs local)\nUse cloud if your Emporia device is still on stock firmware or you want the simplest setup. Requires Emporia account credentials and internet access.\nUse esphome only if the device is flashed with ESPHome and on your LAN. Requires the device IP/hostname and native API access on port 6053.\n\nIf you are unsure whether the device is ESPHome-flashed, choose cloud mode.\n\nEnvironment\nCloud mode\nEMPORIA_EMAIL\nEMPORIA_PASSWORD\n\nOptional:\n\nEMPORIA_SCALE (MINUTE, SECOND, MINUTES_15, DAY, MONTH) - defaults to MINUTE\nESPHome mode\nESPHOME_HOST\nESPHOME_PORT (optional, default 6053)\nESPHOME_API_KEY (Noise PSK, base64) or ESPHOME_PASSWORD (legacy)\nConfiguration steps\n\nCloud:\n\nSet EMPORIA_MODE=cloud.\nSet EMPORIA_EMAIL and EMPORIA_PASSWORD.\n(Optional) Set EMPORIA_SCALE to control power vs energy units.\nRun list first to confirm channels, then summary or circuit <name>.\n\nESPHome:\n\nEnsure the device is flashed with ESPHome and on your LAN.\nSet EMPORIA_MODE=esphome.\nSet ESPHOME_HOST to the device IP/hostname (not Home Assistant).\nIf the ESPHome node uses encryption, set ESPHOME_API_KEY (base64 Noise PSK).\nRun list first to confirm channels, then summary or circuit <name>.\nCommands\n\nThe scripts accept:\n\nsummary (default)\nlist\ncircuit <name>\nUsage\n\nCloud:\n\nexport EMPORIA_MODE=cloud\nexport EMPORIA_EMAIL=\"you@example.com\"\nexport EMPORIA_PASSWORD=\"...\"\npython {baseDir}/scripts/emporia_cloud.py summary\n\n\nESPHome:\n\nexport EMPORIA_MODE=esphome\nexport ESPHOME_HOST=\"192.168.1.50\"\nexport ESPHOME_API_KEY=\"base64-noise-psk\"\npython {baseDir}/scripts/emporia_esphome.py summary\n\nDependencies (pip by default)\n\nCloud:\n\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -r {baseDir}/requirements-cloud.txt\n\n\nESPHome:\n\npython3 -m venv .venv\nsource .venv/bin/activate\npip install -r {baseDir}/requirements-esphome.txt\n\n\nOptional: you can use uv instead of pip if preferred.\n\nOutput\n\nScripts emit JSON with:\n\ntimestamp\nunit\ntotal (best-effort)\ntop circuits\nchannels used\nSafety\nNever print secrets (passwords, tokens, keys).\nDo not make hardware or panel wiring recommendations."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/urosorozel/emporia-energy",
    "publisherUrl": "https://clawhub.ai/urosorozel/emporia-energy",
    "owner": "urosorozel",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/emporia-energy",
    "downloadUrl": "https://openagent3.xyz/downloads/emporia-energy",
    "agentUrl": "https://openagent3.xyz/skills/emporia-energy/agent",
    "manifestUrl": "https://openagent3.xyz/skills/emporia-energy/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/emporia-energy/agent.md"
  }
}