openhab-index

Query a precomputed OpenHAB index for items and semantic model details.

Updated Feb 22, 2026
One-click install
npx skills add https://github.com/Calandrias/openhab-openclaw --skill openhab-index
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openhab-index
Source: https://github.com/Calandrias/openhab-openclaw/tree/main/skills/openhab-index
Command: npx skills add https://github.com/Calandrias/openhab-openclaw --skill openhab-index

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, cat, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides efficient, read-only access to a precomputed index of your OpenHAB items and semantic model, with the ability to perform targeted live REST lookups when current state information is explicitly required.

Core Features & Use Cases

  • Discover Items: Find items by name, label, group, tags, or semantic properties.
  • Navigate Semantic Model: Explore the structure of locations, equipment, and points.
  • Retrieve Item Details: Access item types, labels, metadata (like Alexa or semantic tags), and REST URLs.
  • Get Current State: Perform live REST calls for the most up-to-date item states when necessary.
  • Use Case: Ask "Which lights are in the living room?" or "What is the current temperature from the LivingRoom_Thermostat item?".

Quick Start

Use the openhab-index skill to find all items tagged with 'Light'.

Frequently Asked Questions about openhab-index

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find OpenHAB items by name, label, or semantic tags?

Find OpenHAB items by querying a precomputed index using name, label, group, tags, or semantic properties. This allows efficient discovery of specific items without making broad REST API requests across your entire home automation setup.

Can I get current item states from the OpenHAB REST API?

Get current item states by performing targeted, live REST lookups against your OpenHAB instance. This requires setting the OPENHAB_BASE_URL and OPENHAB_API_TOKEN environment variables to authenticate and retrieve up-to-date information for specific items.

What do I need to query my OpenHAB semantic model offline?

To query the OpenHAB semantic model offline, you need a precomputed index file and the jq and cat binaries installed. These dependencies allow you to parse and read the local index data to discover items and navigate hierarchical relationships.

How do I list all lights in a specific room using OpenHAB?

List all lights in a specific room by querying the precomputed OpenHAB index for items tagged with 'Light' within that location. This leverages the semantic model's location-equipment-point hierarchy to filter items by their spatial and functional tags.

Are there limitations to querying OpenHAB items via a precomputed index?

The primary limitation of using a precomputed index is that item states may be outdated. You must perform explicit live REST calls to retrieve current item states, meaning the index is best suited for discovery and structural navigation rather than real-time monitoring.