name: meross description: Control Meross cloud plugs via local CLI commands. Use for discovery, state checks, and switch on/off actions. metadata: { "openclaw": { "requires": { "env": ["MEROSS_EMAIL", "MEROSS_PASSWORD"] }, "primaryEnv": "MEROSS_PASSWORD", }, }

Meross Skill (CLI)

Use local node dist/cli.js only. Do not use plugin APIs. Do not invent device mappings.

Hard Gates

• Require MEROSS_EMAIL and MEROSS_PASSWORD before cloud commands.
• MEROSS_REGION is optional.
• In new/runtime-reset environments, ensure build exists: npm install && npm run build.
• If registry metadata conflicts with runtime behavior, trust runtime behavior.
• Never write credentials to devices.json or other files.

Device Resolution Rules

• Resolve target by exact deviceId first.
• Fallback to alias from devices.json.
• If multiple matches or no match: stop and return ambiguity/missing-target guidance.
• Only switch capability is valid.

Registry Rules

• Registry path: local devices.json in skill root.
• Refresh registry with:

node dist/cli.js setup-once '{}'

• setup-once rewrites device set to normalized entries:
  • deviceId=plug_<normalized_uuid>
  • channel=0
  • capabilities=["switch"]

Command Interface

node dist/cli.js <command> '<json-input>'

Supported commands:

1. list-devices
2. get-state
3. set-device
4. discover-cloud-devices
5. setup-once

Core patterns:

node dist/cli.js list-devices '{}'
node dist/cli.js get-state '{"deviceId":"plug_abc"}'
node dist/cli.js set-device '{"deviceId":"plug_abc","capability":"switch","value":"on"}'
node dist/cli.js set-device '{"deviceId":"plug_abc","capability":"switch","value":"off"}'
node dist/cli.js discover-cloud-devices '{}'
node dist/cli.js setup-once '{}'

Delayed Actions

For delayed switch commands, create one-shot OpenClaw at jobs that execute the same set-device payload at an absolute user-timezone timestamp.

Error Contract

• Success: JSON on stdout
• Failure: JSON on stderr, non-zero exit
• Relevant error codes: DEVICE_NOT_FOUND, DEVICE_OFFLINE, AUTH_FAILED, MEROSS_API_ERROR, INVALID_INPUT, REGISTRY_ERROR, AMBIGUOUS_DEVICE, INTERNAL_ERROR