Skills 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.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/allmightysauron/solax-cloud-api" ~/.claude/skills/openclaw-skills-solax-summary-fetch && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/allmightysauron/solax-cloud-api" ~/.openclaw/skills/openclaw-skills-solax-summary-fetch && rm -rf "$T"
manifest: skills/allmightysauron/solax-cloud-api/SKILL.md
source content

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.