📊 ioBroker Simple-API Skill

Production-ready ioBroker client for OpenClaw automation.

Full access to ioBroker via the simple-api adapter. Read states, objects, historical data, write to states, execute JavaScript, and monitor your smart home. The skill automatically handles caching, rate limiting, and circuit breaker protection. Use this skill to integrate OpenClaw with your ioBroker installation for full smart home control.

---

🚀 Quick Start

Prerequisites

• - ioBroker with simple-api adapter installed
• Adapter running on a port (default 8087)

Minimal Configuration

The skill auto-detects config on first run. Manual config in openclaw.json:

CODEBLOCK0

Test Connection

CODEBLOCK1

Returns connection status, uptime, and state count.

---

⚙️ Configuration

Option	Required	Default	Description
INLINECODE1	Yes	INLINECODE2	ioBroker simple-api base URL
INLINECODE3

Yes | 8087 | ioBroker simple-api port |
| username | No | (empty) | Basic Auth username |
| password | No | (empty) | Basic Auth password |

Auto-Detection

The skill automatically detects the OpenClaw config path:

1. 1. From environment variables (OPENCLAW_HOME, OPENCLAW_STATE_DIR)
2. From its own installation path (skill → workspace → .openclaw)
3. Creates default config on first run if missing

Runtime Config

Change config at runtime:

CODEBLOCK2

---

📖 Read Operations

Get State Value

CODEBLOCK3

With JSON parsing:
CODEBLOCK4

Get State + Object

CODEBLOCK5

Get Multiple States

CODEBLOCK6

List Objects/States

CODEBLOCK7

Search

CODEBLOCK8

Query History

CODEBLOCK9

Supported time formats:

• - -1h, -30m, -7d (relative)
• INLINECODE12 (today at midnight)
• INLINECODE13 (absolute)

CSV Export

CODEBLOCK10

---

📤 Write Operations

Set State

CODEBLOCK11

Toggle

CODEBLOCK12

Set Multiple

CODEBLOCK13

Create/Delete State

CODEBLOCK14

Enable/Disable

CODEBLOCK15

---

💻 Script Execution

Execute JavaScript

CODEBLOCK16

List Scripts

CODEBLOCK17

---

🔌 System Commands

Command	Description
INLINECODE14	Connection status, uptime, state count
INLINECODE15

Cache statistics (hits, misses, size) |
| rate | Rate limit status |
| system | Hosts, memory, CPU info |
| runtime | Uptime, CPU, memory, disk |
| adapters | List installed adapters |
| instances | Adapter instances with status |
| status | Full skill status |

---

🎬 Scenes & Snapshots

Scenes

CODEBLOCK18

Snapshots

CODEBLOCK19

---

📊 Groups & Enums

CODEBLOCK20

---

⚡ Features

Caching

• - 30 second TTL for frequently accessed states
• Automatic cache invalidation on writes

Rate Limiting

• - 10 requests/second to prevent API flooding
• Queue management for burst requests

Circuit Breaker

• - Auto-recovery on failures
• Exponential backoff with jitter

Batch Operations

• - Efficient bulk get/set
• Parallel execution option

Type Coercion

• - Convert between boolean/number/string
• Automatic JSON parsing

Historical Queries

• - Multiple aggregation types (minmax, average, sum, count)
• Configurable time ranges

---

📋 API Reference

Commands Summary

Command	Description
INLINECODE22	Get state value
INLINECODE23

Get state + object | | getBulk:<ids> | Multiple states | | objects:<pattern> | List objects | | states:<pattern> | List states | | search:<pattern> | Search data | | query:<id>?dateFrom=... | Query history | | set:<id>?value=... | Set state | | toggle:<id> | Toggle state | | setBulk:<id1>=<v1>&<id2>=<v2> | Multiple writes | | create:<id>?common=... | Create state | | delete:<id> | Delete state | | exec:<js> | Execute JS | | scene:name={...} | Create scene | | snapshot:name=... | Take snapshot | | groups | List enums | | health | Connection check | | cache | Cache stats | | system | System info | | runtime | Runtime info |

---

📁 Resources

Files

• - skill.js - Main implementation
• INLINECODE43 - Skill loader
• INLINECODE44 - MIT No Attribution

---

🔗 External Links

• - ioBroker
• simple-api Adapter
• ioBroker REST API Docs