Назад към всички

solax-summary-fetch

// Fetch inverter summary data from the Solax Cloud API using the npm package solax-cloud-api. Use when the user provides (or has configured) a Solax tokenId and inverter serial number (sn) and wants current/summary energy data returned as JSON (typed as SolaxSummary) for dashboards/automation.

$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namesolax-summary-fetch
descriptionFetch inverter summary data from the Solax Cloud API using the npm package solax-cloud-api. Use when the user provides (or has configured) a Solax tokenId and inverter serial number (sn) and wants current/summary energy data returned as JSON (typed as SolaxSummary) for dashboards/automation.

solax-summary-fetch

Fetch Solax inverter summary data as JSON.

Setup (one-time)

This skill uses Node.js and the npm package solax-cloud-api.

Install dependencies inside the skill folder:

cd /home/openclaw/.openclaw/workspace/skills/solax-summary-fetch/scripts
npm install

(We use npm install instead of npm ci because this skill does not ship with a lockfile.)

Inputs

You need:

  • tokenId (Solax Cloud API token id)
  • sn (inverter serial number)

Recommended: environment variables

Set these in your runtime (preferred so you don’t leak secrets into shell history):

  • SOLAX_TOKENID
  • SOLAX_SN

Do not hardcode credentials into the skill files.

Alternate: CLI arguments

Pass them explicitly as:

  • --tokenId <tokenId>
  • --sn <serial>

Command

cd /home/openclaw/.openclaw/workspace/skills/solax-summary-fetch/scripts
node fetch_summary.mjs --tokenId "$SOLAX_TOKENID" --sn "$SOLAX_SN"

Output

  • Prints a single JSON object to stdout.
  • The JSON conforms to the SolaxSummary interface exposed by solax-cloud-api (see references/solax-summary.d.ts).
  • Under the hood (solax-cloud-api v0.2.0): fetches getAPIData() then converts via SolaxCloudAPI.toSummary().

Guardrails

  • Never print or log the tokenId beyond confirming whether it is set (redact it).
  • If the API call fails, return a structured error JSON with ok:false and a short error message.